Como criar, aprovar e enviar template message no WhatsApp Cloud API

Se você está começando com a WhatsApp API Oficial e não sabe como criar ou enviar um Template Message, este guia vai cobrir tudo do zero. Desde a criação no Meta Business Manager, passando pelo processo de aprovação, até o envio via Cloud API com exemplos reais de JSON.

O Que São Templates de Mensagem e Por Que São Obrigatórios

Quando uma empresa usa a WhatsApp API Oficial para se comunicar com clientes, existem duas situações distintas:

• Dentro da janela de 24 horas: o cliente mandou mensagem primeiro, e a empresa pode responder livremente com qualquer texto durante as próximas 24h
• Fora da janela de 24 horas: a empresa quer iniciar uma conversa ou não houve mensagem recente do cliente — neste caso, só é permitido enviar Templates

Essa regra existe para proteger os usuários de spam. Se qualquer empresa pudesse enviar qualquer mensagem a qualquer momento, o WhatsApp rapidamente se tornaria inutilizável. Os Templates são mensagens pré-aprovadas pela Meta que garantem conteúdo legítimo, relevante e dentro das políticas do WhatsApp Business.

Existem três categorias de Templates: Marketing (promoções, campanhas, ofertas), Utilidade (confirmações, notificações de pedido, lembretes de consulta, cobranças) e Autenticação (OTPs, códigos de verificação). Cada categoria tem custos por conversa diferentes e regras específicas de conteúdo.

Passo a Passo: Como Criar um Template no Meta Business Manager

Para criar um Template Message, você precisa ter acesso ao Meta Business Manager e uma conta WhatsApp Business configurada. Veja o processo completo:

Passo 1: Acessar o gerenciador de templates

No Meta Business Manager (business.facebook.com), vá para: Conta do WhatsApp Business → Modelos de mensagem → Criar modelo. Se não encontrar essa opção, verifique se você tem permissão de administrador na conta.

Passo 2: Escolher a categoria

Selecione a categoria correta para o seu template:

• Marketing: para promoções, lançamentos, campanhas de engajamento, recuperação de carrinho
• Utilidade: para confirmações de pedido, lembretes de consulta, atualizações de entrega, avisos de cobrança
• Autenticação: exclusivamente para envio de OTPs e códigos de verificação de dois fatores

Atenção: classificar um template de Marketing como Utilidade para pagar menos por conversa é uma violação das políticas da Meta e pode resultar em reprovação ou suspensão da conta.

Passo 3: Escrever o conteúdo do template

O template é composto por: Cabeçalho (opcional: texto, imagem, vídeo ou documento), Corpo (obrigatório: o texto principal com variáveis no formato {{1}}, {{2}}) e Rodapé (opcional: texto pequeno, como aviso de opt-out).

Exemplo de corpo de um template de confirmação de pedido:

Olá, {{1}}! Seu pedido *#{{2}}* foi confirmado com sucesso. 🎉

Valor total: R$ {{3}}
Previsão de entrega: {{4}}
Acompanhe o status do seu pedido em nosso site ou responda esta
mensagem para falar com nossa equipe.
Obrigado por comprar com a {{5}}!

Passo 4: Adicionar botões (opcional mas recomendado)

Botões aumentam muito as taxas de engajamento. Você pode adicionar até 3 botões de tipos diferentes: Resposta Rápida (texto que o cliente pode clicar para responder), URL (abre um link no navegador) e Telefone (inicia uma chamada). Para templates de marketing, sempre inclua um botão de "Parar de receber mensagens" para reduzir denúncias de spam.

Passo 5: Enviar para aprovação

Após revisar todo o conteúdo, clique em "Enviar". Em 2026, a Meta usa IA para aprovação automática, e a maioria dos templates é aprovada em menos de 2 horas. Templates com conteúdo sensível podem levar até 24 horas. Você recebe notificação por e-mail quando aprovado ou reprovado.

Como Enviar um Template Message via Cloud API (com Exemplo JSON)

Com o template aprovado, o envio é feito via HTTP POST para o endpoint da Cloud API. Veja o exemplo completo de payload:

POST https://graph.facebook.com/v18.0/{PHONE_NUMBER_ID}/messages
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "confirmacao_pedido",
    "language": { "code": "pt_BR" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "João Silva" },
          { "type": "text", "text": "12345" },
          { "type": "text", "text": "150,00" },
          { "type": "text", "text": "15/01/2026" },
          { "type": "text", "text": "Loja XYZ" }
        ]
      }
    ]
  }
}

Enviando template com cabeçalho de imagem

Para templates com imagem no cabeçalho, adicione o componente de header antes do body:

"components": [
  {
    "type": "header",
    "parameters": [
      {
        "type": "image",
        "image": {
          "link": "https://seusite.com.br/banner-promocao.jpg"
        }
      }
    ]
  },
  {
    "type": "body",
    "parameters": [
      { "type": "text", "text": "João" },
      { "type": "text", "text": "50%" }
    ]
  },
  {
    "type": "button",
    "sub_type": "url",
    "index": "0",
    "parameters": [
      { "type": "text", "text": "ver-promocao" }
    ]
  }
]

Interpretando a resposta da API

Em caso de sucesso, a API retorna o ID da mensagem que você deve armazenar para rastreamento de entrega via webhooks. Em caso de erro, os códigos mais comuns são: 131030 (limite de tier atingido), 131047 (template não aprovado ou inexistente) e 131026 (número destinatário inválido).

Por Que Templates São Reprovados e Como Evitar

Ter um template reprovado atrasa suas campanhas e pode, em casos extremos, afetar a reputação da sua conta. Conheça os principais motivos de reprovação e como evitá-los:

Conteúdo promocional excessivo

Templates de Utilidade não podem ter linguagem promocional. Frases como "Aproveite nossa oferta exclusiva!" em um template categorizado como Utilidade serão reprovadas. Use a categoria Marketing para campanhas promocionais — mesmo que o custo seja maior, é a forma correta.

Variáveis em URLs

Um erro muito comum é colocar URLs completas ou parciais dentro de variáveis do corpo: Acesse: {{1}} onde a variável seria substituída por uma URL. A Meta não permite isso. Se precisar de links dinâmicos, use os botões de ação URL com sufixo variável.

Termos proibidos pela Meta

Produtos e serviços proibidos nas políticas de comércio da Meta (apostas online, medicamentos sem prescrição, criptomoedas de alto risco, conteúdo adulto) resultam em reprovação imediata e possível suspensão da conta. Consulte sempre as políticas de comércio da Meta antes de criar templates para categorias sensíveis.

Texto com excesso de pontuação e maiúsculas

Templates com muitas exclamações (!!!), texto em CAIXA ALTA excessivo ou emojis em abundância são sinais de spam para o algoritmo da Meta. Escreva de forma natural, como você escreveria para um amigo — com moderação e clareza.

Categorização incorreta

Recentemente, a Meta atualizou o sistema para detectar automaticamente quando um template de Marketing está sendo enviado como Utilidade. Além da reprovação, pode haver penalização na qualidade da conta. Seja honesto na categorização.

Perguntas Frequentes