Como podemos ajudar você hoje?

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

  1. No assistente da campanha, chegue ao passo Destinatários.

  2. 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-4500 funciona.

  • 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

Sub-passo Enviar arquivo, com o modelo para baixar e a área para soltar o 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.

Arquivo lido, com o resumo de linhas e colunas e o formato detectado

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

Mapeamento das colunas do CSV para os campos do contato

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

E-mail

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:

  1. Clique em Adicionar campo personalizado.

  2. 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".

  3. Clique em Criar campo.

  4. Na linha da coluna, escolha o campo novo.

Janela Novo campo personalizado, com o nome do campo preenchido

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

Revisão da importação com a prévia das linhas e o aviso de recusas

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".

Importação concluída com o resumo, as recusas por motivo e os relatórios

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

Atualizado em 07 de novembro de 2026

Este artigo foi útil?