As 3 regras
1
Opt-in real
O cliente precisa ter aceitado receber mensagens da sua marca. Respeite quem pediu para sair: números em opt-out (
/v1/opt-outs) não recebem envio. Ver Compliance e Política de templates.2
Template aprovado fora da janela
Fora da janela de 24h (cliente não falou com você nas últimas 24h), só template aprovado pela Meta. Texto livre fora da janela é recusado pela API. Ver Templates e Janela de 24h.
3
Categoria certa
Promoção, oferta e reengajamento são MARKETING. Aviso transacional real (pedido confirmado, pagamento, entrega) é UTILITY. Template de marketing tem custo maior na Meta, sofre limite de frequência por destinatário e pesa mais na qualidade do número. Use UTILITY quando o conteúdo for de fato transacional.
Custo
A cobrança é por mensagem e depende da categoria do template e do seu plano. Consulte os valores vigentes no dashboard e em Preços. Antes de criar a campanha,GET /v1/campaigns/estimate (ou POST com a lista) devolve a estimativa da campanha.
O tier do número (limite de destinatários únicos por dia) é definido pela Meta e limita quantas conversas você inicia, não o preço.
Fluxo recomendado
Templates
Como criar, categorizar e aprovar.
API de campanhas
API de envio em massa.
Receita: Black Friday
Campanha completa com teste A/B.
Contatos
name e phone (E.164) são obrigatórios; email e attributes são opcionais. O uso de contatos depende do plano.
A campanha não filtra por atributo: você seleciona o público fora da Arara e passa a lista em contacts no POST /v1/campaigns.
Frequência
Template de marketing sofre limite de frequência por destinatário na Meta, e excesso de mensagens vira bloqueio e denúncia.- Envie só para quem tem opt-in recente.
- Envie em horário comercial.
- Não repita a mesma oferta para a mesma pessoa em sequência.
Segmentação que funciona
- Comportamento: quem comprou nos últimos 30 dias, quem abandonou carrinho.
- Localização: oferta de loja física só para região atendida.
- Valor do cliente: clientes de maior valor recebem atendimento humano; o restante recebe template.
- Horário: mensagem de madrugada vira bloqueio.
Teste A/B
O A/B vai junto na criação da campanha.templateName é a variante A e abTest.variantBTemplateName é a B:
CLICKED conta cliques nos links curtos das mensagens (botão SMART_LINK ou URL em variável). CONVERTED conta conversões reportadas.
Resultado e controle manual:
GET /v1/campaigns/{campaignId}/ab-testtraz vencedora,pValue,relativeLiftPcte as métricas de cada variante.POST /v1/campaigns/{campaignId}/ab-test/winnercom{ "winner": "A" }força a vencedora.
POST /v1/campaigns exige o header Idempotency-Key e um número conectado.
Medindo resultado
Links de mensagem saem como links curtos que registram cada clique, e a venda é ligada à mensagem quando o seu backend reporta a conversão. O que é um Smart Link e como usar está em Smart Links. Para reportar vendas, veja Atribuição de conversão.Quando não usar marketing no WhatsApp
- Comunicação genérica para a base inteira, sem segmentação.
- Oferta de ticket muito baixo, em que o custo por mensagem come a margem.
- Base inativa há meses sem opt-in recente. O risco de bloqueio e denúncia é alto.
- Cobrança de inadimplência como MARKETING. Aviso de fatura é UTILITY.
Próximos passos
Smart Links
Link curto com contagem de cliques.
Política de templates
O que evitar e qual categoria escolher.