Sign inGet Started
शुरू करें
गाइड
API Reference
SDKs
CLI
Knowledge Base
Changelog

WhatsApp वेबहुक

Bird आपकी WhatsApp गतिविधि को होते ही आपके एंडपॉइंट पर भेज देता है, इसलिए आपको इसके लिए बार-बार पोल नहीं करना पड़ता। Webhooks पेज से या POST /v1/webhooks से सब्सक्राइब करें। वेबहुक गाइड में एंडपॉइंट, सिग्नेचर सत्यापन और फिर से प्रयास की जानकारी है।

वे इवेंट जिन्हें आप सब्सक्राइब कर सकते हैं

हर इवेंट उसके पेलोड से लिंक है।

इवेंटकब ट्रिगर होता है
whatsapp.acceptedBird कोई आउटबाउंड भेजने का अनुरोध स्वीकार करता है
whatsapp.sentBird मैसेज को WhatsApp नेटवर्क को सौंपता है
whatsapp.deliveredWhatsApp प्राप्तकर्ता के डिवाइस पर डिलीवरी की पुष्टि करता है
whatsapp.readप्राप्तकर्ता संदेश खोलता है
whatsapp.failedसंदेश डिलीवर नहीं हो पाता
whatsapp.rejectedBird संदेश भेजने से पहले उसे अस्वीकार कर देता है
whatsapp.receivedकोई संपर्क आपको संदेश भेजता है
whatsapp.reactedकोई संपर्क प्रतिक्रिया जोड़ता, बदलता या हटाता है
whatsapp_suppression.createdआपके वर्कस्पेस पर कोई सप्रेशन शुरू होता है
whatsapp.group.join_request_createdकोई व्यक्ति किसी ग्रुप में शामिल होने का अनुरोध करता है
whatsapp.group.join_request_revokedकोई व्यक्ति किसी ग्रुप में शामिल होने का अपना अनुरोध रद्द करता है

इवेंट टाइप की सूची खुली है: समय के साथ नए टाइप जुड़ सकते हैं, इसलिए किसी अपरिचित मान को त्रुटि नहीं, बल्कि भविष्य का इवेंट मानें।

इवेंट एनवेलप

हर WhatsApp इवेंट मानक वेबहुक एनवेलप का उपयोग करता है: एक type, एक timestamp और टाइप के अनुसार एक data ऑब्जेक्ट।

कोड उदाहरण
{
  "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 वेबहुक पेलोड में whatsapp_id, workspace_id, direction, from, to, tags और metadata होते हैं। रिएक्शन, सप्रेशन और ग्रुप इवेंट किसी मैसेज के बारे में नहीं होते, इसलिए हर एक की अपनी संरचना है, जो उसके पेज पर दी गई है।

  • पते: from और to में E.164 phone_number, bsuid में Meta का बिज़नेस-स्कोप्ड यूज़र ID, या दोनों हो सकते हैं। किसी WhatsApp यूज़र से मिले मैसेज में वह प्रोफ़ाइल भी होती है जो वह प्रकाशित करता है, username और display_name में।
  • जब भेजे गए संदेश में कोई मान नहीं था, तब tags और metadata null होते हैं।
  • in_reply_to_message_id जवाब में भेजे गए संदेश के हर आउटबाउंड इवेंट में दिखता है, whatsapp.accepted से लेकर whatsapp.read, whatsapp.failed या whatsapp.rejected तक, और बताता है कि वह संदेश किस संदेश का जवाब है।

इवेंट पेलोड में लागत नहीं होती। संदेश की लागत देखने के लिए उसे GET /v1/whatsapp/messages/{message_id} से दोबारा पढ़ें।

अगले कदम

संबंधित संसाधन

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

अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ