Webhook Events - Notifique

template.* tracks the Meta catalog (approval, rejection, category). message.* tracks message delivery, different concerns.

In brief

template.* events = lifecycle of official templates synced with Meta.
instanceId is empty, templates do not use a channel instance.
Fires when you publish to Meta, when Meta changes status or category, or when Notifique updates the local mirror after sync.
For delivery, use WhatsApp webhooks (message.sent, message.delivered, …).

General setup: Webhooks. Security: Webhook security.

How the POST looks

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

Event reference

Event	When it fires	What to do with it
`template.submitted`	Template submitted/published to Meta	Log submission for approval
`template.status_changed`	Local status changes	Allow or block official sends
`template.category_changed`	Meta category changes	Adjust billing/usage rules

Possible statuses in status_changed: APPROVED, PENDING, REJECTED, IN_APPEAL, PAUSED, DISABLED, DELETED, PENDING_DELETION, LIMIT_EXCEEDED, ARCHIVED.

Payload per event

template.submitted

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

template.status_changed

{
  "event": "template.status_changed",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-07-25T16:10:00.000Z",
  "data": {
    "templateId": "clxx...",
    "name": "welcome",
    "metaName": "welcome",
    "status": "APPROVED",
    "previousStatus": "PENDING",
    "category": "MARKETING",
    "rejectionReason": null
  }
}

Rejected example:

{
  "event": "template.status_changed",
  "data": {
    "name": "summer_promo",
    "status": "REJECTED",
    "previousStatus": "PENDING",
    "rejectionReason": "INVALID_FORMAT"
  }
}

template.category_changed

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

Next steps

Official Meta templates: sync, link, publish
Quick Start: multi-channel dispatch
Introduction: internal × official
WhatsApp events: message.* delivery
Webhooks (general guide)

​In brief

​How the POST looks

​Event reference

​Payload per event

​Next steps

In brief

How the POST looks

Event reference

Payload per event

Next steps