Prepare seus arquivos CSV

Guia completo passo a passo para formatar seus dados para importação no Vecta Desk.

Visão geral

Este guia orienta você na preparação do seu arquivo CSV para uma importação bem-sucedida. Siga estas etapas para evitar erros.

Etapa 1: Verifique os requisitos do arquivo

Antes de começar, verifique se o seu arquivo atende a estes requisitos:

Requisito	Detalhes
Formato	CSV, XLSX ou XLS
Limite de tamanho	10.000 registros por arquivo
Codificação	UTF-8 recomendado
Estrutura	Um tipo de objeto por arquivo

Para conjuntos de dados maiores que 10.000 registros, divida em vários arquivos ou use a importação via API.

Etapa 2: Baixe o arquivo de exemplo

Esta é a etapa mais importante. O arquivo de exemplo mostra os nomes exatos das colunas e o formato que o Vecta Desk espera.

Navegue até qualquer objeto (Pessoas, Empresas, etc.)
Clique em ⋮ → Importar registros
Clique em Baixar arquivo de exemplo
Use este arquivo como seu modelo

Dica: em vez disso, exporte alguns registros existentes. Isso fornece exemplos reais de como os dados devem ser formatados, e os nomes das colunas serão mapeados automaticamente durante a importação.

Etapa 3: Remova valores duplicados

O Vecta Desk impõe unicidade em determinados campos. Duplicados causarão erros de importação.

Objeto	Campos exclusivos
Pessoas	`id`, `email`
Empresas	`id`, `domain`
Objetos personalizados	`id`, além de qualquer campo que você tenha marcado como exclusivo

Antes de importar:

Ordene sua planilha pelo campo exclusivo (e-mail ou domínio)
Remova ou mescle linhas duplicadas
Verifique se há duplicados que já existem no Vecta Desk

Registros excluídos logicamente contam para a unicidade. Registros em Menu de Comandos → Ver registros excluídos causarão erros de duplicação. Exclua-os permanentemente ou restaure e atualize-os.

Etapa 4: Formate corretamente cada tipo de campo

Tipos de campo diferentes exigem formatos específicos. Aqui está a referência completa.

Campos de texto

Nenhuma formatação especial é necessária
Espaços no início/fim são automaticamente removidos

Campos de e-mail

Deve estar em um formato de e-mail válido: nome@dominio.com
Deve ser exclusivo (sem duplicados no arquivo ou no Vecta Desk)
Para e-mails adicionais, use este formato na coluna Emails / Additional Emails:

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

Campos de domínio

Formato recomendado: https://dominio.com
Isso corresponde ao formato usado pela sincronização de caixa de correio/calendário (evita duplicados)
Preencha ambas as colunas:
- Domain / Domain Label: dominio.com
- Domain / Domain URL: https://dominio.com
Deve ser exclusivo dentro do seu arquivo e no Vecta Desk

Campos de telefone

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

Coluna	Exemplo
Phones / Primary Phone Number	`11990000000`
Phones / Primary Phone Country Code	`BR`
Phones / Primary Phone Calling Code	`+55`

Campos de endereço

Endereço é um campo aninhado com várias colunas (algumas podem ficar em branco):

Endereço / Endereço 1: Linha 1 do endereço
Endereço / Endereço 2: Linha 2 do endereço (opcional)
Endereço / Cidade: Nome da cidade
Endereço / Estado: Estado ou província
Endereço / País: Nome do país
Endereço / Código Postal: Código Postal/CEP

Campos de data

Use formatação consistente em todo o seu arquivo:

YYYY-MM-DD (recomendado): 2024-03-15
ISO 8601: 2024-03-15T10:30:00Z

Campos numéricos

Apenas números (sem texto)
Use ponto para decimais: 1234.56
Sem separadores de milhares (não 1.234,56)

Campos de moeda

Moeda é um campo aninhado que requer duas colunas que ambas devem ser preenchidas:

Coluna	Exemplo
Valor / Valor	`1234.56`
Valor / Moeda	`BRL`

Campos booleanos

Use maiúsculas: TRUE ou FALSE. true ou false em minúsculas não funcionam.

Campos de seleção

Use o nome da API da opção, não o rótulo de exibição.

Como encontrar nomes da API:

Vá para Configurações → Modelo de dados
Selecione o objeto e o campo
Ative o Modo avançado (alternador no canto inferior direito)
Copie o nome da API (por exemplo, OPTION_1, não “Option 1”)

Novas opções de seleção não são criadas automaticamente. Adicione-as em Configurações → Modelo de dados antes de importar.

Campos de seleção múltipla

Use os nomes da API no formato de array:

["VALUE1","VALUE2"]

Campos de array

Use o formato de array JSON:

["valor1","valor2"]

Campos de classificação

Use o formato: RATING_1, RATING_2, RATING_3, RATING_4 ou RATING_5.

Campos de links/URL

Preencha ambas as colunas:

Links / Rótulo do Link: Site da empresa
Links / URL do Link: https://exemplo.com

Para links secundários, use a coluna Links / Links Secundários:

[{"url":"https://exemplo.com","label":"Exemplo"}]

Campos JSON

Use um formato JSON válido:

{"chave":"valor","chave2":"valor2"}

Campos de ID

Opcional: o Vecta Desk gera IDs automaticamente se não forem fornecidos
Formato: UUID (por exemplo, c776ee49-f608-4a77-8cc8-6fe96ae1e43f)
Caso de uso: inclua o ID para atualizar registros existentes em vez de criar novos

Etapa 5: Adicione colunas de relação (se estiver vinculando registros)

Para vincular registros a outros objetos (por exemplo, Pessoas a Empresas), adicione uma coluna com o identificador exclusivo do registro relacionado.

Exemplo: vinculando Pessoas a Empresas. Adicione uma coluna ao seu CSV de Pessoas:

firstName,lastName,email,companyDomain
João,Silva,joao@acme.com,https://acme.com
Maria,Souza,maria@widgets.co,https://widgets.co

Regras importantes para relações:

O registro pai já deve existir no Vecta Desk
Use o formato URL de domínio (https://dominio.com), não o rótulo
Mapeie apenas UM identificador exclusivo (não inclua companyId E companyDomain)
Para Membros do espaço de trabalho, use o e-mail deles (não o nome)

A ordem de importação é importante. Importe o lado “um” antes do lado “muitos”:

Empresas primeiro
Pessoas em segundo (com referência à empresa)
Oportunidades em terceiro

O registro pai deve existir antes de você poder referenciá-lo.

Veja Como importar relações para instruções detalhadas.

Etapa 6: Garanta que os campos existam no Vecta Desk

A importação cria registros, não campos. Todos os campos que você deseja importar já devem existir no seu modelo de dados.

Antes de importar:

Vá para Configurações → Modelo de dados
Selecione o seu objeto
Crie todos os campos personalizados necessários
Anote os nomes exatos dos campos (eles devem corresponder aos cabeçalhos das suas colunas)

Etapa 7: Lista de verificação final

Antes de enviar seu arquivo, verifique:

O arquivo está no formato CSV, XLSX ou XLS
O arquivo tem menos de 10.000 registros
A codificação é UTF-8
Sem e-mails duplicados (para Pessoas) ou domínios (para Empresas)
As datas usam formato consistente em todo o arquivo
Os domínios usam o formato https://dominio.com
Os campos booleanos usam TRUE ou FALSE (maiúsculas)
Os campos de seleção usam nomes da API, não rótulos de exibição
Todos os campos personalizados existem em Configurações → Modelo de dados
Registros pai importados antes dos registros filho
As colunas de relação referenciam registros existentes

Erros comuns a evitar

Erro	Solução
Usar `true` em vez de `TRUE`	Valores booleanos devem estar em maiúsculas
Usar rótulos de exibição para campos de seleção	Encontre e use os nomes da API em Configurações
Importar Pessoas antes de Empresas	Sempre importe os objetos pai primeiro
Falta o código de moeda nos campos de moeda	Preencha as colunas Valor e Moeda
Formato de domínio incorreto	Use `https://dominio.com` de forma consistente
Mapear vários campos exclusivos para relações	Mapeie apenas UM (domínio OU ID, não ambos)

Próximos passos

Seu arquivo está pronto. Agora:

Visão geral Importar empresas via CSV