Tutorial Técnico: Enviando Template Messages na API Oficial

Anatomia de um Template Message (A Regra Oficial)

A Meta exige que qualquer mensagem enviada para um usuário fora da "Janela de Atendimento" de 24 horas seja obrigatoriamente um MTM (Message Template Model). Essa regra barra spam indiscriminado. Você deve criar o template no gerenciador do WhatsApp e aguardar a aprovação (que hoje leva em média 2 minutos graças à inteligência artificial deles).

Payload JSON de Exemplo no Node.JS / Python

O envio se dá através de uma simples requisição cURL ou HTTP POST em REST. Veja um esqueleto padrão da Cloud API para um template de marketing com botões:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "boas_vindas_hablas",
    "language": { "code": "pt_BR" },
    "components": [
      {
         "type": "body",
         "parameters": [
           { "type": "text", "text": "Gabriel" }
         ]
      }
    ]
  }
}

Os 3 Mandamentos para Aprovação Imediata

• Gramática Impecável: O algoritmo de IA do Facebook instantaneamente recusa templates com pontos de exclamação em excesso ou erros grosseiros de ortografia (ex: "COMPRE AQUI!!!!!!").
• Gatilhos de Variáveis Corretas: Nunca coloque um link nas variáveis soltas {{1}}. Se vai enviar um domínio, use o recurso nativo "Botão de Ação: URL" no gerenciador, definindo a URL fixa.
• Evitar Termos de Risco: Palavras agressivas atreladas a criptomoedas duvidosas, remédios sem registro em agência e cassinos online acionam um alerta manual e causam a reprovação ou banimento silencioso (quality score caindo para o vermelho).