Eventos dos Webhooks

template.* avisa sobre o catálogo Meta (aprovação, rejeição, categoria). message.* avisa sobre entrega da mensagem, são coisas diferentes.

Em poucas palavras

Eventos template.* = ciclo de vida do template oficial sincronizado com a Meta.
instanceId vem vazio, templates não usam instância de canal.
Disparam quando você publica na Meta, quando a Meta muda status ou categoria, ou quando o Notifique atualiza o espelho local após sync.
Para saber se a mensagem entregou, use webhooks do WhatsApp (message.sent, message.delivered, …).

Configuração geral: Webhooks. Segurança: Segurança de webhooks.

Como vem o POST

{
  "event": "template.status_changed",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-07-25T16:10:00.000Z",
  "data": {
    "templateId": "clxx...",
    "name": "boas_vindas",
    "metaName": "boas_vindas",
    "metaId": "1234567890",
    "metaWabaId": "9876543210",
    "language": "pt_BR",
    "source": "WHATSAPP_OFFICIAL",
    "status": "APPROVED",
    "previousStatus": "PENDING",
    "category": "MARKETING",
    "metaEvent": "APPROVED",
    "rejectionReason": null
  }
}

Campo	Descrição
`event`	`template.submitted`, `template.status_changed` ou `template.category_changed`
`data.templateId`	ID do template no Notifique
`data.name`	Nome interno do template
`data.metaName`	Nome na Meta (envio oficial)
`data.source`	`WHATSAPP_OFFICIAL` em templates oficiais
`data.status`	Status atual (`APPROVED`, `PENDING`, `REJECTED`, …)
`data.previousStatus`	Status anterior (em `status_changed`)
`data.rejectionReason`	Motivo quando `REJECTED`

Headers: X-Notifique-Signature, X-Notifique-Timestamp, X-Workspace-Id, X-Webhook-Event.

O que seu servidor deve responder

Resposta	Efeito
2xx em até ~10s	Evento entregue
4xx / 5xx / timeout	Retentativa automática

Boas práticas: ao receber APPROVED, libere o template no seu app para disparos oficiais; em REJECTED, bloqueie e alerte o time de conteúdo.

Referência por evento

Evento	Quando dispara	O que fazer com isso
`template.submitted`	Template enviado/publicado na Meta	Registrar envio para aprovação
`template.status_changed`	Status local muda	Liberar ou bloquear envios oficiais
`template.category_changed`	Categoria Meta muda	Ajustar regras de cobrança/uso

Status possíveis em status_changed: APPROVED, PENDING, REJECTED, IN_APPEAL, PAUSED, DISABLED, DELETED, PENDING_DELETION, LIMIT_EXCEEDED, ARCHIVED.

Payload de cada evento

template.submitted

Disparado quando o template é enviado para a Meta (publicação ou atualização pendente de análise).

{
  "event": "template.submitted",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-07-25T15:00:00.000Z",
  "data": {
    "templateId": "clxx...",
    "name": "confirmacao_pedido",
    "metaName": "order_confirmation",
    "metaId": "1234567890",
    "metaWabaId": "9876543210",
    "language": "pt_BR",
    "source": "WHATSAPP_OFFICIAL",
    "status": "PENDING",
    "category": "UTILITY"
  }
}

template.status_changed

Disparado quando o status muda, tipicamente após resposta da Meta ou sync.

{
  "event": "template.status_changed",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-07-25T16:10:00.000Z",
  "data": {
    "templateId": "clxx...",
    "name": "boas_vindas",
    "metaName": "boas_vindas",
    "metaId": "1234567890",
    "metaWabaId": "9876543210",
    "language": "pt_BR",
    "source": "WHATSAPP_OFFICIAL",
    "status": "APPROVED",
    "previousStatus": "PENDING",
    "category": "MARKETING",
    "metaEvent": "APPROVED",
    "rejectionReason": null
  }
}

Exemplo rejeitado:

{
  "event": "template.status_changed",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-07-25T17:00:00.000Z",
  "data": {
    "templateId": "clxx...",
    "name": "promo_verao",
    "metaName": "summer_promo",
    "status": "REJECTED",
    "previousStatus": "PENDING",
    "category": "MARKETING",
    "rejectionReason": "INVALID_FORMAT"
  }
}

template.category_changed

Disparado quando a Meta reclassifica o template (impacta cobrança e regras de uso).

{
  "event": "template.category_changed",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-07-26T09:00:00.000Z",
  "data": {
    "templateId": "clxx...",
    "name": "lembrete_pedido",
    "metaName": "order_reminder",
    "metaId": "1234567890",
    "language": "pt_BR",
    "source": "WHATSAPP_OFFICIAL",
    "status": "APPROVED",
    "category": "UTILITY",
    "previousCategory": "MARKETING"
  }
}

Fluxo típico (publicar na Meta)

Próximos passos

Templates oficiais Meta: sync, vínculo e publicação
Quick Start: disparo multicanal
Introdução: interno × oficial
Eventos WhatsApp: entrega message.*
Webhooks (guia geral)

​Em poucas palavras

​Como vem o POST

​O que seu servidor deve responder

​Referência por evento

​Payload de cada evento

​Fluxo típico (publicar na Meta)

​Próximos passos

Em poucas palavras

Como vem o POST

O que seu servidor deve responder

Referência por evento

Payload de cada evento

Fluxo típico (publicar na Meta)

Próximos passos