Skip to main content

O que são templates?

Na API oficial do WhatsApp, você só pode enviar mensagens livremente enquanto a janela de conversa de 24 horas estiver aberta (ou seja, quando o cliente enviou uma mensagem para você recentemente). Fora dessa janela, a única forma de iniciar uma conversa é através de templates — mensagens pré-definidas que passam por aprovação da Meta antes de poderem ser enviadas.

Categorias

Cada template precisa de uma categoria que define o tipo de comunicação. Escolher a categoria errada pode fazer seu template ser reprovado pela Meta.

Estrutura de um template

Todo template é composto por components. Cada componente tem um papel:

Placeholders

Você pode usar variáveis dinâmicas no texto com {{1}}, {{2}}, etc. Ao criar o template, é obrigatório enviar exemplos reais para cada placeholder — a Meta usa esses exemplos na revisão.

Fluxo de template

A API organiza templates por business (WABA — WhatsApp Business Account). Cada business tem seus próprios templates, histórico de aprovação e limites.
1

Identifique seu WABA

Use o endpoint de listar WABAs para obter o businessId correto para o seu token.
2

Crie o template

Escolha a categoria, monte os components com placeholders e exemplos, e envie para aprovação.
3

Aguarde a aprovação

A Meta revisa o template e retorna um status: PENDING, APPROVED ou REJECTED.
4

Envie mensagens

Com o template aprovado, você pode usá-lo para iniciar conversas com clientes fora da janela de 24h.

Status do template