Todos os artigos

Importar contatos de CSV/Excel

Disparos e Listas1 min de leituraAtualizado em 15 de julho de 2026
Como aparece no Teha
Importar contatos
Importar contatos · /lists

Como importar

Listas → Importar CSV. Suporta:

  • CSV (padrão pt-BR, separador ; ou ,)
  • XLSX (Excel)
  • Até 10.000 contatos por import

Formato esperado

Colunas mínimas:

  • nome (obrigatório)
  • telefone ou phone (obrigatório, formato +55 11 99999-9999 ou só números)

Colunas opcionais:

  • email
  • empresa
  • tags (separadas por vírgula: "lead-quente,vip")
  • Qualquer campo personalizado que você criou em Configurações → Campos personalizados → Contato

Mapeamento de colunas

Após o upload, o sistema mostra preview e pede pra você mapear cada coluna da planilha pro campo do Teha. Se a coluna tem nome exato (nome, telefone), mapeia sozinho.

Telefones com formato bagunçado

O sistema normaliza automaticamente:

  • "(11) 9 9999-9999" → "+5511999999999"
  • "11999999999" → "+5511999999999"
  • "999999999" → ❌ inválido (precisa do DDD)

Duplicatas

Se já existe contato com o mesmo telefone, o sistema:

  • Atualiza tags (adiciona, não substitui)
  • Atualiza campos personalizados (sobrescreve)
  • NÃO duplica o contato

Importação grande (>2k contatos)

Demora 30s a 5min. Não feche a aba. Você recebe notificação quando terminar.

Erro "telefone inválido"

Linhas com telefone vazio ou mal formatado são puladas. Relatório no fim mostra quantas falharam e o motivo.

Exportar contatos

Listas → Exportar CSV. Inclui todos os campos + tags. Útil pra backup ou migração.

Esse artigo te ajudou?

Continuar lendo em Disparos e Listas

Ainda com dúvida sobre isso?

Manda mensagem direto — sem fila, sem bot dando volta.

Artigo da Central de Ajuda Teha