O que são templates WABA
Resumo: Templates são mensagens pré-aprovadas pela Meta que você usa para iniciar conversas com clientes pelo WhatsApp Business. Sem template, você só pode responder quem te mandou mensagem nas últimas 24 horas.
Quando usar isso
Sempre que precisar dar o primeiro passo numa conversa pelo WhatsApp Business:
- Confirmação de agendamento ("Olá Maria, sua consulta está marcada para terça 14h")
- Lembrete de pagamento ("Sua fatura vence amanhã, R$ 150,00")
- Boas-vindas a novo cliente
- Notificação de status ("Seu pedido foi enviado, código BR123")
- Pesquisa de satisfação ("Como foi seu atendimento? Responda de 1 a 5")
- Campanha de marketing (promoções)
Se você é só Baileys (WhatsApp comum), você não usa templates. A regra dos 24h só se aplica a WABA.
Por que existe essa restrição?
A Meta criou os templates como um mecanismo anti-spam. Antes deles, qualquer empresa podia mandar mensagem proativa para qualquer número (causando aluvião de marketing). Com templates:
- Cada modelo de mensagem é revisado antes pela Meta.
- Você só pode mandar texto pré-aprovado.
- A Meta consegue bloquear empresas que abusam.
Por isso, o WhatsApp Business é mais limpo de spam do que SMS, por exemplo.
A janela de 24 horas
Esta é a regra-chave:
💡 Regra de ouro: Após o cliente te mandar uma mensagem, você tem 24 horas para responder com mensagem livre (qualquer texto, imagem, etc.). Após 24h sem nova mensagem do cliente, a janela fecha. A próxima mensagem que você for enviar precisa ser um template.
A janela reabre toda vez que o cliente manda uma nova mensagem.
ℹ️ Saiba mais: Tecnicamente, isso se chama "Customer Service Window" ou "Service Conversation Window". A Meta documenta como
business_initiated(template, fora da janela) vsuser_initiated(texto livre, dentro da janela).
Anatomia de um template
Um template tem peças:
| Componente | O que é | Obrigatório? |
|---|---|---|
| Nome | Identificador interno (ex.: confirmacao_consulta) | Sim |
| Idioma | pt_BR, en_US, etc. | Sim |
| Categoria | MARKETING, UTILITY ou AUTHENTICATION | Sim |
| Header | Topo: pode ser texto, imagem, vídeo, documento ou localização | Não |
| Body | Texto principal (até 1024 caracteres) com variáveis {{1}}, {{2}}, etc. | Sim |
| Footer | Rodapé fixo (texto curto) | Não |
| Buttons | Até 10 botões (Reply rápido, abrir URL, ligar) | Não |
Variáveis (placeholders)
Você pode colocar variáveis no body que são preenchidas na hora do envio:
Olá {{1}}, sua consulta com Dr. {{2}}
está confirmada para {{3}}.
Na hora de enviar, você passa os valores: ["Maria", "Carlos", "terça às 14h"]. O cliente vê:
Olá Maria, sua consulta com Dr. Carlos está confirmada para terça às 14h.
Isso permite personalização sem precisar criar um template novo para cada cliente.
Tipos de botões em template
| Tipo | O que faz |
|---|---|
| QUICK_REPLY | Resposta rápida (cliente clica e a palavra vira mensagem) |
| URL | Abre um link (pode ter {{1}} na URL para link personalizado) |
| PHONE_NUMBER | Liga para um número quando clicado |
| COPY_CODE | Botão "Copiar código" — útil para códigos OTP, cupons |
| OTP | Específico para códigos de autenticação (segurança) |
| CATALOG / MPM / SPM | Para e-commerce (catálogo, multi-produto, produto único) |
| FLOW | Abre um formulário interativo (WhatsApp Flow) |
Aprovação pela Meta
Quando você cria um template, ele entra em estado DRAFT (rascunho) e é submetido para aprovação:
- APPROVED: Pode ser usado para envios.
- PENDING: Em análise pela Meta (~ 1 minuto a 24 horas).
- REJECTED: Rejeitado — veja o motivo e ajuste.
- PAUSED: Pausado pela Meta (geralmente por baixa qualidade — muitos clientes marcaram como spam).
- DISABLED: Desabilitado permanentemente.
Veja Template rejeitado pela Meta para o que fazer em caso de rejeição.
Dúvidas comuns
Posso criar quantos templates quiser? A Meta tem um limite de cerca de 250 templates por conta WABA. Templates rejeitados não contam contra o limite, mas templates aprovados que você não usa, sim.
Quanto custa enviar um template? Cobrança da Meta varia por categoria e país. Para Brasil, em maio/2026, a tabela está em torno de:
- Marketing: R$ 0,30-0,50 por conversa
- Utility: R$ 0,10-0,20 por conversa
- Authentication: R$ 0,05-0,10 por conversa
- Service (resposta dentro da janela 24h): grátis após uma franquia mensal
(Valores podem mudar — sempre veja a tabela atual no Meta Business Pricing.)
O cliente sabe que recebeu um template? Visualmente é igual a uma mensagem comum — texto, imagem, botões. O cliente não vê "isto é um template".
Posso editar um template já aprovado? Sim, mas a edição volta para análise (status PENDING) e até ser reaprovado, você usa a versão antiga.