Skip to main content

Templates (HSM)

No WhatsApp Business API, para iniciar uma conversa com um cliente (fora da janela de 24h), você obrigatoriamente deve usar um Template de Mensagem (também conhecido como HSM - Highly Structured Message).

O que é um Template?​

É um modelo de mensagem pré-aprovado pela Meta (Facebook) para garantir qualidade e evitar spam. Eles podem conter variáveis, botões e cabeçalhos de mídia.

Exemplo:

Olá {{1}}, seu pedido {{2}} foi confirmado!

Categorias​

Os templates são classificados em:

  1. Marketing: Promoções, ofertas, novidades.
  2. Utility (Utilidade): Atualizações de pedido, alertas de conta, boletos.
  3. Authentication (Autenticação): Códigos OTP (One-Time Password).

Gerenciando Templates via API​

Sincronizar (Sync)​

Como os templates são criados no Gerenciador do WhatsApp, você deve sincronizá-los com a QuettaCode para usá-los.

POST /api/v1/templates/sync

Listar​

Para ver os templates disponíveis e seus status (APPROVED, REJECTED, PENDING):

GET /api/v1/templates

Enviar Mensagem de Template​

Use o endpoint de envio de mensagem especificando o tipo template.

Payload Exemplo:

{
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "pedido_confirmado",
    "language": "pt_BR",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Maria" },
          { "type": "text", "text": "#1234" }
        ]
      }
    ]
  }
}

Dica: O nome do template deve ser exatamente igual ao cadastrado na Meta.