Importar empresas via CSV

Guia completo passo a passo para importar empresas para o Vecta Desk.

Visão geral

Este guia explica como importar as suas empresas para o Vecta Desk.

As empresas devem ser importadas primeiro porque Pessoas e Oportunidades se ligam 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 domínios duplicados no seu arquivo
• Todos os campos personalizados existem em Configurações → Modelo de dados

Precisa de importar mais de 10.000 empresas? Divida em vários arquivos ou use a importação via API.

Passo 1: Prepare os seus dados de empresas

Campos obrigatórios e recomendados

Formato de domínio

Use o formato https://dominio.com para domínios. Isto corresponde ao formato utilizado quando as Empresas são criadas automaticamente a partir da sincronização de e-mail/calendário, evitando duplicados posteriormente.

Colunas de domínio:

• Domain / Domain Label: acme.com
• Domain / Domain URL: https://acme.com

Formato de endereço

Endereço é um campo aninhado com várias colunas:

Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
Rua das Flores 123,São Paulo,SP,Brasil,01000-000

Exemplo de estrutura de CSV

name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
Acme Corp,https://acme.com,acme.com,São Paulo,Brasil,250
Widget Co,https://widgets.co,widgets.co,Rio de Janeiro,Brasil,50

Dica: clique em Baixar arquivo de exemplo durante a importação 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 Empresas

1. Navegue até Empresas 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 Empresas

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

• Domínio: faça o mapeamento para Domain / Domain URL (não para Domain Label)
• Endereço: mapeie cada parte para a respetiva coluna (Cidade, Estado, etc.)
• Campos de seleção: os valores devem corresponder às opções existentes (ou você irá mapeá-los no passo seguinte)

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

Se tiver campos de Seleção ou Seleção múltipla:

1. O Vecta Desk mostra os 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 apresentaçã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 os seus dados:

1. Clique em Próximos passos
2. As linhas com erros são destacadas em amarelo
3. Corrija os erros diretamente — clique numa 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 empresas

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 consultando alguns registros

Após importar empresas

Agora você pode importar registros que se ligam a Empresas:

1. Importar Pessoas — ligue-as a Empresas utilizando o domínio
2. Importar Oportunidades — ligue-as a Empresas
3. Verifique a importação — faça uma verificação pontual de alguns registros para garantir que os dados estão corretos

Atualizar empresas existentes

Para atualizar empresas em vez de criar novas:

1. Inclua a coluna domain ou id no seu arquivo
2. O Vecta Desk faz a correspondência dos registros por este identificador único
3. As empresas existentes são atualizadas; as novas são criadas

Veja Como atualizar registros existentes para obter detalhes.

Perguntas frequentes

Por que duas Empresas não podem ter o mesmo domínio?

O domínio é um identificador único no Vecta Desk. Isto evita empresas duplicadas e garante que a sincronização de e-mail associe corretamente os e-mails à empresa certa.

E se tiver empresas sem domínio?

Você pode deixar o domínio em branco. No entanto, recomendamos adicionar domínios quando possível para melhorar a qualidade dos dados e a ligação automática de e-mails.

Posso importar empresas sem quaisquer Pessoas associadas?

Sim. Você pode importar as empresas primeiro, depois importar as Pessoas e associá-las usando o domínio da empresa.

O que acontece se importar um domínio que já existe?

Se incluir um identificador único (domínio ou id) que corresponda a uma empresa existente, o Vecta Desk atualiza essa empresa em vez de criar um duplicado.

Como corrijo erros de “domínio duplicado”?

Remova o duplicado do seu arquivo ou inclua o id da empresa para, em vez disso, atualizar o registro existente.

Resolução de problemas

Está com problemas? Consulte:

• Como corrigir erros de importação
• Mapeamento de campos
• Restrições de unicidade