← Central de Ajuda

Como importar contatos via CSV

Importe sua base de clientes em massa para o Klivo Chat usando um arquivo CSV. Entenda o formato correto, o mapeamento de campos e como evitar duplicatas.

Vídeo Tutorial
Vídeo em breve O tutorial em vídeo será adicionado aqui.

📋 Como funciona a importação?

O Klivo Chat aceita importação de contatos via arquivo CSV (valores separados por vírgula). Cada linha do arquivo representa um contato. O sistema verifica automaticamente duplicatas por e-mail e número de telefone.

📄 Formato do arquivo CSV

O arquivo deve ter uma linha de cabeçalho com os nomes das colunas em inglês:

name,email,phone_number
João Silva,joao@empresa.com,+5511999990001
Maria Santos,maria@exemplo.com,+5521888880002

Colunas disponíveis:

  • name — Nome completo (obrigatório)
  • email — Endereço de e-mail
  • phone_number — Telefone com código do país (ex: +5511999999999)
⚠️

Formato do telefone: inclua sempre o código do país com +. Sem espaços, parênteses ou hífens. Correto: +5511999999999. Incorreto: (11) 99999-9999.

🚀 Realizando a importação

1

Acesse a seção Contatos

Clique no ícone de contatos no menu lateral esquerdo.

2

Clique em "Importar contatos"

Botão disponível após abrir o menu de 3 pontinhos.

3

Selecione o arquivo CSV

Clique em "Escolher arquivo" e selecione o arquivo CSV.

4

Aguarde o processamento

A importação ocorre em segundo plano. Você receberá uma notificação com o número de contatos importados e eventuais erros.

🔄 Contatos duplicados

Se já existir um contato com o mesmo e-mail ou telefone, o sistema atualizará os dados do contato existente — não criará duplicatas. O histórico de conversas é sempre preservado.

💡

Antes de importar uma base grande, teste com 5 a 10 linhas para confirmar que o formato está correto e os dados estão sendo importados como esperado.

⚠️ Erros comuns

  • Coluna "name" ausente: o cabeçalho deve estar em inglês e incluir obrigatoriamente a coluna name.
  • Caracteres especiais quebrados: salve o CSV em codificação UTF-8.
  • Telefone sem código do país: inclua sempre o +55 para números brasileiros.
  • Linhas em branco: remova linhas completamente vazias antes de importar.
Próximo Artigo →Gerenciando e editando contatos

Este artigo foi útil para você?

Ainda com dúvidas?

Nossa equipe está pronta para te ajudar com qualquer situação.

💬  Suporte via WhatsApp