Skip to main content
Template é a mensagem pré-aprovada pela Meta que a empresa pode enviar a qualquer momento, inclusive para quem não escreveu nas últimas 24h. Fora da janela de 24h, é a única forma de iniciar ou retomar a conversa. Em documentação mais antiga você vai ver o nome HSM (Highly Structured Message). É a mesma coisa.

​
Por que template existe

A Meta limita a comunicação iniciada pela empresa para conter spam. Antes de enviar, você declara o conteúdo, escolhe a categoria e passa pela revisão da Meta. Aprovado, o template pode ser enviado quantas vezes precisar, respeitando opt-out e os limites do plano.

​
As 3 categorias

UTILITY

Algo que o cliente espera receber: pedido confirmado, cobrança, lembrete de consulta.

MARKETING

Promoção, oferta, lançamento, reativação da base. Exige consentimento para marketing.

AUTHENTICATION

Apenas código de verificação (OTP, 2FA).
Cada categoria tem uma tarifa Meta diferente, e MARKETING é a mais cara. Valores em Preços.
A Meta pode reclassificar um template depois de aprovado (por exemplo, de UTILITY para MARKETING). A partir daí ele custa como a nova categoria, e a Arara avisa pelo webhook template.category_changed.

​
Ciclo de vida

Só envia quem está APPROVED. Os outros status (PENDING, REJECTED, DISABLED e PAUSED) recusam o envio com 422. Mesmo aprovado, um template pode ser pausado pela Meta quando recebe muito feedback negativo (bloqueios e denúncias). Enquanto estiver pausado, o envio responde 422 TEMPLATE_PAUSED. Todos os status, códigos de erro e o que fazer em cada caso estão no guia Criar e aprovar um template.

​
Template ou mensagem dentro da janela

Enviar um template não abre a janela. Ela só abre quando o cliente responde.

​
Como é um template

Um template tem corpo (obrigatório) e, opcionalmente, cabeçalho de texto ou mídia, rodapé e botões. Os trechos que mudam a cada envio são variáveis, como {{1}} e {{2}}:
Também existe o formato carrossel, com vários cards de mídia e botões.

​
Onde criar

Você cria templates pelo Dashboard, pela API (POST /v1/templates) ou pelo MCP. Quem tem número conectado ainda pode partir da biblioteca de templates UTILITY da Meta, que já nascem aprovados.

​
Próximos passos

Criar e aprovar um template

Variáveis, mídia, botões, o que reprova e como corrigir.

Janela de 24h

Quando você pode dispensar o template.

API: Templates

Todos os endpoints de templates.