Webhook Events

Complete list of events you can subscribe to.

Message Events

message.sent

Triggered when a message is sent to WhatsApp servers.

{
  "type": "message.sent",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "message_id": "wamid.HBgNNjI4MTU1...",
    "to": "+1234567890",
    "message_type": "text"
  }
}

message.delivered

Triggered when a message is delivered to the recipient.

{
  "type": "message.delivered",
  "timestamp": "2024-01-15T10:30:05Z",
  "data": {
    "message_id": "wamid.HBgNNjI4MTU1...",
    "to": "+1234567890"
  }
}

message.read

Triggered when the recipient reads the message.

{
  "type": "message.read",
  "timestamp": "2024-01-15T10:32:00Z",
  "data": {
    "message_id": "wamid.HBgNNjI4MTU1...",
    "to": "+1234567890"
  }
}

message.received

Triggered when you receive a message from a user.

{
  "type": "message.received",
  "timestamp": "2024-01-15T10:35:00Z",
  "data": {
    "message_id": "wamid.HBgNNjI4MTU1...",
    "from": "+1234567890",
    "message_type": "text",
    "text": "Hello, I need help with my order",
    "contact": {
      "name": "John Doe",
      "wa_id": "1234567890"
    }
  }
}

message.failed

Triggered when a message fails to deliver.

{
  "type": "message.failed",
  "timestamp": "2024-01-15T10:30:10Z",
  "data": {
    "message_id": "wamid.HBgNNjI4MTU1...",
    "to": "+1234567890",
    "error": {
      "code": "131047",
      "message": "Re-engagement message"
    }
  }
}

Account Events

account.connected

WhatsApp Business Account connected.

account.disconnected

WhatsApp Business Account disconnected.

quota.warning

Approaching API quota limit (80% used).

quota.exceeded

API quota limit exceeded.

Event Categories