Importação de dados
Serve para dois momentos: começar com a base que você já tem, e migrar de outra ferramenta de atendimento.
Só administradores importam.
Importar contatos de uma planilha
O arquivo precisa ser CSV com estas colunas:
firstName, lastName, email, phone, tags
- Vá em Configurações › Importação.
- Em Importar Contatos via CSV, clique em selecionar o arquivo.
- Escolha o CSV.
- Confirme.

Resultado esperado: os contatos aparecem em Contatos. Quem já existia é ignorado.
Duplicados são ignorados sozinhos
A plataforma compara por e-mail ou telefone. Se a pessoa já está na base, o registro do arquivo é descartado — não vira um segundo cadastro.
Isso significa que reimportar a mesma planilha é seguro. Se você não tem certeza se a importação foi completa, importe de novo.
Antes de importar, arrume a planilha
O trabalho de cinco minutos aqui evita uma base ruim para sempre:
- Telefone com DDI e DDD:
+5511955500101. Sem o DDI, o contato pode não casar com a conversa do WhatsApp e você acaba com dois cadastros. - Nome e sobrenome separados, nas colunas certas.
- Sem linha vazia no meio.
- Codificação UTF-8, senão os acentos chegam quebrados — e nome de cliente com acento errado aparece em toda mensagem que você mandar.
Importe primeiro um arquivo com cinco linhas. Confira o resultado em Contatos e só então importe os dez mil.
Migrar do Chatwoot
Se você vem do Chatwoot, exporte de lá o arquivo JSON com contatos e conversas e use a opção Importar do Chatwoot. Ela traz as duas coisas, não só os contatos.
Antes de importar uma lista para campanha
Contato importado não é contato que autorizou receber mensagem. Disparar campanha para uma lista comprada leva a denúncia, e denúncia leva ao bloqueio do seu número — que derruba também o atendimento do dia a dia. Veja Criar uma campanha.
Dúvidas comuns
A importação terminou e faltaram contatos. Linhas sem telefone e sem e-mail não têm como ser identificadas. Confira também os duplicados, que são ignorados de propósito.
Os acentos vieram errados. A planilha não estava em UTF-8. Salve de novo nessa codificação e reimporte — os já existentes serão ignorados.
Consigo importar as etiquetas junto?
Sim, pela coluna tags.
Dá para desfazer uma importação? Não há um botão de desfazer. Por isso o teste com poucas linhas antes.