Skip to main content
WhatsApp não é email. Envio para quem não pediu gera bloqueio e denúncia, e isso derruba a qualidade do número. Esta página resume o que importa para rodar campanhas de marketing com a Arara.

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

O corpo é uma lista. 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-test traz vencedora, pValue, relativeLiftPct e as métricas de cada variante.
  • POST /v1/campaigns/{campaignId}/ab-test/winner com { "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.