OTP, pedido, boleto, agendamento. Disparado pelo seu backend, entregue em segundos, sem opt-in obrigatório, com webhook de status.
Trigger lab · ao vivoClica num gatilho.
Vê a mensagem chegar.
5 cenários típicos de backend. Cada um dispara um template aprovado pela Meta. O celular ao lado mostra o que o cliente recebe.
// stripe webhook handler
if (event.type === 'checkout.session.completed') {
await arara.messages.send({
to: session.customer.phone,
template: 'pedido_confirmado',
variables: {
nome: session.customer.name,
pedido: session.id,
valor: formatBRL(session.amount_total),
},
}, { idempotencyKey: `stripe:${event.id}` })
}Casos típicos6 templates que cobrem
80% do que rola.
pedido_confirmadoCompra fechou → cliente recebe número do pedido, valor e prazo. Reduz absurdamente o volume no SAC.
pedido_em_transitoTransportadora pegou → notifica com código de rastreio. Cliente para de ligar pedindo update.
codigo_otpLogin/2FA → código de 6 dígitos com validade. Entregabilidade muito maior que SMS.
pagamento_recusadoFalha no cartão → link pra atualizar e pagar. Recupera tentativa que ia virar churn.
boleto_vence_hojeVencimento → lembrete + link/PIX. Cliente paga porque viu, não porque ficou negativado.
agendamento_confirmadoMédico, salão, contador → lembrete véspera. Faturamento direto, sem buraco na agenda.
EntregabilidadeCategoria utility
é a melhor entrega.
Templates utility têm entregabilidade alta porque a Meta entende que é informação que cliente esperou — não promoção. Por isso é a categoria mais barata e mais tolerante.
Por que não usar SMS pra confirmação? Porque WhatsApp tá em 99,2% dos celulares no Brasil — e o cliente abre.
SMS perde feio aqui.
Dúvidas que dev faz
antes de subir.
Mensagem transacional Meta exige template aprovado pra ser disparada fora da janela de 24h. É regra do WhatsApp, não nossa — qualquer plataforma oficial obriga. Templates aprovados têm taxa de entrega 99,8%+; free-form fica preso na janela de conversa.
Minutos a 4 horas. Templates utility passam por aprovação automatizada se seguirem a política (não vender, não promover, foco em transação). Marketing leva mais (até 48h). Auth (OTP) sai em minutos.
Sim, desde que seja resposta a uma ação que o cliente fez (comprou, agendou, recuperou senha). Meta considera customer-initiated. Mas você precisa ter o telefone como dado de contato legítimo (não pode comprar lista).
Webhook dispara message.failed com error code (NUMBER_DOES_NOT_EXIST, BLOCKED, etc). Você pode fallback pra SMS/email/push. SDK tem helper pra detectar.
Sim. Templates utility suportam header de imagem, vídeo, documento ou localização. Boleto pode anexar PDF direto. Pedido pode ter foto do produto. Tudo no mesmo POST.
Limite é o tier do seu número definido pela Meta (1k → 10k → 100k → ilimitado/dia). Tier sobe automaticamente conforme você manda com qualidade. Utility tem limite mais alto que marketing.
Primeira transacional, 5 minutos.
Cria a conta, escolhe um template pronto (pedido, OTP, boleto), dispara via API.