WebhookWebhook Payloads

Webhook Payloads

1. Chat Message Payload

This payload is received when a new message is sent to your WhatsApp Business Account.

{
  "messaging_product": "whatsapp",
  "message_type": "incoming_message",
  "participants": {
    "sender": {
      "from": "919876543210",
      "profile": {
        "name": "Bharath"
      }
    },
    "receiver": {
      "to": "919123456789"
    }
  },
  "message": {
    "conversation_id": "68f1f14a7c8e981501051fca",
    "timestamp": "1760686408",
    "type": "text",
    "text": {
      "body": "Welcome"
    }
  }
}

2. Status Update Payload (Delivered)

This payload is received when a message status is updated to ‘delivered’.

{
  "messaging_product": "whatsapp",
  "message_type": "status_update",
  "participants": {
    "sender": {
      "from": "919876543210",
      "profile": {
        "name": "Bharath"
      }
    },
    "receiver": {
      "to": "919123456789"
    }
  },
  "statuses": [
    {
      "conversation_id": "68f1f505d3e5e42af8bfa3a0",
      "status": "delivered",
      "timestamp": "1760687366",
      "meta_pricing": {
        "meta_billable": false,
        "meta_category": "utility",
        "meta_type": "free_customer_service"
      }
    }
  ]
}

3. Status Update Payload (Failed)

This payload is received when a message fails to be delivered.

{
  "messaging_product": "whatsapp",
  "message_type": "status_update",
  "participants": {
    "sender": {
      "from": "919876543210",
      "profile": {
        "name": "Bharath"
      }
    },
    "receiver": {
      "to": "919123456789"
    }
  },
  "statuses": [
    {
      "conversation_id": "68f3195eb1aac372397c1c38",
      "status": "failed",
      "timestamp": "1760762206",
      "errors": [
        {
          "code": 131026,
          "title": "Message undeliverable",
          "message": "Message undeliverable",
          "error_data": {
            "details": "Message Undeliverable."
          }
        }
      ],
      "meta_pricing": {
        "meta_billable": false,
        "meta_category": "",
        "meta_type": ""
      }
    }
  ]
}

Note: All timestamps are in Unix timestamp format.

Webhook IntegrationAccount Creation