Campanhas
Uma campanha envia um template aprovado para um público, respeitando as regras do provedor. É o caminho indicado para retomar contato fora da janela de 24 horas.
Ciclo de vida
| Estado | Significado |
|---|---|
| Rascunho | Em montagem; pode ser editada, disparada ou excluída |
| Agendada | Com data marcada; pode ser cancelada |
| Enviando | Em execução |
| Finalizada | Concluída |
| Cancelada | Interrompida pelo operador |
| Falhou | Erro no envio |
As regras de edição seguem o estado: só rascunho ou agendada podem ser editadas, e só rascunho pode ser disparado na hora. Uma variante de teste A/B só é editável junto com a campanha-mãe.
Montando uma campanha
- Nome e canal — o canal define os templates e as regras disponíveis.
- Público — de onde vem a lista de destinatários:
- CSV enviado por você (UTF-8, com cabeçalho);
- relatório — uma lista de contatos pré-configurada, marcada como elegível para campanha (
eligible).
- Template — escolha um template aprovado nesse canal. O sistema mostra os parâmetros que ele espera.
- Mapa de campos (
fieldsMap) — ligue cada parâmetro do template a uma coluna do público. O mapa precisa cobrir todos os campos do template e não pode apontar para colunas inexistentes. - Agendamento — envie agora, escolha a data/hora ou programe a criação de um rascunho com
send_time. - Disparo ou agendamento.
Teste A/B
O A/B divide o público entre variantes para descobrir o que funciona melhor. São 2 a 10 variantes, e o teste tem sempre três decisões: o tipo, o critério de vitória e a duração.
Tipo do teste
| Tipo | O que muda entre as variantes | Quando usar |
|---|---|---|
Mensagem (template_message) | O template de cada variante | Você tem duas abordagens de texto e quer saber qual converte |
Horário de envio (send_time) | O horário de cada variante | A mensagem é a mesma; a dúvida é quando falar com o cliente |
Critério de vitória
| Critério | Como o vencedor é escolhido | Exige duração? |
|---|---|---|
Somente divisão (split_only) | Não há vencedor: o público é apenas dividido entre as variantes | Não |
Leituras (read) | Quem tem mais leituras | Sim |
Entrega e leitura (delivery_read) | Quem tem mais entregas e, no empate, mais leituras | Sim |
Manual (manual) | Quem decide é o operador, depois de ver os números | Sim |
O empate é resolvido pela variante mais antiga; se ainda empatar, pela ordem do identificador. Nada é aleatório.
Regras de porcentagem (o ponto que mais confunde)
| Critério | Soma das porcentagens |
|---|---|
| Somente divisão | Precisa fechar exatamente 100% — o público inteiro é dividido |
| Leituras, Entrega e leitura ou Manual | Precisa ser menor que 100% — o que sobra fica reservado ao vencedor e é enviado no fim do teste |
Um teste de 3 variantes com porcentagens iguais, portanto, é 33,33 + 33,33 + 33,34 — e não 33,33 três vezes: a soma precisa fechar exatamente 100%. Com vencedor, cada variante recebe porcentagem × público (mínimo de 1 destinatário, mesmo com público pequeno).
Duração
A duração (minuto, hora, dia ou semana) conta a partir do envio da última variante e define dois momentos: quando o teste fecha e quando o restante do público recebe a variante vencedora. É obrigatória em todos os critérios, exceto somente divisão.
Validações que o produto aplica
| Tipo | Exigências |
|---|---|
| Mensagem | Cada variante precisa de um template aprovado no canal, e duas variantes não podem usar o mesmo template |
| Horário | Cada variante precisa de um agendamento; no máximo uma pode ser "agora"; duas variantes não podem cair no mesmo minuto |
As fases da campanha
| Fase | O que está acontecendo |
|---|---|
not_started | O teste ainda não começou |
picking_winner | As variantes foram enviadas; o produto está apurando |
awaiting_manual_winner | O critério é manual e a escolha está esperando você |
winner_chosen | Vencedor marcado; o restante do público foi (ou será) disparado |
Uma variante só pode ser editada junto com a campanha — não existe editar só uma delas. E a promoção a vencedor só é aceita na fase correta; fora dela, a resposta diz o porquê.
Exemplo 1 — teste de mensagem
Objetivo: saber qual texto de reengajamento os clientes leem mais.
- Tipo Mensagem; variante A com o template "volte a comprar" e variante B com "sentimos sua falta".
- Critério Leituras; cada variante com 20% do público; duração de 4 horas.
- Resultado: 40% do público recebeu as duas abordagens, o produto apurou quem teve mais leituras e os 60% restantes receberam a vencedora.
Use esse formato quando o que você quer decidir é o que dizer.
Exemplo 2 — teste de horário
Objetivo: descobrir se o cliente responde mais de manhã ou no fim do dia.
- Tipo Horário; variante A às 09:00, variante B às 19:00; o mesmo template nas duas.
- Critério Somente divisão, 50% + 50%; sem duração.
- Resultado: todo o público recebeu a mensagem — metade de manhã, metade à noite — e o relatório diz qual faixa teve mais leitura ou resposta.
Use esse formato quando o que você quer decidir é quando falar. E se depois de medir você quiser agir no resultado, repita o teste com critério Leituras e 30% + 30% mais uma duração: os 40% restantes recebem no horário vencedor.
Acompanhamento
A tela da campanha mostra o andamento por estado, e o painel da campanha traz as métricas de entrega e leitura por template e por variante.
Rastreamento de anúncios
Medir anúncios pagos do Google e da Meta que levam o cliente a iniciar a conversa é outro recurso, sem relação com as campanhas de disparo. Veja Rastreamento de anúncios.
Erros comuns
| Erro | O que significa |
|---|---|
campaign_not_dispatchable | Só rascunhos podem ser disparados imediatamente |
campaign_not_cancellable | Só campanhas agendadas podem ser canceladas |
campaign_not_deletable | Estado não permite exclusão |
template_not_approved | O template escolhido não está aprovado neste canal |
mapping_incomplete | O fieldsMap não cobre o template ou usa coluna inexistente |
audience_invalid_csv | CSV sem cabeçalho ou sem linhas de dados |
report_not_eligible | O relatório escolhido não pode ser público de campanha |
schedule_in_past | Data de agendamento no passado |
Veja também Solução de problemas.