Templates Oficiais (WhatsApp API)

Envie mensagens ativas para clientes usando templates aprovados pelo Meta.

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

Acesse o Meta Business Suite Vá em business.facebook.com → selecione sua conta → menu lateral WhatsApp Manager → Gerenciar templates.

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

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!

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.

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

Usando templates via API da plataforma

Você pode enviar templates programaticamente pela API do WhatsBlast. Veja a documentação completa em API de Mensagens.

Listar templates disponíveis para um ticket

GET /api/messages/template-options/:ticketId

Headers:
  Authorization: Bearer SEU_TOKEN

Enviar template

POST /api/messages/template/:ticketId

Headers:
  Authorization: Bearer SEU_TOKEN
  Content-Type: application/json

Body:
{
  "templateIdMeta": "ID_DO_TEMPLATE_NA_META",
  "languageCode": "pt_BR",
  "bodyVariables": ["valor do {{1}}", "valor do {{2}}"]
}

Campo	Obrigatório	Descrição
`templateIdMeta`	Sim	ID do template na Meta (visível na aba Templates da conexão)
`languageCode`	Não	Código do idioma (ex.: `pt_BR`). Se omitido, usa o idioma salvo no template.
`bodyVariables`	Condicional	Array com os valores para preencher `{{1}}`, `{{2}}`, etc., na ordem. Obrigatório se o template tiver variáveis.
`components`	Não	Array completo de componentes (para templates com header de imagem, botões, etc.). Substitui o `bodyVariables` quando informado.

Exemplo com header de imagem e botão

POST /api/messages/template/:ticketId

{
  "templateIdMeta": "123456789",
  "languageCode": "pt_BR",
  "components": [
    {
      "type": "header",
      "parameters": [
        { "type": "image", "image": { "link": "https://exemplo.com/banner.jpg" } }
      ]
    },
    {
      "type": "body",
      "parameters": [
        { "type": "text", "text": "João" },
        { "type": "text", "text": "pedido #1234" }
      ]
    }
  ]
}

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.