Skip to main content

​
Templates

Templates são modelos de mensagem reutilizáveis. Eles servem para dois propósitos:
  1. Operação manual — operadores inserem rapidamente respostas padronizadas no Chat.
  2. Envio fora da janela de 24h — em instâncias Meta Oficial, é a única forma de iniciar conversa com um contato que não falou com você nas últimas 24h. Para isso o template precisa estar aprovado pela Meta.

​
Estrutura de um template

Um template é composto por até 4 blocos:

​
Cabeçalho

Pode ser texto ou mídia (apenas um por template):
  • TEXT — até 60 caracteres, com no máximo 1 variável posicional ou nomeada
  • IMAGE — JPG, PNG (até 5 MB)
  • VIDEO — MP4, 3GPP (até 16 MB)
  • DOCUMENT — PDF (até 100 MB)
Para cabeçalhos de mídia, no momento do envio você passa a URL pública do arquivo.

​
Corpo

O texto principal. Pode ter quantas variáveis quiser, desde que respeite o formato escolhido (POSITIONAL ou NAMED — veja abaixo).

​
Rodapé

Texto curto, sempre estático — sem variáveis. Útil para assinatura, disclaimers ou aviso de opt-out.

​
Botões

Até 3 botões por template, dos seguintes tipos:

​
Status do template

Em instâncias Meta Oficial, só templates Aprovados podem ser enviados via API ou agendamento. Em instâncias WhatsApp Business (API), o template é enviado como texto livre — não há aprovação.

​
Categorias

A categoria afeta o custo por conversa cobrado pela Meta e as políticas de aprovação.

​
Variáveis: POSITIONAL vs NAMED

A Meta aceita dois formatos de variáveis — você escolhe um e não pode misturar:

​
POSITIONAL ({{1}}, {{2}}, {{3}})

Variáveis numeradas pela ordem de aparição. Útil para templates simples.
No envio, mande variables: { "1": "João", "2": "12345" }.

​
NAMED ({{nome}}, {{pedido}})

Variáveis com nomes descritivos — mais legível e mais robusto a alterações.
No envio, mande variables: { "nome": "João", "pedido": "12345" }.
A Meta rejeita templates que misturam {{1}} com {{nome}}. O builder do Brainchat detecta o formato automaticamente e mostra um aviso se houver mistura.

​
Variáveis nativas (auto-preenchidas)

Algumas variáveis são preenchidas automaticamente a partir do contato — você não precisa enviá-las (mas pode sobrescrever):
  • nome — contacts.name
  • telefone — contacts.phone
  • Outros campos do contato disponíveis no escopo da instância

​
Criar um template

1

Novo template

Em Templates, clique em Novo Template.
2

Informações básicas

  • Nome — identificador interno (ex: confirmacao_agendamento)
  • Categoria — Utilidade, Marketing ou Autenticação
  • Idioma — pt_BR, en_US, etc.
3

Montar conteúdo

Adicione cabeçalho (texto ou mídia), escreva o corpo, opcionalmente rodapé e botões. O preview mostra como ficará no celular do contato.
4

Salvar ou enviar para aprovação

  • Salvar como rascunho — fica disponível só na sua conta
  • Enviar para Meta — instâncias Meta Oficial: dispara aprovação

​
Sincronizar com Meta

Em instâncias Meta Oficial, o botão Sincronizar com Meta na lista de templates:
  • Importa templates já aprovados em outras ferramentas
  • Atualiza status de templates submetidos (Pendente → Aprovado/Rejeitado)
  • Re-vincula meta_template_id se a Meta tiver migrado IDs
Sincronize após cada submissão para acompanhar a aprovação sem precisar abrir o Business Manager.

​
Enviar via API

Use o endpoint dedicado, que detecta automaticamente o provedor da instância (Meta Oficial ou API Business): POST /send-template-message → Cabeçalho estático, rodapé e botões fixos vão automaticamente — você só passa as variáveis dinâmicas no campo variables.