Skip to main content
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 — nos canais da API 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

Nos canais da API Oficial, só templates Aprovados podem ser enviados via API ou agendamento. Nos canais WhatsApp Business (QR Code), 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 do canal

Criar um template

Galeria de modelos de template de WhatsApp com Em branco, Boas-vindas e Oferta por tempo limitado

Começar por um modelo

1

Novo template

Em Conversas → Templates, clique em Novo template e escolha Mensagem (WhatsApp). Comece Em branco ou de um modelo.
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

  • Criar template — fica disponível para uso
  • Enviar para aprovação — canais da API Oficial: envia para a Meta aprovar

Sincronizar com a Meta

Nos canais da API Oficial, o botão Sincronizar na lista de templates:
  • Importa templates já aprovados em outras ferramentas
  • Atualiza status de templates submetidos (Pendente → Aprovado/Rejeitado)
Sincronize depois de cada envio para acompanhar a aprovação sem abrir o gerenciador da Meta.

Enviar via API

Use o endpoint dedicado, que funciona nos dois tipos de canal (API Oficial ou WhatsApp 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.

Outras ações na lista

No menu de cada template: Editar, Duplicar, Reenviar à Meta, Converter em posicional / Converter em named, Replicar para canais (copia para outros canais da organização), Copiar ID e Excluir.
Excluir um template faz as automações que usam ele pararem de funcionar.

Templates de e-mail

Os templates de e-mail ficam em Disparos → E-mail → Templates, com temas, marca da organização, peças prontas e revisão. Veja Templates de e-mail.