> ## Documentation Index > Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt > Use this file to discover all available pages before exploring further. # Templates > Crie, sincronize com a Meta e envie templates de mensagem WhatsApp — cabeçalho, corpo, rodapé, botões e variáveis. 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: | Bloco | Obrigatório | Limite | Aceita variáveis? | | - | - | - | - | | **Cabeçalho** | Não | 60 caracteres (texto) | Sim — 1 variável (texto) ou mídia | | **Corpo** | **Sim** | 1024 caracteres | Sim — múltiplas variáveis | | **Rodapé** | Não | 60 caracteres | **Não** | | **Botões** | Não | até 3 botões | Sim — apenas em URL com `{{1}}` no final | ### 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: | Tipo | O que faz | Variável? | | - | - | - | | **QUICK\_REPLY** | Resposta rápida pré-definida que o contato envia ao tocar | Não | | **URL** | Abre um link no navegador | **Sim** — apenas se o link terminar em `{{1}}` (sufixo dinâmico) | | **PHONE\_NUMBER** | Disca um número | Não | *** ## Status do template | Status | Significado | | - | - | | **Rascunho** | Salvo localmente, ainda não enviado para aprovação | | **Pendente** | Aguardando análise da Meta (de minutos até 24h) | | **Aprovado** | Pronto para uso — pode ser enviado fora da janela 24h | | **Pausado** | Suspenso pela Meta após queda de qualidade — corrija e ressubmeta | | **Rejeitado** | Recusado — ajuste o conteúdo e reenvie | > [!NOTE] > > 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 | Categoria | Quando usar | | - | - | | **Utilidade** | Notificações transacionais: confirmações, atualizações de pedido, lembretes | | **Marketing** | Promoções, ofertas, comunicação de produtos | | **Autenticação** | Códigos de verificação, OTP, senhas temporárias | 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. ``` Olá, {{1}}! Seu pedido {{2}} foi confirmado. ``` 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. ``` Olá, {{nome}}! Seu pedido {{pedido}} foi confirmado. ``` No envio, mande `variables: { "nome": "João", "pedido": "12345" }`. > [!WARNING] > > 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](https://mintcdn.com/stegia/2sx_YUniIgU9qCdN/images/atendimento/template-modelos.png?fit=max\&auto=format\&n=2sx_YUniIgU9qCdN\&q=85\&s=e716f59c2d4a3ec62d1a06358e4ae8d1) 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) > [!TIP] > > 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 →**](https://docs.brainchat.app/api/enviar-template.md) 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**. > [!WARNING] > > 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](https://docs.brainchat.app/atendimento/templates-email.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.