WhatsApp प्रतिक्रियाएँ भेजना

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

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

आपको WhatsApp लिखने की अनुमति वाली एक API कुंजी और आपके वर्कस्पेस को प्राप्त किसी संदेश की Bird संदेश ID (wam_…) चाहिए। whatsapp.received से data.whatsapp_id का उपयोग करें, या WhatsApp लॉग से संदेश का id लें।

उदाहरण संदेश ID को अपने वर्कस्पेस को प्राप्त किसी संदेश की ID से बदलें। TypeScript, Python, Go या PHP SDK गाइड का उपयोग करके अपनी भाषा के लिए क्लाइंट इनिशियलाइज़ करें। CLI उदाहरणों के लिए, WhatsApp लिखने की अनुमति के साथ CLI इंस्टॉल और प्रमाणित करें। cURL अनुरोधों में अपने वर्कस्पेस क्षेत्र का API होस्ट उपयोग करें।

1. प्रतिक्रिया जोड़ें

एक इमोजी के साथ WhatsApp संदेश पर प्रतिक्रिया दें को कॉल करें:

const reaction = await bird.whatsapp.reaction.set("wam_01krdgeqcxet5s7t44vh8rt9mg", {
  emoji: "👍",
});
console.log(reaction.id, reaction.emoji);

reaction = client.whatsapp.reaction.set("wam_01krdgeqcxet5s7t44vh8rt9mg", emoji="\U0001f44d")
print(reaction.id, reaction.emoji)

reaction, err := client.Whatsapp.Reaction.Set(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg", bird.WhatsappReactionSetParams{
	Emoji: "\U0001F44D",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(reaction.Id, reaction.Emoji)

use MessageBird\Wire\Model\WhatsAppReactionUpsert;

$reaction = $bird->whatsapp->reaction->set(
    'wam_01krdgeqcxet5s7t44vh8rt9mg',
    (new WhatsAppReactionUpsert())->setEmoji("\u{1F44D}"),
);
echo $reaction->getId(), ' ', $reaction->getEmoji();

bird whatsapp reaction set wam_01krdgeqcxet5s7t44vh8rt9mg --emoji '👍'

curl -X PUT "https://us1.platform.bird.com/v1/whatsapp/messages/wam_01krdgeqcxet5s7t44vh8rt9mg/reaction" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emoji": "👍"}'

API स्वीकार की गई प्रतिक्रिया के id (war_…) और emoji के साथ 202 लौटाता है। प्रतिक्रिया लॉग में उसका परिणाम खोजने के लिए प्रतिक्रिया ID सहेजें। स्वीकृति से यह पुष्टि नहीं होती कि WhatsApp ने प्रतिक्रिया लागू कर दी है।

हर संदेश पर आपकी एक ही प्रतिक्रिया रहती है। उसे बदलने के लिए, अलग इमोजी के साथ PUT अनुरोध दोहराएँ। प्रतिक्रियाओं के लिए कोई शुल्क नहीं लगता।

2. प्रतिक्रिया का परिणाम जाँचें

मौजूदा reactions देखने के लिए संदेश प्राप्त करें। इसमें हर भेजने वाले की एक प्रविष्टि होती है। किसी खास बदलाव का परिणाम जानने के लिए संदेश के रिएक्शन इवेंट की सूची देखें और सहेजी गई रिएक्शन ID खोजें।

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

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

उसी संदेश ID के साथ WhatsApp रिएक्शन हटाएं को कॉल करें:

await bird.whatsapp.reaction.remove("wam_01krdgeqcxet5s7t44vh8rt9mg");

client.whatsapp.reaction.remove("wam_01krdgeqcxet5s7t44vh8rt9mg")

if err := client.Whatsapp.Reaction.Remove(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg"); err != nil {
	log.Fatal(err)
}

$bird->whatsapp->reaction->remove('wam_01krdgeqcxet5s7t44vh8rt9mg');

bird whatsapp reaction remove wam_01krdgeqcxet5s7t44vh8rt9mg --yes

curl -X DELETE "https://us1.platform.bird.com/v1/whatsapp/messages/wam_01krdgeqcxet5s7t44vh8rt9mg/reaction" \
  -H "Authorization: Bearer $BIRD_API_KEY"

API बिना किसी रिस्पॉन्स बॉडी के 202 लौटाता है। हटाने की प्रक्रिया एसिंक्रोनस रूप से होती है। परिणाम की पुष्टि के लिए संदेश का मौजूदा reactions या उसका रिएक्शन लॉग जांचें। हटाने की लॉग प्रविष्टि में emoji: null होता है। जो रिएक्शन मौजूद नहीं है उसे हटाने से कोई नुकसान नहीं होता। यह ऑपरेशन आपके वर्कस्पेस का रिएक्शन हटाता है, संपर्क का नहीं।

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

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

अगले कदम

• रिएक्शन में बदलाव प्राप्त करें
• रिएक्शन इतिहास पढ़ें
• किसी संदेश को पढ़ा गया चिह्नित करें
• WhatsApp जवाब भेजें