Como importar contatos por CSV para uma campanha
Se a sua lista de contatos está fora da Talqui, o caminho é importar um arquivo CSV direto no passo de destinatários da campanha. Os contatos são criados (ou atualizados, se já existirem) e entram no disparo.
No passo Destinatários da campanha, clique em Importar CSV. O assistente abre quatro sub-passos próprios, que aparecem recuados no menu lateral.
1. Enviar arquivo
Arraste o arquivo para a área tracejada ou clique nela para escolher. São aceitos arquivos .csv de até 50 MB — o suficiente para algo em torno de 200 mil contatos.
Se você não tem um arquivo pronto, clique em Baixar modelo no canto direito: ele traz uma planilha com as colunas que a Talqui espera.
Assim que o arquivo é lido, a Talqui mostra o que entendeu: o nome do arquivo, quantas linhas encontrou e quantas colunas identificou. Vale conferir esse número antes de seguir — se ele vier muito diferente do esperado, provavelmente o separador do arquivo não é o que a planilha usou.
Salve a planilha como CSV UTF-8 no Excel ou no Google Sheets. Um arquivo salvo em outra codificação faz acentos virarem símbolos estranhos nos nomes dos contatos, e isso não tem como ser corrigido depois da importação.
2. Mapear campos
A tela lista todas as colunas do seu arquivo, uma por linha, com o primeiro valor de cada uma logo abaixo do nome — é o que permite reconhecer uma coluna de cabeçalho ambíguo (um "data" pode ser data de cadastro ou de vencimento) sem voltar à planilha.
Ao lado de cada coluna você escolhe o destino dela: um campo do contato na Talqui, um campo personalizado seu, ou Não importar esta coluna.
A Talqui já tenta adivinhar pelo nome: uma coluna chamada Telefone, Celular ou WhatsApp cai sozinha no campo certo. As que ela não reconhece começam em Não importar — nada entra por engano.
Cada campo recebe no máximo uma coluna. Um campo já usado por outra linha some da lista das demais, porque duas colunas alimentando o mesmo campo não teriam como ser resolvidas.
Telefone é o único campo obrigatório. Enquanto ele não estiver mapeado, o botão de continuar fica desabilitado. Nome não é exigido: nem toda lista traz um, e um contato só com telefone é válido.
Customizando a planilha: colunas suas, além das nossas
O modelo que você baixa traz as colunas básicas, mas você pode acrescentar quantas colunas quiser. Qualquer coluna a mais vira um campo personalizado, e é isso que permite escrever uma mensagem diferente para cada pessoa.
Uma planilha customizada é simplesmente o modelo com colunas extras:
Nome,Telefone,Email,cidade,plano,vencimento
Ana Souza,5511988887777,[email protected],São Paulo,Premium,10/03
Bruno Lima,5521977776666,[email protected],Rio de Janeiro,Básico,15/03Aqui cidade, plano e vencimento não existem no cadastro da Talqui — são suas. No passo de mapeamento, clique em Adicionar campo personalizado, dê o nome a cada uma e escolha qual coluna da planilha ela representa.
Que informação vale a pena trazer
A pergunta certa é: isso muda de pessoa para pessoa e aparece na mensagem? Se sim, vira coluna.
Tipo de informação | Exemplos de coluna |
|---|---|
Identificação |
|
Comercial |
|
Cobrança |
|
Pedido |
|
Localização |
|
Relacionamento |
|
Não vale a pena trazer o que é igual para todo mundo — o nome da promoção, o cupom do mês, a data do evento. Isso você escreve uma vez só no passo 4, como valor fixo.
Use nomes curtos, sem acento e sem espaço nas colunas personalizadas (numero_pedido em vez de Número do Pedido). A Talqui ajusta o nome para um formato seguro na hora de salvar, e nomes simples evitam que você não reconheça o campo depois.
Do arquivo até a mensagem
O caminho completo tem três paradas:
Na planilha — você cria a coluna
vencimentocom a data de cada cliente.No mapeamento — você adiciona o campo personalizado
vencimentoe aponta para essa coluna.No passo 4 — na variável
@data, escolhe a origem Dado do contato e selecionavencimento.
Resultado: cada pessoa recebe a data dela na mensagem, num disparo só.
O campo personalizado só aparece na lista do passo 4 se a importação que o trouxe foi feita nesta campanha. É ali que a Talqui aprende que aquela coluna existe. Importar numa campanha e esperar o campo em outra não funciona.
Esses campos também ficam guardados no contato e podem ser usados como filtro para montar o público de campanhas futuras.
O passo a passo de como apontar a variável para o campo está em Como preencher as variáveis do modelo de mensagem, com o detalhe importante do valor reserva — sem ele, um contato sem o dado impede o envio da campanha inteira.
3. Revisar
Mostra uma amostra das primeiras linhas já mapeadas, para você conferir se as colunas foram parar nos lugares certos. O texto abaixo da tabela diz claramente que é uma amostra, e quantas linhas existem no total.
Se a Talqui conseguir prever que algumas linhas serão recusadas, ela avisa aqui, antes de você confirmar. Isso só acontece com arquivos pequenos, em que ela consegue ler tudo pelo navegador — em arquivos grandes ela mostra apenas a explicação geral, porque uma contagem estimada a partir de uma amostra pareceria precisa e estaria errada.
Confira também a contagem no botão: Importar N contatos.
4. Importando
O disparo da importação é assíncrono: você não precisa ficar com a tela aberta esperando, mas se ficar, acompanha em tempo real.
A tela passa por três momentos:
Na fila — o trabalho foi registrado e começa em alguns segundos.
Lendo o arquivo — a barra fica em movimento contínuo e o contador mostra quantas linhas já foram lidas. Ainda não dá para saber a porcentagem, porque o total só é conhecido quando o arquivo termina de ser percorrido.
Importando contatos — a barra vira percentual e os contadores de importados e recusados sobem.
Existe um botão Atualizar ao lado dos contadores. A tela se atualiza sozinha, mas se ela parecer parada, é ele que força uma consulta nova.
Ao terminar, a barra fica verde com um visto e aparece o resumo: quantos contatos entraram, quantas linhas foram recusadas e a etiqueta que os contatos receberam. Guarde essa etiqueta — é por ela que você encontra depois exatamente quem veio dessa importação.
Os dois relatórios
No fim da importação você tem dois arquivos para baixar:
Contatos importados — quem entrou, com telefone, e-mail, nome e etiquetas.
Linhas recusadas — cada linha que ficou de fora, com o código do motivo, a explicação em português e os valores como estavam na sua planilha, para você achar a célula e corrigir.
O relatório de recusados fica disponível assim que o arquivo termina de ser lido, antes mesmo de a importação acabar — dá para começar a corrigir a planilha enquanto o resto ainda está entrando. O de importados só aparece no fim, porque antes disso ele estaria incompleto.
Os motivos possíveis estão explicados em Por que alguns contatos foram recusados na importação?.
Contatos repetidos
A importação não cria contato duplicado. Antes de gravar cada linha, a Talqui procura se aquela pessoa já existe, considerando as duas formas do nono dígito do celular brasileiro. Um número salvo como 5511988887777 e importado como 551188887777 é reconhecido como a mesma pessoa, e o contato é atualizado em vez de duplicado.
Se a mesma pessoa aparecer duas vezes dentro do próprio arquivo, a segunda linha é recusada com o código E120.
Este artigo foi útil?