WhatsApp प्रतिक्रिया इवेंट

इमोजी प्रतिक्रिया कोई नया संदेश नहीं बनाती, बल्कि किसी मौजूदा संदेश पर टिप्पणी जोड़ती है। इसलिए यह कभी अलग संदेश के रूप में या उस संदेश के संदेश स्थिति इवेंट में नहीं दिखती। इसके बजाय Bird इसके दो रूप रखता है: संदेश पर अभी मौजूद प्रतिक्रियाएँ, और वहाँ तक पहुँचाने वाले हर बदलाव का लॉग। दोनों में संपर्क और आपके व्यावसायिक नंबर, दोनों के बदलाव दर्ज होते हैं।

किसी संपर्क की प्रतिक्रिया की सूचना उसी समय पाने के लिए whatsapp.reacted की सदस्यता लें। अपनी प्रतिक्रिया जोड़ने या हटाने के लिए प्रतिक्रियाएँ भेजना देखें।

पूर्वापेक्षाएँ

WhatsApp पढ़ने की अनुमति वाली एक API कुंजी, और उस संदेश की ID (wam_…) जिस पर प्रतिक्रिया दी गई थी।

1. मौजूदा प्रतिक्रियाएँ पढ़ें

अगर आपका ऐप्लिकेशन किसी संदेश पर अभी लगी प्रतिक्रिया दिखाता है, तो संदेश प्राप्त करें और उसका reactions पढ़ें। सूची में हर भेजने वाले की एक मौजूदा प्रतिक्रिया होती है, और कोई प्रतिक्रिया न होने पर यह सूची शामिल नहीं होती।

GET /v1/whatsapp/messages/wam_01ky8b3xq4gd7pmzn2ka51f7te के लिए प्रतिक्रिया से जुड़े फ़ील्ड इस रूप में होते हैं (संदेश के अन्य फ़ील्ड हटाए गए हैं):

{
  "id": "wam_01ky8b3xq4gd7pmzn2ka51f7te",
  "reactions": [
    {
      "emoji": "👍",
      "from": { "phone_number": "+14155550100" }
    }
  ]
}

संदेश की मूल सामग्री, दिशा और डिलीवरी स्थिति वैसी ही रहती है। reactions[].from प्रतिक्रिया देने वाले व्यक्ति की पहचान बताता है।

यही वह स्थिति है जिसे दिखाना है। प्रतिक्रिया वेबहुक का टाइमस्टैम्प एक जैसा हो सकता है और वे क्रम से बाहर पहुँच सकते हैं। इसलिए किसी वेबहुक को मौजूदा स्थिति न मानें, बल्कि उसे संदेश दोबारा पढ़ने के संकेत की तरह इस्तेमाल करें।

2. रिएक्शन लॉग पढ़ें

संदर्भित संदेश में हुए हर बदलाव को सबसे नए से पुराने क्रम में देखने के लिए GET /v1/whatsapp/messages/{message_id}/reaction-events के साथ रिएक्शन इवेंट की सूची प्राप्त करें: जोड़े गए, बदले गए और हटाए गए रिएक्शन। हर प्रविष्टि में एक रिएक्शन ID (war_…), emoji, from में बदलाव करने वाला, एक occurred_at टाइमस्टैम्प और एक status होता है:

• received: किसी संपर्क का बदलाव।
• sent: WhatsApp ने आपके बिज़नेस नंबर का बदलाव स्वीकार किया।
• failed: WhatsApp ने आपका बदलाव अस्वीकार किया।
• rejected: Bird ने आपका बदलाव भेजने से पहले ही अस्वीकार कर दिया।

failed या rejected प्रविष्टि में कारण error पर होता है। हटाए गए रिएक्शन में emoji: null होता है। आपका जो बदलाव अभी लंबित है, उसका परिणाम पता चलने तक उसकी कोई प्रविष्टि नहीं होती। रिएक्शन पर कभी शुल्क नहीं लगता, इसलिए यहाँ कोई भी विफलता बिलिंग से जुड़ी नहीं होती।

रिएक्शन-इवेंट API पेज में बँटी प्रतिक्रिया लौटाता है। इस उदाहरण में एक अस्वीकृत बिज़नेस रिएक्शन और उससे पहले प्राप्त हुआ एक संपर्क रिएक्शन दिखाया गया है:

{
  "data": [
    {
      "id": "war_01krdgeqcxet5s7t44vh8rt9mh",
      "emoji": "🎉",
      "status": "rejected",
      "from": {
        "phone_number": "+13124495569"
      },
      "error": {
        "code": "internal_error",
        "description": "the receiving number is no longer connected",
        "occurred_at": "2026-08-28T19:04:22Z"
      },
      "occurred_at": "2026-08-28T19:04:22Z"
    },
    {
      "id": "war_01krdgeqcxet5s7t44vh8rt9mg",
      "emoji": "👍",
      "status": "received",
      "from": {
        "phone_number": "+14155550100",
        "bsuid": "US.13491208655302741918"
      },
      "occurred_at": "2026-08-28T19:01:10Z"
    }
  ],
  "next_cursor": null,
  "prev_cursor": null,
  "refresh_cursor": "eyJ2IjoxLCJzIjoiMjAyNi0wOC0yOFQxOTowNDoyMloiLCJpIjoiMDE5ZTFiMDctNWQ5ZC03NjhiLTkzZTgtODRkYzUxOGQyNjkxIn0"
}

रिएक्शन इतिहास संदेश के डिलीवरी इवेंट से अलग होता है। संदेश स्थिति इवेंट एंडपॉइंट में whatsapp.reacted बदलाव शामिल नहीं होते। डेटा रखने की अवधि और पेजिनेशन के लिए रिएक्शन लॉग संदर्भ देखें।

समस्या निवारण

• संदेश सूची में रिएक्शन नहीं दिख रहा: मूल संदेश खोजें। रिएक्शन उसी से जुड़ा होता है और उसकी कोई अलग संदेश पंक्ति नहीं होती।
• रिएक्शन की स्थिति अप्रत्याशित रूप से बदलती है: webhook इवेंट को पहुँचने के समय या टाइमस्टैम्प के क्रम में लगाने के बजाय संदेश का reactions पढ़ें।

अगले चरण

• रिएक्शन वेबहुक: जब कोई संपर्क रिएक्ट करे, तब सूचना पाएँ
• रिएक्शन भेजें या हटाएँ
• संदेश स्थिति इवेंट: किसी संदेश की डिलीवरी की समयरेखा