Saltar para o conteúdo principal

​
Visão Geral

Este guia explica como importar os seus contactos (People) para o Twenty. Importe Empresas primeiro se quiser associar Pessoas a Empresas.

​
Antes de Começar

​
Lista de Verificação de Pré-requisitos

O seu ficheiro está no formato CSV, XLSX ou XLS
O ficheiro tem menos de 10 000 registos
Sem endereços de e-mail duplicados no seu ficheiro
Empresas importadas primeiro (se estiver a associar Pessoas a Empresas)
Todos os campos personalizados existem em Settings → Data Model
Importe Empresas Antes de PessoasSe quiser associar Pessoas a Empresas, importe primeiro as Empresas. A Empresa deve existir antes de poder referenciá-la.

​
Passo 1: Prepare os seus dados de contactos

​
Campos Obrigatórios e Recomendados

CampoObrigatório?FormatoNotas
EmailRecomendadoname@domain.comDeve ser único
NomeRecomendadoTexto
ApelidoRecomendadoTexto
EmpresaOpcionalDomínio ou IDLiga à Empresa existente
TelefoneOpcionalVárias colunasVeja abaixo
CargoOpcionalTexto
Campos personalizadosOpcionalVariaDeve existir no Data Model

​
Formato de E-mail

  • Deve estar num formato de e-mail válido: name@domain.com
  • Deve ser único — sem duplicados no seu ficheiro ou no Twenty
  • Para e-mails adicionais, utilize a coluna Emails / Additional Emails:
["jane@twenty.com","jane.doe@twenty.com"]

​
Formato de Telefone

Telefone é um campo aninhado que requer várias colunas:
ColunaExemplo
Phones / Primary Phone Number4159095555
Phones / Primary Phone Country CodeUS
Phones / Primary Phone Calling Code+1

​
A associar a Empresas

Adicione uma coluna com o identificador único da Empresa:
Nome da ColunaFormatoExemplo
companyDomainFormato de URLhttps://acme.com
companyIdUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
Use o formato de URL de domínio (https://acme.com), não o rótulo. Isto corresponde à forma como as Empresas são armazenadas no Twenty.

​
Exemplo de estrutura de CSV

firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
Dica profissional: Clique em Download sample file durante a importação ou exporte algumas Pessoas existentes para ver os nomes de colunas exatos que o Twenty espera.

​
Passo 2: Aceda à funcionalidade de importação

Opção 1: A partir da vista Pessoas
  1. Navegue até Pessoas na barra lateral esquerda
  2. Clique no ícone ⋮ no canto superior direito
  3. Selecione Import records
Opção 2: Utilizando o Menu de Comando
  1. Prima Cmd + K (Mac) ou Ctrl + K (Windows)
  2. Escreva “import”
  3. Selecione Import records
  4. Escolha Pessoas

​
Passo 3: Carregue o seu ficheiro

  1. Clique em Select file
  2. Escolha o seu ficheiro CSV, XLSX ou XLS
  3. Aguarde que o Twenty analise o seu ficheiro

​
Passo 4: Mapeie as suas colunas

O Twenty tenta automaticamente corresponder as suas colunas aos campos. Revise e ajuste:
  1. Verifique os mapeamentos automáticos — confirme que estão corretos
  2. Corrija mapeamentos incorretos — clique no menu suspenso para selecionar o campo correto
  3. Ignorar colunas — selecione Do not map para as colunas que não quer importar

​
Regras Importantes de Mapeamento

Tipo de ColunaMapear ParaNotas
Referência de Empresacampo de relação EmpresaUse domínio OU ID, não ambos
E-mailEmailEndereço de e-mail principal
E-mails adicionaisEmails / Additional EmailsFormato de array
TelefoneColunas separadasNúmero, Código do País, Código de Chamada

​
Mapeamento da Relação com a Empresa

Ao mapear a coluna de empresa:
  1. Encontre a sua coluna de referência de empresa (por exemplo, companyDomain)
  2. Mapeie-a para o campo de relação Empresa
  3. O Twenty irá associar cada Pessoa à Empresa correspondente
Mapeie apenas UM identificador único para relações.Não mapeie ambos companyId E companyDomain. Escolha um — de preferência o domínio, pois é legível para humanos.

​
Etapa 5: Mapear valores de campos Select

Se você tiver campos Select ou Multi-Select (como Origem do lead):
  1. O Twenty exibe seus valores ao lado das opções existentes
  2. Relacione cada valor no seu arquivo a uma opção do Twenty
  3. Ou crie novas opções, se necessário
As opções de Select usam nomes de API, não os rótulos de exibição. Em Configurações → Modelo de dados → Ative o Modo avançado para ver os nomes de API.

​
Etapa 6: Revisar e corrigir erros

Antes de concluir a importação, o Twenty valida seus dados:
  1. Clique em Próximos Passos
  2. As linhas com erros são destacadas em amarelo
  3. Corrija os erros diretamente — clique em uma célula e edite o valor
  4. Remova as linhas problemáticas — clique no X para ignorar essa linha

​
Erros comuns na importação de contatos

ErroCausaSolução
E-mail duplicadoO e-mail já existe no Twenty ou no arquivoRemova o duplicado ou atualize o registro existente
Formato de e-mail inválidoFormato de e-mail incorretoCorrija para name@domain.com
Relação não encontradaA empresa não existeImporte as Empresas primeiro ou corrija a referência
Campo obrigatório ausenteO campo obrigatório está vazioPreencha o valor ou remova a linha

​
Etapa 7: Concluir a importação

  1. Revise o resumo da importação
  2. Clique em Confirmar para importar
  3. Aguarde a conclusão da importação
  4. Verifique conferindo alguns registros e seus vínculos com a Empresa

​
Após importar contatos

Seus contatos agora estão no Twenty! Próximos passos:
  1. Verifique os vínculos com a Empresa — abra alguns registros de Pessoas para confirmar que estão vinculados à Empresa correta
  2. Importe Oportunidades — se necessário, vincule-as a Pessoas e Empresas
  3. Configure a sincronização de e-mail — conecte sua caixa de correio para ver o histórico de e-mails nos registros de contato

​
Atualizando contatos existentes

Para atualizar contatos em vez de criar novos:
  1. Inclua a coluna email ou id no seu arquivo
  2. O Twenty faz a correspondência dos registros por esse identificador único
  3. Os contatos existentes são atualizados; os novos são criados
Veja Como Atualizar Registros Existentes para obter detalhes.

​
Perguntas frequentes

O e-mail é um identificador único no Twenty. Isso evita contatos duplicados e garante que a sincronização de e-mail vincule corretamente os e-mails à pessoa certa.
Você pode deixar o e-mail em branco. No entanto, recomendamos adicionar e-mails quando possível para melhorar a qualidade dos dados e a funcionalidade de sincronização de e-mail.
Adicione uma coluna com o domínio da Empresa (por exemplo, https://acme.com) ou o ID. Durante o mapeamento, conecte essa coluna ao campo de relação da Empresa.
Importe as Empresas primeiro e, depois, as Pessoas. A Empresa deve existir antes que você possa referenciá-la.
Sim! Crie um campo personalizado marcado como “único” no seu modelo de dados para armazenar o ID externo. Observação: o nome do campo id é reservado para o ID interno do Twenty.
A Empresa que você está referenciando não existe. Importe a Empresa primeiro ou verifique se o domínio/ID corresponde exatamente a uma Empresa existente.

​
Resolução de Problemas

Com problemas? Confira: