Sobre este artigo
Este artigo cobre uma novidade do público por CSV em campanhas: criar automaticamente os contatos que ainda não existem na base, em vez de enviar só para quem já está cadastrado. Para o passo a passo completo de como montar uma campanha, veja o guia principal: Como enviar mensagens via campanha no Cloud Chat.
Recurso em fase piloto. Não vem habilitado por padrão. Para ativar na sua conta, solicite a habilitação ao time da Cloud Humans pelo seu canal de suporte. Enquanto não estiver habilitado, o público por CSV continua enviando apenas para contatos já existentes.
Criar contatos não encontrados
Na etapa de público da campanha, aba CSV, depois de subir a planilha aparece a opção "Criar contatos não encontrados":
-
Desmarcada (padrão): a campanha envia somente para os telefones do CSV que já existem na base.
-
Marcada: os contatos do CSV que ainda não existem são criados automaticamente antes do disparo e passam a receber a campanha.
O resumo (preview) mostra antes de enviar quantos contatos já existem, quantos serão criados e quantos serão ignorados — por exemplo "Até 3 contato(s) serão criados".
O limite padrão é de 3.000 destinatários por campanha. Se o CSV tiver mais contatos novos do que o espaço disponível, os que passarem do limite não são criados — e aparecem como ignorados no preview e no relatório de falhas.
Coluna de nome (opcional)
Se a planilha tiver uma coluna name, o contato criado recebe esse nome. Sem ela, o contato fica identificado pelo telefone. (As regras de coluna obrigatória — phone_number ou email — são as mesmas do público por CSV; veja o guia principal.)
Relatório de falhas
Quando alguma linha do CSV não pode virar contato/destinatário, a campanha gera um relatório de falhas para download, no detalhe/progresso da campanha.
-
O arquivo é um CSV com uma linha por falha: identificador (telefone ou e-mail), nome e o motivo (ex.: telefone em formato inválido, duplicado na planilha, acima do limite da campanha).
-
Sem falhas, não há relatório — o botão só aparece quando existe pelo menos uma linha com problema.
Não confunda com o "Baixar CSV dos não encontrados". São coisas diferentes:
-
Baixar CSV dos não encontrados — linhas que não casaram com nenhum contato existente (sempre disponível no público por CSV).
-
Relatório de falhas — linhas que não puderam ser criadas como contato (só no fluxo de "Criar contatos não encontrados").
Perguntas frequentes
Por que não vejo a opção / o relatório?
(1) O recurso ainda não foi habilitado para a sua conta (fase piloto); (2) a campanha não teve nenhuma falha — então não há relatório para baixar; (3) você ainda não abriu o detalhe da campanha já processada.
Os contatos criados entram na minha base normalmente?
Sim. Ficam disponíveis na tela de Contatos como qualquer outro contato.