Uma campanha do WhatsApp é um modelo aprovado, enviado de um número de WhatsApp, para todas as pessoas de uma lista — com o nome, o horário ou o código de cada uma preenchido a partir da ficha de contato. A Lavanderia Tidewater usa uma para enviar as confirmações de coleta de amanhã aos quarenta clientes da rota de terça-feira.
Antes de começar, você precisa de:
- Um número de WhatsApp conectado em /channels.
- Pelo menos um modelo nesse número que a Meta tenha aprovado, já sincronizado — veja como trazer seus modelos.
- Contatos que tenham um número de WhatsApp, não só um número de telefone.
Tudo o que uma campanha envia é um modelo. Se você ainda não leu quando o WhatsApp precisa de um modelo, leia primeiro — principalmente a parte sobre modelos de marketing.
Abra o editor
Vá em /campaigns, clique em Nova campanha e escolha o cartão WhatsApp — “Envie um modelo aprovado para sua lista de contatos”. O rascunho é salvo conforme você avança.
Uma campanha do WhatsApp tem sete seções, nesta ordem:
Nome → Remetente → Destinatários → Modelo → Variáveis → Agendamento → Configurações avançadas
Não há missão, nem agente, nem seção de Dialog Insight — isso é para campanhas de voz.
Remetente
“Escolha o canal de WhatsApp que vai enviar esta campanha.” Só canais de WhatsApp são listados. Um que a Meta ainda não terminou de aprovar aparece marcado (ainda não aprovado), e escolhê-lo mostra ”… ainda não está pronto para enviar.”
Escolha o remetente primeiro. A lista de modelos abaixo é por número: ela só mostra os modelos sincronizados com o número que você escolher aqui.
Depois de escolher um número, pode aparecer uma linha azul começando com “Este número envia até …” — o limite de envio desse número, e quanto tempo sua lista vai levar nesse ritmo. Com que rapidez um número pode enviar explica os números.
Destinatários
As seis fontes são as mesmas de qualquer campanha — Lista salva, Segmento, Por etiqueta, Envio de CSV, Linhas rápidas, Entrada mágica. O que importa para o WhatsApp é qual número cada pessoa tem.
Uma campanha envia para o número de WhatsApp do contato. Ao importar um CSV, mapeie a coluna para WhatsApp, não para Telefone de SMS nem Telefone de voz. Um contato que só tem número de SMS ou de voz fica de fora.
Duas coisas que a lista faz sem avisar:
- Quem está na lista de não contatar fica de fora no lançamento, e é verificado de novo logo antes de cada envio — quem cancela o recebimento no meio da campanha é pulado.
- Uma mensagem por número. Dois contatos que compartilham um número de WhatsApp recebem uma mensagem, não duas.
Quantas pessoas de fato podem receber a mensagem no WhatsApp aparece na prévia de Variáveis, abaixo.
Uma campanha resolve no máximo 10.000 destinatários. Uma lista maior é recusada no lançamento — divida-a.
Modelo
“Só é possível enviar modelos aprovados. A lista se limita ao canal do WhatsApp que você escolheu em Remetente.”
Cada linha mostra o nome do modelo, o idioma e a categoria, com a primeira linha do corpo. Escolha um e um cartão abaixo mostra o modelo inteiro — cabeçalho, corpo, rodapé, botões — com as variáveis destacadas.
Se a lista estiver vazia — “Não há modelos aprovados para este canal.” —, clique em Ir para Modelos, sincronize e volte.
Atenção à categoria. Parte da lista não vai receber um modelo de marketing (por quê); essas linhas terminam como Com falha.
Escolha um modelo com cabeçalho de texto, ou sem cabeçalho. Uma campanha não consegue fornecer a imagem, o vídeo ou o documento de que um cabeçalho de mídia precisa, e o editor avisa: “Cabeçalhos de mídia (image) em breve — por enquanto, a mídia deste modelo precisa ser enviada a cada disparo. Por ora, use um modelo com cabeçalho de texto para iniciar esta campanha.”
Variáveis
“Vincule cada marcador do corpo do modelo a um campo de contato ou a um valor fixo.” Há uma linha por variável, agrupadas em Cabeçalho, Corpo e Botões. O menu Escolher origem… de cada linha oferece:
| Origem | Preenche a variável com |
|---|---|
| Campo de contato: nome (primeira palavra) | A primeira palavra do nome do contato |
| Campo de contato: nome (sobrenome) | Tudo depois da primeira palavra |
| Campo de contato: e-mail | O e-mail do contato |
| Campo de contato: telefone | O número de WhatsApp dele |
| Atributo personalizado: … | Um dos seus campos de contato personalizados, por exemplo um horário de coleta |
| Valor fixo… | O mesmo texto para todos |
O modelo pickup_confirmation da Lavanderia Tidewater,
Olá {{1}}, sua coleta está confirmada para {{2}}. Responda aqui se quiser mudar.,
mapeia {{1}} para nome (primeira palavra) e {{2}} para um atributo
personalizado com o horário de cada cliente. Variáveis nomeadas como
{{customer_name}} funcionam do mesmo jeito.
Botões:
- Um botão de link cuja URL termina numa variável ganha uma linha — mapeie-a, por exemplo, para o número do pedido.
- Um botão de copiar código ganha uma linha para o próprio código. A promoção
o mapeia para Valor fixo…
FRESH20; um código por pessoa vem de um atributo personalizado. - Botões de resposta rápida e links fixos não precisam de nada.
Uma variável sem mapeamento é enviada como valor vazio, que a Meta provavelmente vai recusar — essas linhas terminam como Com falha. Nada impede o lançamento; a prévia é onde você vê a lacuna.
Leia a prévia
Abaixo das variáveis, Prévia — “Corpo renderizado para os primeiros contatos do seu público.” — mostra a mensagem para até três contatos reais, com cabeçalho, corpo, link e código preenchidos.
Acima das amostras fica a linha que importa:
4 elegíveis / 5 no total · 1 ignorados (sem WhatsApp). O primeiro número é quem
de fato vai receber uma mensagem. A lista de não contatar é aplicada no
lançamento, então o número final pode ser ainda menor.
A prévia precisa de uma lista salva ou um segmento em Destinatários; ela lê o primeiro que encontrar.
Montando a campanha com o Octo? O Octo roda a mesma prévia —
preview_whatsapp_campaign — antes de criar qualquer coisa: o número de
elegíveis, o de ignorados e amostras renderizadas. Ele não cria uma campanha com
um modelo que não esteja aprovado.
Agendamento
O padrão é Enviar imediatamente — “A campanha é despachada assim que você clica em Iniciar.”
Se não, defina Data de início, Dias permitidos, Hora de início /
Hora de término e Fuso horário — digite como no exemplo do campo,
America/New_York, para onde seus clientes estão. Fora da janela a campanha
espera: ela aparece em andamento sem enviar nada até a janela abrir.
Lançar
Clique em Iniciar →. Ele fica desabilitado até a campanha ter nome, remetente, destinatários e modelo.
Na primeira campanha de saída do espaço de trabalho, de qualquer tipo, você precisa confirmar os termos de Conformidade de contato de saída. A parte do WhatsApp pede que você colete um consentimento que o WhatsApp reconheça, use modelos aprovados na categoria certa e respeite sinais de bloqueio e de cancelamento. Marque a caixa e clique em Aceitar e lançar — isso exige um proprietário ou administrador, e é pedido uma vez por espaço de trabalho.
Depois leia o aviso:
- “Campanha iniciada.” — enviando, ou esperando a janela.
- “A campanha não tinha destinatários elegíveis — foi marcada como concluída sem despacho.” — ninguém da lista pôde ser alcançado no WhatsApp.
O que acontece com cada pessoa
Abra a campanha em /campaigns. No topo aparecem Enviada, Entregue, Lida, Com falha e Respondeu. Cada linha é uma pessoa, com uma coluna Status de entrega e outra Respondeu:
| A linha mostra | Significado |
|---|---|
| Pendente | Ainda não enviada |
| Enviada | A Meta aceitou |
| Entregue / Lida | A Meta informou que chegou ao telefone / foi aberta |
| Com falha | A Meta recusou, ou informou que não foi entregue — inclusive um modelo de marketing que a Meta decidiu não entregar |
| Ignorada | Cancelou o recebimento, ou não tinha número de WhatsApp, quando chegou a vez dela |
| Respondeu · … | A pessoa respondeu em até 7 dias após o envio |
Toda mensagem também aparece em /conversations, na conversa de WhatsApp desse cliente no número remetente. Uma resposta abre a janela de 24 horas, e dali em diante é uma conversa normal.
Pausar e Retomar ficam na página da campanha.
Ritmo de envio
Uma campanha tem ritmo por número remetente, e quando atinge o limite desse número ela espera — nada é marcado como falha por ir rápido demais. Duas campanhas no mesmo número dividem a mesma cota, então a segunda deixa a primeira mais lenta. Os números, e como ver os seus, estão em com que rapidez um número pode enviar.
O que uma campanha do WhatsApp não faz
- Enviar texto livre. Só modelos, só aprovados, naquele único número.
- Enviar um cabeçalho de mídia. Cabeçalhos de texto ou nenhum, por enquanto.
Para onde ir depois
- Enviar um modelo a partir de uma conversa — uma pessoa, pela caixa de entrada.
- Pedir ao Octo para enviar um modelo.
- Enviar um modelo do seu próprio sistema — a API.
- Com que rapidez um número pode enviar.