Templates Oficiais (WhatsApp API)
Templates são mensagens pré-aprovadas pela Meta que permitem iniciar ou retomar conversas fora da janela de 24 horas. São obrigatórios para qualquer envio ativo via WhatsApp API Oficial.
Exclusivo para API Oficial
Templates só funcionam em conexões do tipo WhatsApp API Oficial (WABA).
Conexões via QR Code (Baileys/wppconnect) não suportam templates.
Veja Conexões WhatsApp para configurar uma conexão oficial.
Por que templates existem?
O WhatsApp impõe uma regra de janela de atendimento:
| Situação | Pode enviar? | O que enviar? |
|---|---|---|
| Cliente enviou mensagem há menos de 24h | Sim | Qualquer mensagem livre |
| Última mensagem do cliente foi há mais de 24h | Somente via template | Template aprovado pelo Meta |
| Cliente nunca falou com você | Somente via template | Template aprovado pelo Meta |
Categorias de template
| Categoria | Uso típico | Custo |
|---|---|---|
| UTILITY | Confirmação de pedido, boleto, aviso de entrega, lembrete de agendamento | Mais barato |
| MARKETING | Promoções, ofertas, campanhas, novidades | Mais caro |
| AUTHENTICATION | Código de verificação (OTP) | Preço fixo |
Escolha a categoria correta
A Meta analisa o conteúdo do template e pode rejeitar se a categoria não condizer com o texto.
Templates de UTILITY têm aprovação mais rápida e custo menor — use sempre que possível.
Como criar e aprovar um template no Meta
1
Acesse o Meta Business Suite
Vá em business.facebook.com → selecione sua conta → menu lateral
WhatsApp Manager → Gerenciar templates.
2
Clique em "Criar template"
Defina:
- Categoria — UTILITY, MARKETING ou AUTHENTICATION
- Nome — apenas letras minúsculas, números e underscore (ex.:
confirmacao_pedido) - Idioma — Português (Brasil) =
pt_BR
3
Monte o conteúdo do template
- Cabeçalho (opcional) — texto fixo, imagem, vídeo ou documento
- Corpo — texto principal. Use
{{1}},{{2}}, etc. para variáveis dinâmicas - Rodapé (opcional) — texto fixo menor, ex.: "Não responda a este número"
- Botões (opcional) — ação rápida (resposta) ou link externo
Exemplo de corpo:
Olá {{1}}, seu pedido {{2}} foi confirmado e chegará em {{3}}. Obrigado!4
Submeta para aprovação
Clique em Enviar. O status inicial será
PENDING.
A Meta analisa em minutos a alguns dias. Você será notificado por e-mail quando aprovado.
5
Aguarde o status APPROVED
Somente templates com status
APPROVED podem ser enviados.
Se for rejeitado (REJECTED), corrija o conteúdo e resubmeta.
Como usar templates no WhatsBlast
1. Sincronizar templates na conexão
Após aprovação no Meta, importe os templates para o WhatsBlast:
- Vá em Conexões no menu lateral
- Localize sua conexão de API Oficial
- Clique no botão ↻ (sincronizar templates) na linha da conexão
- Os templates aprovados aparecem na aba Templates (Meta) da conexão
Sincronize sempre que criar novos templates
O WhatsBlast não importa automaticamente. Toda vez que adicionar ou editar templates no Meta,
clique em sincronizar para atualizar a lista local.
2. Enviar template em um atendimento
Dentro de um ticket (atendimento) de canal API Oficial, quando a janela de 24h estiver fechada:
- Abra o ticket do cliente
- Clique no ícone de template na barra de digitação
- Selecione o template desejado na lista
- Preencha os valores das variáveis
{{1}},{{2}}, etc. - Clique em Enviar
Usar templates em campanhas oficiais
Para enviar o mesmo template a uma lista de contatos, acesse Campanhas, abra a aba API oficial e selecione a conexão, a categoria e o template aprovado. Preencha as variáveis, envie a mídia de cabeçalho quando exigida e confira a prévia.
Veja o passo a passo em Campanha pela API Oficial.
API externa
O envio de template atualmente é realizado pelo ticket ou pela campanha dentro do painel.
Ele não faz parte dos endpoints externos por token descritos em
API de Mensagens.
Status dos templates
| Status | Significado | Pode enviar? |
|---|---|---|
APPROVED | Aprovado pela Meta | Sim |
PENDING | Aguardando análise da Meta | Não |
REJECTED | Rejeitado pela Meta | Não — corrija e resubmeta |
DISABLED | Desativado (muitas denúncias) | Não |
PAUSED | Pausado temporariamente pela Meta | Não |
Boas práticas
- Use templates de UTILITY sempre que possível — aprovação mais rápida e custo menor
- Não inclua URLs encurtadas (bit.ly, etc.) — aumenta chance de rejeição
- Evite linguagem muito comercial em templates UTILITY — pode ser rejeitado ou reclassificado
- Sincronize a lista de templates após qualquer alteração no Meta Business Suite
- Monitore o status dos templates regularmente — um template com muitas denúncias pode ser pausado automaticamente
- Mantenha variáveis simples e com contexto claro para o cliente
Atenção com templates de MARKETING
Clientes podem optar por não receber mensagens de marketing no WhatsApp.
Nesses casos, o envio é bloqueado automaticamente pela Meta mesmo com template aprovado.
Respeite sempre o consentimento do contato.