Importar contatos via CSV

Guia completo passo a passo para importar pessoas/contatos para o Vecta Desk.

Visão geral

Este guia explica como importar os seus contatos (Pessoas) para o Vecta Desk.

Importe Empresas primeiro se quiser associar Pessoas a Empresas.

Antes de começar

Lista de verificação de pré-requisitos

• O seu arquivo está no formato CSV, XLSX ou XLS
• O arquivo tem menos de 10.000 registros
• Sem endereços de e-mail duplicados no seu arquivo
• Empresas importadas primeiro (se estiver a associar Pessoas a Empresas)
• Todos os campos personalizados existem em Configurações → Modelo de dados

Importe Empresas antes de Pessoas. Se quiser associar Pessoas a Empresas, importe primeiro as Empresas. A Empresa deve existir antes de você poder referenciá-la.

Passo 1: Prepare os seus dados de contatos

Campos obrigatórios e recomendados

Formato de e-mail

• Deve estar num formato de e-mail válido: nome@dominio.com
• Deve ser único — sem duplicados no seu arquivo ou no Vecta Desk
• Para e-mails adicionais, utilize a coluna Emails / Additional Emails:

["maria@empresa.com","maria.silva@empresa.com"]

Formato de telefone

Telefone é um campo aninhado que requer várias colunas:

Associando a Empresas

Adicione uma coluna com o identificador único da Empresa:

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 Vecta Desk.

Exemplo de estrutura de CSV

firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
João,Silva,joao@acme.com,CEO,https://acme.com,11990000000,BR
Maria,Souza,maria@widgets.co,CTO,https://widgets.co,21990001234,BR

Dica: clique em Baixar arquivo de exemplo durante a importação ou exporte algumas Pessoas existentes para ver os nomes de colunas exatos que o Vecta Desk espera.

Passo 2: Acesse a funcionalidade de importação

Opção 1: a partir da visualização Pessoas

1. Navegue até Pessoas na barra lateral esquerda
2. Clique no ícone ⋮ no canto superior direito
3. Selecione Importar registros

Opção 2: utilizando o Menu de Comandos

1. Pressione Cmd + K (Mac) ou Ctrl + K (Windows)
2. Escreva “importar”
3. Selecione Importar registros
4. Escolha Pessoas

Passo 3: Carregue o seu arquivo

1. Clique em Selecionar arquivo
2. Escolha o seu arquivo CSV, XLSX ou XLS
3. Aguarde que o Vecta Desk analise o seu arquivo

Passo 4: Mapeie as suas colunas

O Vecta Desk 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 Não mapear para as colunas que não quer importar

Regras importantes de mapeamento

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 Vecta Desk 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.

Passo 5: Mapear valores de campos de seleção

Se você tiver campos de Seleção ou Seleção múltipla (como Origem do lead):

1. O Vecta Desk exibe seus valores ao lado das opções existentes
2. Relacione cada valor no seu arquivo a uma opção do Vecta Desk
3. Ou crie novas opções, se necessário

As opções de seleção 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.

Passo 6: Revisar e corrigir erros

Antes de concluir a importação, o Vecta Desk 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

Passo 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 Vecta Desk. 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 Vecta Desk 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

Por que duas Pessoas não podem ter o mesmo e-mail?

O e-mail é um identificador único no Vecta Desk. Isso evita contatos duplicados e garante que a sincronização de e-mail vincule corretamente os e-mails à pessoa certa.

E se eu tiver pessoas sem e-mail?

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.

Como vinculo Pessoas a Empresas durante a importação?

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.

E se a Empresa ainda não existir?

Importe as Empresas primeiro e, depois, as Pessoas. A Empresa deve existir antes que você possa referenciá-la.

Posso importar o ID do meu CRM anterior?

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 Vecta Desk.

Como corrijo erros de “relação não encontrada”?

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:

• Como corrigir erros de importação
• Como importar relações
• Mapeamento de campos