WhatsApp ग्रुप मैसेज प्राप्त करना

कोई भी प्रतिभागी ग्रुप में जो लिखता है वह उसी तरह आता है जैसे कोई अन्य इनबाउंड WhatsApp मैसेज आता है: वही whatsapp.received इवेंट, वही कंटेंट आर्म्स, वही मीडिया फ़ेच। दो चीज़ें ग्रुप के लिए खास हैं। मैसेज में लिखने वाले प्रतिभागी और जिस ग्रुप से आया दोनों का नाम होता है, और आपका रिप्लाई उस व्यक्ति के बजाय ग्रुप को जाता है।

WhatsApp मैसेज प्राप्त करना उन हिस्सों को कवर करता है जो ग्रुप-विशिष्ट नहीं हैं: हर कंटेंट आर्म, इनबाउंड मीडिया फ़ेच करना, और उद्धृत रिप्लाई।

ग्रुप मैसेज में क्या होता है

एक इनबाउंड ग्रुप मैसेज एक के बजाय दो एड्रेस के साथ दिखता है:

• from वह प्रतिभागी है जिसने लिखा, कभी ग्रुप नहीं। इसमें उनका bsuid (बिज़नेस-स्कोप्ड यूज़र ID), जब आपके बिज़नेस को पता हो तो उनका phone_number, और जब वे प्रोफ़ाइल प्रकाशित करते हैं तो उनका username और display_name होता है। जिस प्रतिभागी ने आपके साथ अपना नंबर शेयर नहीं किया है उसकी पहचान केवल bsuid से होती है, जो उन्हें संबोधित करने के लिए पर्याप्त है।
• to में आपका बिज़नेस नंबर और ग्रुप होता है। phone_number वह नंबर है जिसने मैसेज प्राप्त किया, और group_id वह ग्रुप है जिससे यह आया।

group_id केवल to पर दिखता है और कहीं और नहीं, इसलिए वहाँ इसकी मौजूदगी ही ग्रुप मैसेज को वन-टू-वन मैसेज से अलग बताती है, दोनों दिशाओं में। ग्रुप मैसेज में कोई काउंटर नहीं होते: recipient_count, delivered_count, और read_count आउटबाउंड फ़ैन-आउट रिपोर्ट करते हैं, और इनबाउंड मैसेज में कोई नहीं होता।

एक ग्रुप का थ्रेड दोनों दिशाओं में एक साथ पढ़ने के लिए, मैसेज लिस्ट को group_id से फ़िल्टर करें जैसा WhatsApp ग्रुप को भेजना दिखाता है।

ग्रुप को रिप्लाई करना

ग्रुप में लिखने वाला प्रतिभागी पूरे ग्रुप के लिए एक 24 घंटे की कस्टमर सर्विस विंडो खोलता है, प्रति व्यक्ति नहीं। जब तक यह खुली है, फ़्री-फ़ॉर्म कंटेंट ग्रुप तक पहुँचता है; समाप्त होने पर टेम्प्लेट भेजना होता है। रिप्लाई ग्रुप को संबोधित करें, to में ग्रुप ID के साथ और बिना from के। देखें WhatsApp ग्रुप को भेजना।

उस प्रतिभागी को निजी तौर पर लिखना एक अलग बातचीत है जिसकी अपनी विंडो होती है, और ग्रुप मैसेज उसे नहीं खोलता। उनके फ़ोन नंबर या bsuid पर भेजा गया फ़्री-फ़ॉर्म मैसेज 422 E15044 के साथ अस्वीकार कर दिया जाता है, जब तक कि उन्होंने पिछले 24 घंटों में आपके बिज़नेस को अलग से मैसेज न किया हो। टेम्प्लेट किसी भी स्थिति में उन तक पहुँचता है।

पावती देना और रिएक्ट करना

दोनों पावतियाँ ग्रुप मैसेज पर काम करती हैं और किसी भी अन्य इनबाउंड मैसेज की तरह वही कॉल लेती हैं:

• मैसेज की अपनी ID के साथ पढ़ा हुआ चिह्नित करें। ग्रुप के लिए कॉल में कुछ नहीं बदलता।
• एक इमोजी के साथ रिएक्ट करें। रिएक्शन ग्रुप में जाता है, इसलिए हर प्रतिभागी इसे देखता है। जो ग्रुप सक्रिय नहीं है वह 409 E15047 के साथ बदलाव अस्वीकार कर देता है, जो कि एकमात्र अस्वीकृति है जो ग्रुप मैसेज पर रिएक्शन में होती है लेकिन वन-टू-वन रिएक्शन में नहीं।

Webhook

whatsapp.received ग्रुप मैसेज को किसी भी अन्य की तरह उसी एनवेलप पर ले जाता है, ग्रुप to पर होता है:

{
  "type": "whatsapp.received",
  "timestamp": "2026-09-15T14:05:41.204Z",
  "data": {
    "whatsapp_id": "wam_01kya1b3xdq7fe8m2v5t9rncgs",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+15550002222", "bsuid": "US.AbC1", "display_name": "Dana Reyes" },
    "to": { "phone_number": "+15550001111", "group_id": "wag_01krdgeqcxet5s7t44vh8rt9mg" },
    "text": { "body": "Got it, thanks." },
    "tags": null,
    "metadata": null
  }
}

मैसेज को ग्रुप के थ्रेड में रूट करने के लिए data.to.group_id पढ़ें, और प्रतिभागी को एट्रिब्यूट करने के लिए data.from। जो सब्सक्राइबर केवल from पर बातचीत की कुंजी रखता है, वह ग्रुप के हर प्रतिभागी को अलग थ्रेड में डाल देता है और ग्रुप खो देता है।

ग्रुप के लिए कोई अलग इवेंट नहीं है। किसी का जुड़ना या छोड़ना, नाम बदलना, या पिन करना, इनमें से कोई भी वेबहुक नहीं भेजता, इसलिए ग्रुप की सदस्यता पुश नहीं होती बल्कि पढ़ी जाती है: ग्रुप को Groups पेज पर खोलें, या Managing WhatsApp groups में दिखाए अनुसार उसे वापस पढ़ें।

अगले कदम

• WhatsApp ग्रुप को भेजना: ग्रुप को संबोधित करना, इसके लिए क्या चाहिए, और इसकी प्रति-प्रतिभागी रसीदें
• Managing WhatsApp groups: API पर ग्रुप बनाना, इनवाइट लिंक, जॉइन रिक्वेस्ट, और पिन
• WhatsApp groups: ग्रुप किसलिए है, और WhatsApp क्या सीमाएँ लगाता है
• WhatsApp मैसेज प्राप्त करना: हर कंटेंट आर्म, मीडिया, और कोटेड रिप्लाई
• Business-scoped user IDs: ऐसे प्रतिभागी को संबोधित करना जिसका फ़ोन नंबर आपके पास नहीं है