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.