Sign inGet Started

WhatsApp संदेश स्थिति वेबहुक

किसी आउटबाउंड संदेश की स्थिति में हर बदलाव होते ही आपके एंडपॉइंट पर भेजा जा सकता है। हर पेलोड 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 का अपना स्पष्टीकरण होता है। जिस सेवा संदेश की ग्राहक सेवा विंडो स्वीकार होने और भेजे जाने के बीच बंद हो गई हो, वह इस तरह विफल होता है:

कोड उदाहरण
{
  "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 दर्ज होता है, लेकिन कोई वेबहुक नहीं भेजा जाता।

अगले कदम

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।