Sign inGet Started

WhatsApp संदेश स्थिति webhooks

आउटबाउंड संदेश की स्थिति में हर बदलाव होते ही आपके endpoint पर पुश किया जा सकता है। हर पेलोड WhatsApp इवेंट एन्वेलप का उपयोग करता है और हर संदेश इवेंट में मौजूद फ़ील्ड्स को शामिल करता है।

डिलीवरी इवेंट

whatsapp.accepted, whatsapp.sent, whatsapp.delivered, और whatsapp.read में केवल वही फ़ील्ड्स होती हैं जो हर संदेश इवेंट में होती हैं। लाइफ़साइकल इवेंट्स बताता है कि हर एक का क्या अर्थ है और whatsapp.delivered कब छोड़ दिया जाता है।
कोड उदाहरण
{
  "data": {
    "direction": "outbound",
    "from": { "phone_number": "+13124495569" },
    "metadata": { "session_id": "sess_4821" },
    "tags": [{ "name": "flow", "value": "login-otp" }],
    "to": { "phone_number": "+14155550100" },
    "whatsapp_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:51:39.913Z",
  "type": "whatsapp.delivered"
}
whatsapp.failed और whatsapp.rejected में एक error ऑब्जेक्ट भी होता है जिसमें एक स्थिर Bird code, एक मानव-पठनीय description, एक वैकल्पिक meta_error_code, और occurred_at शामिल हैं। इन दोनों में क्या अंतर है, यह जानने के लिए विफलता इवेंट्स देखें। रिपोर्ट की गई विफलता WhatsApp पर, description स्वयं WhatsApp का विवरण होता है। एक सर्विस संदेश जिसकी कस्टमर सर्विस विंडो accept और dispatch के बीच बंद हो गई, इस प्रकार विफल होता है:
कोड उदाहरण
{
  "data": {
    "direction": "outbound",
    "error": {
      "code": "service_window_expired",
      "description": "Message failed to send because more than 24 hours have passed since the customer last replied to this number.",
      "meta_error_code": "131047",
      "occurred_at": "2026-07-23T14:51:40.201Z"
    },
    "from": { "phone_number": "+13124495569" },
    "metadata": null,
    "tags": null,
    "to": { "phone_number": "+14155550100" },
    "whatsapp_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:51:40.201Z",
  "type": "whatsapp.failed"
}
इनबाउंड मैसेज को पढ़ा हुआ चिह्नित करना मैसेज की टाइमलाइन में whatsapp.read रिकॉर्ड करता है, लेकिन कोई वेबहुक नहीं भेजता।

अगले कदम