Sign inGet started

WhatsApp रिएक्शन भेजना

किसी संपर्क के संदेश पर इमोजी से रिएक्ट करें, जैसे उनके जवाब की पुष्टि के लिए थम्ब्स अप। आप अपना रिएक्शन बाद में बदल या हटा सकते हैं।

आवश्यकताएँ

आपको WhatsApp write अनुमति वाली एक API key और आपके वर्कस्पेस को प्राप्त संदेश की Bird message ID (wam_…) चाहिए। whatsapp.received से data.whatsapp_id का उपयोग करें, या WhatsApp लॉग से संदेश की id का उपयोग करें।
उदाहरण message ID को अपने वर्कस्पेस को प्राप्त संदेश की ID से बदलें। TypeScript, Python, Go, या PHP SDK गाइड का उपयोग करके अपनी भाषा के लिए क्लाइंट इनिशियलाइज़ करें। CLI उदाहरणों के लिए, WhatsApp write एक्सेस के साथ CLI इंस्टॉल और ऑथेंटिकेट करें। cURL अनुरोधों में अपने वर्कस्पेस क्षेत्र के लिए API होस्ट का उपयोग करें।

1. रिएक्शन जोड़ें

एक इमोजी के साथ WhatsApp संदेश पर रिएक्ट करें कॉल करें:
const reaction = await bird.whatsapp.reaction.set("wam_01krdgeqcxet5s7t44vh8rt9mg", {
  emoji: "👍",
});
console.log(reaction.id, reaction.emoji);
API स्वीकृत रिएक्शन की id (war_…) और emoji के साथ 202 लौटाता है। रिएक्शन लॉग में परिणाम खोजने के लिए reaction ID सहेजें। स्वीकृति इस बात की पुष्टि नहीं करती कि WhatsApp ने रिएक्शन लागू किया।
आपके पास प्रति संदेश एक रिएक्शन होता है। इसे बदलने के लिए, किसी अलग इमोजी के साथ PUT अनुरोध दोहराएँ। रिएक्शन के लिए कोई शुल्क नहीं लगता।

2. रिएक्शन परिणाम जाँचें

वर्तमान reactions देखने के लिए संदेश प्राप्त करें, जिसमें प्रति प्रेषक एक प्रविष्टि होती है। किसी विशेष परिवर्तन का परिणाम जानने के लिए, संदेश के रिएक्शन इवेंट सूचीबद्ध करें और सहेजी गई reaction ID खोजें।
रिएक्शन लॉग अंतिम परिणाम दर्ज करता है: sent का अर्थ है WhatsApp ने आपका परिवर्तन स्वीकार किया, failed का अर्थ है WhatsApp ने इसे अस्वीकार किया, और rejected का अर्थ है Bird ने ट्रांसमिशन से पहले इसे अस्वीकार किया। विफल या अस्वीकृत परिवर्तन के लिए इवेंट की error जाँचें। लंबित रिएक्शन की अभी तक कोई लॉग प्रविष्टि नहीं होती। रिएक्शन में डिलीवरी या रीड रिसीप्ट नहीं होती और कोई आउटबाउंड रिएक्शन webhook नहीं होता।

3. अपना रिएक्शन हटाएँ

उसी message ID के साथ WhatsApp रिएक्शन हटाएँ कॉल करें:
await bird.whatsapp.reaction.remove("wam_01krdgeqcxet5s7t44vh8rt9mg");
API बिना response body के 202 लौटाता है। हटाने की प्रक्रिया असिंक्रोनस रूप से होती है; परिणाम की पुष्टि के लिए संदेश की वर्तमान reactions या उसका रिएक्शन लॉग जाँचें। हटाने की लॉग प्रविष्टि में emoji: null होता है। अनुपस्थित रिएक्शन हटाना सुरक्षित है, और यह ऑपरेशन आपके वर्कस्पेस का रिएक्शन हटाता है, संपर्क का नहीं।

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

  • 404 (E15071): लक्ष्य message ID और वर्कस्पेस जाँचें। Bird रिएक्शन जोड़ने या हटाने के लिए आवश्यक संदेश संदर्भ 15 दिनों तक बनाए रखता है।
  • 422 (E01001): एक प्राप्त संदेश और एक अकेला इमोजी उपयोग करें। आप अपने वर्कस्पेस द्वारा भेजे गए संदेश पर रिएक्ट नहीं कर सकते। एक जुड़ा हुआ इमोजी एक इमोजी माना जाता है; दो अलग-अलग इमोजी नहीं।
  • 202 के बाद रिएक्शन अपरिवर्तित: विफल या अस्वीकृत परिवर्तन के लिए रिएक्शन लॉग जाँचें। एक सफल HTTP प्रतिक्रिया प्रोसेसिंग के लिए स्वीकृति की पुष्टि करती है।

अगले कदम