Saltar para o conteúdo principal
Um template é uma mensagem pré-aprovada pela Meta. É o único tipo de mensagem que você pode enviar quando a janela de 24 horas está fechada — ou seja, quando o contato não escreveu para você nas últimas 24 horas. Enquanto a janela está aberta você pode enviar texto livre; uma vez fechada, apenas um template chega ao cliente.
Os templates são criados e aprovados no dashboard. A API pública apenas os consome para enviar — não os cria nem os edita.

​
Como um template é resolvido

1

Identifique o template pelo nome

Um template é identificado pelo seu template_name — o mesmo nome que você vê no dashboard e que reporta à Meta.
2

Especifique o idioma se for necessário

Se o mesmo nome estiver aprovado em vários idiomas, adicione language (formato Meta lower_UPPER, ex. pt_BR) para escolher qual enviar. Se só existir em um idioma, é opcional.
3

Verifique que esteja aprovado

Só é possível enviar templates com status APPROVED. Um em PENDING ou REJECTED não é enviável.

​
Componentes de um template

Ao enviar um template você preenche suas partes dinâmicas:

body_variables

Os placeholders do corpo ({{1}}, {{2}}, …). Array de objetos { index, value }.

header

O cabeçalho: texto, ou mídia via file_uuid.

button_parameters

Parâmetros de botões dinâmicos (ex. o sufixo de um botão URL).

​
Enviar um template

Um envio típico, com duas variáveis no corpo:
Para descobrir quais templates você tem disponíveis e quais variáveis cada um espera, consulte os endpoints de catálogo de templates na Referência da API.

​
Templates de teste para conversas tester

O dashboard permite criar templates de teste (status: FAKE) a partir do módulo Tester sem passar pela aprovação da Meta. Existem para que o operador e os integradores testem fluxos contra conversas tester sem esperar a revisão da Meta. Regras de envio via API pública:
  • Conversa tester (is_tester: true em GET /conversations) — você pode enviar tanto templates APPROVED quanto templates FAKE. O envio replica o fluxo real mas não toca a Meta (wamid retorna "").
  • Conversa real (is_tester: false) — somente templates APPROVED. Se você tentar enviar um template FAKE ou um template com is_tester: true para uma conversa real, a API responde com TEMPLATE_FAKE_REQUIRES_TESTER_CONVERSATION (422).
O catálogo público (GET /templates e GET /templates/{name}/{language}) não inclui templates FAKE — apenas os APPROVED reais. Se você precisa do nome de um template FAKE para enviá-lo, pergunte ao operador.

​
Próximos passos

Enviar mensagens

O envio de templates, texto, mídia e quick replies.

Conversas

A janela de 24 horas e o estado de uma conversa.