Importar público via planilha

Saiba como importar uma lista de contatos via planilha para definir o público de uma campanha, com mapeamento de variáveis e metadados.

A importação de público via planilha permite que você use listas externas de contatos para disparar campanhas, sem precisar cadastrá-los antes na base. Isso é útil quando você tem contatos em outras ferramentas, planilhas de eventos, bases legadas ou listas com dados personalizados, como códigos de rastreio ou valores de cobrança, que precisam ser enviados junto com a mensagem.

O limite é de 50.000 linhas por importação. Linhas em branco também são contabilizadas. Se o arquivo ultrapassar esse limite, a importação será bloqueada.

Pré-requisitos:

• Ter acesso à conta com perfil de Administrador.
• Ter uma campanha em criação com o canal e o tipo de disparo já definidos.
• Ter a lista de contatos em uma planilha com, no mínimo, a coluna de telefone preenchida.

Acesse a importação de planilha

Na criação da campanha, na etapa Configurar público, clique em Adicionar contatos e selecione Importar planilha.

Escolha o formato da planilha

O sistema abre um assistente com duas opções para você montar sua lista de contatos:

• Preencher no Google Sheets: o sistema gera uma planilha online com os cabeçalhos corretos. Clique em Abrir planilha para editá-la no navegador e, depois de preenchê-la, clique em Continuar para avançar.
• Baixar planilha modelo: o sistema baixa um arquivo .xlsx com a estrutura pronta. Preencha os dados no seu computador e depois faça o upload na etapa seguinte.

Estrutura da planilha por tipo de disparo

A planilha modelo varia conforme o tipo de disparo escolhido na campanha:

• Modelo de mensagem: a planilha vem com a coluna Telefone e uma coluna para cada parâmetro do modelo selecionado. Por exemplo, se o modelo contém [Nome] e [NumeroPedido], a planilha terá as colunas Telefone, Nome e NumeroPedido.
• Chatbot: a planilha vem apenas com a coluna Telefone. Você pode adicionar colunas extras livremente para salvar dados como metadados.

Se você usar a planilha modelo sem alterar os cabeçalhos, o mapeamento na etapa seguinte será preenchido automaticamente.

Preencha e envie a planilha

Se você escolheu Preencher no Google Sheets, edite a planilha diretamente no navegador e clique em Continuar para avançar ao mapeamento.

Se você escolheu Baixar planilha modelo, preencha o arquivo no seu computador e depois clique em Importar arquivo para fazer o upload. O sistema aceita apenas arquivos no formato .xlsx.

Mapeie as colunas (DE-PARA)

Depois do upload, o sistema exibe a tela de mapeamento. Do lado esquerdo aparecem as colunas da sua planilha com uma amostra dos dados. Do lado direito, um seletor para você indicar a qual campo do sistema cada coluna corresponde.

Como o mapeamento automático funciona

Em campanhas por Modelo de mensagem, quando o nome de uma coluna da planilha é exatamente igual ao nome de um parâmetro do modelo, o mapeamento é preenchido automaticamente. Se não houver correspondência, a coluna aparece como Não importar e você pode ajustar manualmente.

Você pode usar qualquer nome de coluna na planilha. O sistema não exige que o nome siga o padrão com colchetes ou seja idêntico ao parâmetro. Basta mapear cada coluna ao campo correto na tela de DE-PARA.

Opções disponíveis no mapeamento

As opções do seletor variam conforme o tipo de disparo:

Modelo de mensagem:

• Telefone (obrigatório)
• Parâmetros do modelo (obrigatórios)
• Nome
• Metadado
• Não importar

Chatbot:

• Telefone (obrigatório)
• Nome
• Metadado
• Não importar

Se você mapear uma coluna como Nome e o valor na planilha for diferente do nome que o contato já tem na conta, o cadastro do contato será atualizado com o nome da planilha.

Parâmetros com preenchimento automático

Alguns modelos de mensagem possuem parâmetros configurados com preenchimento automático, como Nome da conta, Nome do agente ou Nome do contato. Quando você importa uma planilha e mapeia uma coluna para um desses parâmetros, o sistema usa o valor da planilha no disparo, e não o que foi definido para puxar automaticamente do cadastro.

Essa substituição vale apenas para a mensagem disparada na campanha. Nenhum dado é atualizado no cadastro. Por exemplo, se o parâmetro está configurado para puxar o nome do agente e a planilha traz um valor diferente nessa coluna, a mensagem será enviada com o valor da planilha, mas o nome do agente no sistema permanece o mesmo.

Mapeie colunas como metadado

Se a sua planilha contém dados que você quer salvar no contato ou no atendimento, selecione Metadado no seletor. O sistema preenche a chave do metadado automaticamente com o nome da coluna e exibe um campo para você escolher o destino: Salvar no Contato ou Salvar no Atendimento.

Cada campo do sistema pode ser mapeado apenas uma vez. Ao selecionar um campo em um seletor, ele fica indisponível nos demais.

Conclua o mapeamento

O botão Validar e Concluir só é habilitado quando todos os campos obrigatórios estão mapeados. Enquanto houver campo obrigatório pendente, o sistema exibe um alerta indicando quais campos faltam.

Resolva conflitos na importação

Se o sistema identificar inconsistências nos dados, a tela de conflitos é exibida antes de finalizar a importação. Cada tipo de problema aparece em um bloco separado:

• Telefone inserido mais de uma vez: números duplicados na planilha. Apenas uma ocorrência será considerada no disparo.
• Telefone digitado incorretamente: números com formato inválido ou com o campo vazio.
• Contato com parâmetro vazio: linhas em que um campo obrigatório do modelo está sem preenchimento.

Contatos listados nos blocos de conflito não serão importados. Você pode:

1. Clicar em Voltar para a importação para corrigir o arquivo e fazer um novo upload.
2. Clicar em Concluir sem os contatos listados para seguir apenas com os contatos válidos.

Se todos os contatos da planilha tiverem algum conflito, a importação será cancelada automaticamente e nenhum contato será adicionado ao público da campanha.

Entenda quando os contatos são criados na conta

Contatos da planilha que ainda não existem na conta não são criados no momento da importação. Eles são criados apenas quando o disparo da campanha é efetivamente executado para aquele número. Se a campanha for cancelada antes do disparo de um contato, ele não será criado na conta.

Considerações Adicionais:

• Ao fechar o assistente de importação antes de concluir, você pode escolher entre Guardar as informações para continuar depois ou Perder a importação para descartar tudo.
• Se você já tem uma importação salva e clica novamente em Importar planilha, o sistema retoma automaticamente de onde você parou.
• Se a campanha já tem uma importação vinculada, o sistema pede confirmação antes de descartar nos seguintes casos: trocar o tipo de disparo (de modelo de mensagem para chatbot ou vice-versa), trocar o canal de atendimento (porque modelos e chatbots de um canal podem não estar disponíveis no outro) ou trocar o modelo de mensagem selecionado (porque os parâmetros podem ser diferentes).
• Trocar o chatbot selecionado por outro chatbot é a única alteração que não afeta a importação, porque o tipo chatbot não tem parâmetros vinculados à planilha.

---

Artigos relacionados

• Criar nova campanha
• Criar modelo de mensagem para campanha
• Riscos e custos da campanha