Importe contatos por CSV e corrija os recusados
Tem uma lista de clientes numa planilha, fora da Talqui? Dá para importá-la direto no passo Destinatários da campanha. Os contatos são criados ou atualizados na Talqui e já entram no público do disparo. Este artigo mostra os quatro sub-passos da importação, como preparar o arquivo e o que fazer com as linhas recusadas.
Como abrir a importação
No assistente da campanha, chegue ao passo Destinatários.
Clique em Importar CSV, ao lado de Seleção em lote.
O roteiro à esquerda ganha quatro sub-passos: Enviar arquivo, Mapear campos, Revisar e Importando.
A mesma importação existe na tela de Contatos. Dentro da campanha, a diferença é que os contatos importados entram direto nos destinatários e os campos personalizados que você criar ficam disponíveis como variáveis da mensagem.
Como preparar o arquivo
Formato: arquivo
.csv, de até 50 MB. Planilhas do Excel (.xlsx) precisam ser salvas como CSV antes. Não há limite de linhas.Primeira linha: os nomes das colunas, como
nome;telefone;email.Telefone: com DDD. O código do país (55) é opcional para números do Brasil. Parênteses, traços e espaços são ignorados, então
(19) 98123-4500funciona.Colunas extras: pode acrescentar quantas quiser, como cidade, plano ou vencimento. Cada uma pode virar um campo personalizado e ser usada na mensagem.
Para começar do jeito certo, use Baixar modelo CSV no primeiro sub-passo. O modelo vem com as colunas nome, telefone e email, separadas por ponto e vírgula, e duas linhas de exemplo.
1. Enviar arquivo

Clique na área tracejada para escolher o arquivo ou arraste o CSV para dentro dela. Quando ele é lido, aparece o resumo, por exemplo "10 linhas · 5 colunas identificadas", e o botão Trocar arquivo.

O cartão Formato do arquivo mostra o que a Talqui detectou sozinha:
Codificação: UTF-8, UTF-16, Windows-1252 (Excel), Mac Roman (Excel Mac antigo) ou MS-DOS (CP850).
Separador de colunas: ponto e vírgula, vírgula, tabulação, barra vertical ou outro caractere.
Quebra de linha: Windows, Unix ou Mac antigo.
Tudo vem marcado como Automático. Se os acentos ou as colunas aparecerem errados na próxima tela, clique em Alterar manualmente e escolha o valor certo. Quando a detecção não tem certeza, o cartão avisa "Não tivemos certeza, confira o preview".
Clique em Continuar.
2. Mapear campos

Aqui você diz o que cada coluna significa. Para cada Coluna do CSV, com um exemplo do conteúdo, escolha o Campo do contato:
Campo | Observação |
|---|---|
Nome completo | Dividido em nome e sobrenome e escrito com iniciais maiúsculas |
Primeiro nome e Sobrenome | Use no lugar do nome completo, quando a planilha já separa |
Telefone | Obrigatório |
Opcional | |
Não importar esta coluna | A coluna é ignorada |
A Talqui reconhece sozinha colunas com nomes comuns, como "telefone", "celular", "whatsapp", "nome" ou "cliente".
Telefone é obrigatório. Sem ele mapeado, aparece "Falta mapear Telefone. Sem esse campo o contato não pode ser criado." e o botão não avança. E não mapeie Nome completo junto com Primeiro nome ou Sobrenome: as linhas são recusadas.
Campo personalizado
Para uma coluna que não existe no cadastro padrão, como cidade ou plano:
Clique em Adicionar campo personalizado.
Em Nome do campo, escreva o nome, por exemplo "cidade". Use só letras, números, hífen e underscore. A janela mostra como ele vai ficar: "Será criado como: cidade".
Clique em Criar campo.
Na linha da coluna, escolha o campo novo.

O campo fica gravado no contato e aparece como opção nas variáveis da mensagem, no último passo da campanha. Assim, cada contato pode receber, por exemplo, a cidade dele no texto.
3. Revisar

A revisão mostra quantas linhas serão enviadas e uma prévia das primeiras, com os nomes já como vão ficar salvos. Se a Talqui prevê recusas, ela avisa antes, por exemplo "2 linhas devem ser recusadas: sem telefone e sem e-mail, ou com telefone ou e-mail inválido."
Clique em Importar 10 contatos (o número muda conforme o arquivo).
4. Importando
A tela acompanha o andamento: "Importação na fila...", depois "Importando contatos..." com as linhas lidas, importadas e recusadas, até "Importação concluída".

No fim aparecem:
o resumo, por exemplo "7 contatos importados e 3 linhas recusadas.";
as recusas agrupadas por motivo;
a etiqueta que todos os contatos importados receberam, no formato
import-seguido de um código, e o aviso de que eles "já entram nos destinatários desta campanha";os botões Baixar relatório de importados e Baixar relatório de recusados.
Clique em Continuar para voltar ao passo de destinatários. Os contatos importados aparecem na prévia com a origem CSV.
Baixe o relatório de recusados antes de continuar. Ele traz cada linha recusada com o número da linha, o código, o motivo e os dados originais, pronto para você corrigir e importar de novo só o que ficou de fora.
Por que uma linha é recusada
Código | Na tela | O que fazer |
|---|---|---|
E100 | com valor inválido | Corrija o e-mail mal formado ou encurte a célula (até 512 caracteres) |
E110 | sem telefone e sem e-mail | Preencha o telefone da linha |
E120 | com contato repetido no arquivo | Nada: a primeira ocorrência foi importada e a repetida foi ignorada |
E130 | com nome completo e nome/sobrenome mapeados ao mesmo tempo | Volte ao mapeamento e use só um dos dois jeitos |
E150 | com telefone inválido | Confira o DDD e a quantidade de dígitos |
E160 | com falha ao gravar | Importe a linha de novo; se repetir, fale com o suporte |
Telefones do Brasil
O telefone é validado com estas regras:
precisa ter DDD, e o DDD precisa existir;
celular com 9 dígitos começa com 9;
números de 8 dígitos são aceitos como fixo ou como celular antigo, sem o nono dígito.
A Talqui grava o número como veio, sem acrescentar nem tirar o nono dígito.
Perguntas frequentes
Se o contato já existe na Talqui, ele é duplicado?
Não. A importação procura o contato pelo telefone, considerando o número com e sem o nono dígito, e depois pelo e-mail. Quando encontra, atualiza o contato existente em vez de criar outro.
Posso importar um arquivo do Excel?
Pode, depois de salvar como CSV. No Excel, use "Salvar como" e escolha "CSV (separado por vírgulas)" ou "CSV UTF-8". A Talqui detecta a codificação do Excel sozinha.
Os acentos apareceram errados na prévia. O que faço?
No cartão Formato do arquivo, clique em Alterar manualmente e troque a Codificação. Arquivos salvos pelo Excel no Windows costumam ser Windows-1252.
Preciso ter a coluna de e-mail?
Não. Na campanha o telefone é o que importa, porque a mensagem sai pelo WhatsApp.
Posso usar números de outros países?
Pode, com o código do país no começo do número. Sem o código, a Talqui entende que o número é do Brasil.
Saí da tela antes de baixar o relatório. Perdi?
Os relatórios ficam disponíveis enquanto a importação está aberta na tela. Por isso, baixe o de recusados antes de clicar em Continuar.
Continue explorando
Personalização: use os campos personalizados nas variáveis da mensagem.
Este artigo foi útil?