Skip to content

This article has not been translated yet.

On this page
Marketing

Campanhas de WhatsApp

Uma campanha de WhatsApp envia a mesma mensagem para vários contatos, uma por vez, com intervalo entre os envios e dentro do horário que você definiu, para proteger o número.

# Onde fica

Módulo Marketing → Campanhas → Nova Campanha → Campanha de WhatsApp.

# Antes de começar

  1. Um número de envio. Conecte o WhatsApp e adicione o número em Números de campanha do WhatsApp.
  2. Um template de campanha. Veja Templates de campanha do WhatsApp.
  3. Contatos ativos com telefone válido.

# Criar uma campanha

  1. Em 1. Nome da campanha, dê um nome de até 100 caracteres.
  2. Em 2. Template de mensagem, clique no template. O selo Meta marca os que têm template oficial aprovado.
  3. Em 3. Destinatários, escolha uma aba: Contatos, Listas ou Segmentos (um segmento por campanha).
  4. Em 4. Agendamento (opcional), deixe Envio imediato (sem agendamento) ou escolha data e Horário, no fuso da empresa.
  5. Em 5. Mensagem de opt-out, mantenha ligada a chave e ajuste o texto se quiser.
  6. Clique em Enviar agora ou Agendar envio.

Os botões só ficam ativos com nome, template e ao menos um destinatário elegível.

Salvar rascunho apenas guarda a campanha. O detalhe de um rascunho de WhatsApp não tem ação para editar, enviar ou excluir: para disparar, crie a campanha de novo com Enviar agora ou Agendar envio.

# Quem é elegível

A faixa abaixo das abas mostra destinatários elegível(is) e, quando há, os excluídos (opt-out / telefone inválido). Entra na campanha o contato que:

  • está com status ativo;
  • tem telefone com pelo menos 10 dígitos, contando o código do país (o 55 é acrescentado quando falta);
  • não fez opt-out de campanhas de WhatsApp;
  • não está bloqueado no atendimento.

O público é montado quando o envio começa. Se nesse momento ninguém for elegível, a campanha termina como Enviada com total 0. Na aba Segmentos, a contagem da tela ainda não desconta os opt-outs.

# Mensagem de opt-out

Com a chave ligada, o texto (por padrão “Responda SAIR para não receber mais mensagens”) vai ao final de cada mensagem. Quem recebeu uma campanha e responde exatamente SAIR, PARAR, STOP ou CANCELAR deixa de receber campanhas e recebe uma confirmação. Responder ATIVAR ou VOLTAR desfaz. O contato continua ativo para o resto do sistema. Veja Descadastro, opt-out e e-mails inválidos.

# Como o envio acontece

  1. A cada minuto o sistema verifica as campanhas com horário vencido, monta a fila e passa a campanha para Enviando.
  2. As mensagens saem uma a uma, só dentro do horário comercial configurado, com intervalo aleatório entre elas.
  3. Com mais de um número ativo, os envios se alternam entre eles. Se o template tem variações, uma é sorteada a cada mensagem.
  4. As variáveis são trocadas pelos dados do contato e a mensagem aparece na conversa dele em WhatsApp.
  5. Quando a fila acaba, a campanha vira Enviada.

# Acompanhar e cancelar

Clique na campanha. O detalhe mostra as datas, a barra “Processando X de Y mensagens…” com o tempo estimado, e os cartões Total, Enviados, Entregues, Lidos, Respondidos, Falhas e Opt-outs. A tabela Destinatários pode ser filtrada por status e traz o motivo na coluna Erro. A coluna Contato mostra um código, não o nome.

Cancelar campanha aparece em Agendada e Enviando. O que já saiu é mantido; o que estava pendente passa a Falhou com o erro “Campanha cancelada”. Não dá para desfazer.

# Números oficiais e template Meta

Número da API oficial do WhatsApp só envia campanha por template aprovado pela Meta. Número não oficial envia o texto livre do template de campanha. O diálogo avisa:

  • Bloqueio: há número oficial ativo e o template escolhido não tem template Meta. Vincule um template oficial ao template de campanha ou desative os números oficiais.
  • Aviso: todos os números ativos são não oficiais, então o template Meta é ignorado e a campanha sai como texto livre.
  • Misto: números oficiais enviam pelo template Meta e os não oficiais enviam o texto livre.

# Regras e limites

  • Horário comercial: fora dele nada sai. O diálogo avisa que “O envio será iniciado no próximo horário válido.”
  • Limite diário: cada número tem o seu. O diálogo avisa quando a capacidade do dia é menor que o total de destinatários.
  • Pausada: quando nenhum número pode enviar (limite diário atingido, saúde crítica ou circuit breaker), a campanha passa para Pausada. Uma campanha pausada não tem ação para retomar nem para cancelar na tela; se a sua ficou assim, fale com o suporte.
  • O filtro de status da tela Campanhas não se aplica às campanhas de WhatsApp.

# Problemas comuns

O que aparece O que fazer
“Nenhum número de envio configurado ou disponível.” Adicione um número em Configurações → Números para Campanhas e confira se está ativo, sem saúde crítica e sem circuit breaker.
“Nenhum destinatário elegível. Verifique se os contatos possuem telefone válido e não estão em opt-out.” Corrija os telefones ou escolha outro público.
Erro “Variável do template sem valor para este contato” O template Meta usa um campo que está vazio nesse contato. Preencha o campo.
Erro “Número oficial: campanha de texto livre exige janela de 24h aberta. Use um template aprovado.” Vincule um template Meta ao template de campanha.
Erro “contact_blocked” O contato foi bloqueado depois que a fila foi montada.
Campanha parada em Enviando Confira o horário comercial e o limite diário dos números.

# Veja também