Como disparar uma campanha por Envio em Massa

Este how-to mostra como disparar uma campanha para uma lista de destinatários definida em arquivo, em vez de uma audiência da plataforma. Use o Envio em Massa quando a seleção do público nasce fora da Inngage — numa análise do time de dados, numa exportação do ERP ou numa lista de evento.

Antes de começar

• Arquivo em CSV, XLS ou XLSX, com a primeira linha contendo o cabeçalho (o nome de cada coluna).
• Uma coluna com o identificador único do usuário — CPF, e-mail ou ID. Precisa ser o mesmo dado que identifica o usuário na sua base da Inngage.
• Base legal para a comunicação. Garanta que a lista importada pode receber a mensagem. Listas compradas ou de origem duvidosa prejudicam a reputação dos seus canais.

Formato do arquivo

O arquivo define tanto quem recebe a campanha quanto o conteúdo variável de cada mensagem:

Exemplo:

email,nome,cupom,valor_desconto
maria@exemplo.com,Maria,BEMVINDA10,10%
joao@exemplo.com,João,VOLTA15,15%

Com esse arquivo, a mensagem pode usar as colunas nome, cupom e valor_desconto como variáveis — cada destinatário recebe o próprio cupom.

Passos

1. Acesse Engajamento > Envio em Massa. Alternativamente, dentro do Envio Rápido, abra a aba Envio em Massa (Importar arquivo) na etapa de Destinatários.
2. Arraste o arquivo para a área de upload ou clique em Selecionar Arquivo. A Context Cloud exibe o card do arquivo com o nome, o tamanho e o status Pronto para mapeamento.
3. No card Mapeamento de Colunas, abra o seletor Identificador Amigável e escolha a coluna do arquivo que identifica unicamente o usuário.
4. Em Campos Variáveis, marque as colunas que você quer usar como variáveis na mensagem.
5. Clique em Processar Base.
6. Continue o fluxo do assistente: selecione os canais, escreva a mensagem usando as variáveis da planilha, configure tags, agendamento e evento de conversão, e confirme.

A etapa Destinatários e o Mapeamento de Colunas

O Envio em Massa é um assistente de quatro etapas, e o mapeamento acontece na Etapa 1 de 4 — Destinatários, logo depois do upload. É aqui que a Context Cloud associa as colunas do arquivo aos campos da Inngage. O card Mapeamento de Colunas tem dois campos:

Três comportamentos dessa tela:

• A coluna escolhida como Identificador Amigável sai da lista de Campos Variáveis. Antes da escolha, todas as colunas do arquivo aparecem como opção; depois, a coluna identificadora deixa de ser oferecida como variável. Uma coluna é identificador ou variável, não os dois.
• O botão Processar Base fica indisponível até o Identificador Amigável ser preenchido. Ele é o único campo obrigatório do mapeamento; sem ele o fluxo não avança.
• Marcar Campos Variáveis é opcional, mas condiciona a mensagem. Só as colunas marcadas ficam disponíveis como variáveis na etapa de conteúdo. Se você não marcar nenhuma, o disparo funciona, porém sem personalização.

Para trocar o arquivo, clique no X no canto do card do arquivo e faça um novo upload.

Como validar

Depois de Processar Base, o assistente avança para a etapa seguinte com a lista  de destinatários carregada. Na etapa de conteúdo, as colunas marcadas em Campos Variáveis aparecem como variáveis disponíveis para inserir na mensagem — se uma coluna esperada não estiver lá, ela não foi marcada no mapeamento.

Problemas comuns

• Processar Base não responde ao clique → o Identificador Amigável não foi selecionado → escolha a coluna identificadora no seletor; o botão fica indisponível enquanto o campo estiver vazio.
• Uma coluna que você quer usar como variável não aparece na etapa de mensagem → ela não foi marcada em Campos Variáveis → volte à etapa Destinatários e marque a coluna.
• A coluna identificadora não aparece entre os Campos Variáveis → é o comportamento esperado → a coluna escolhida como Identificador Amigável deixa de ser oferecida como variável.
• Destinatários não são alcançados nos canais que dependem de token (como Push) → o dado da coluna identificadora não corresponde ao identificador usado no app → confirme com o time técnico qual identificador o app envia e use a mesma informação no arquivo.
• A mensagem chega com variável vazia (ex.: "Olá, !") → há células vazias na coluna usada como variável, ou valores com espaços extras → corrija a planilha e refaça o upload.
• O total de enviados fica abaixo do número de linhas do arquivo → deduplicação por identificador único e filtros de elegibilidade → veja con-enviados-menor-que-base.