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 रिकॉर्ड करता है, लेकिन कोई वेबहुक नहीं भेजता।
अगले कदम
- इनबाउंड संदेश webhooks: किसी संपर्क द्वारा आपको भेजे गए संदेश के लिए whatsapp.received पेलोड
- रिएक्शन webhooks: किसी संपर्क की प्रतिक्रियाएँ अलग से आती हैं
- संदेश स्थिति इवेंट्स: API के माध्यम से किसी संदेश की टाइमलाइन वापस पढ़ें
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।
गाइड देखेंConnecting WhatsApp to Bird: from buying a number to a live channelकॉन्सेप्ट समझेंWhat is the 24-hour customer service window on WhatsApp?टूल का उपयोग करेंWhatsApp message builderक्षमता जानेंWhatsApp
अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ