संदेश को पढ़ा हुआ चिह्नित करें

किसी संपर्क के WhatsApp संदेश को तब पावती दें जब आपने उसे पढ़ लिया हो या उनके अनुरोध पर काम शुरू कर दिया हो। आप उत्तर तैयार करते समय टाइपिंग इंडिकेटर भी दिखा सकते हैं।

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

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

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

1. प्राप्त संदेश को पढ़ा हुआ चिह्नित करें

प्राप्त message ID के साथ Mark a message read कॉल करें। WhatsApp उसी conversation में पहले के संदेशों को भी पढ़ा हुआ चिह्नित करता है, इसलिए वह संदेश चुनें जो दर्शाता है कि आपने कहाँ तक पढ़ा है।

const acknowledgement = await bird.whatsapp.markRead("wam_01krdgeqcxet5s7t44vh8rt9mg", {});
console.log(acknowledgement.typing_indicator);

ack = client.whatsapp.mark_read("wam_01krdgeqcxet5s7t44vh8rt9mg")
print(ack.typing_indicator)

ack, err := client.Whatsapp.MarkRead(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg", bird.WhatsappMarkReadParams{})
if err != nil {
	log.Fatal(err)
}
fmt.Println(ack.TypingIndicator)

use MessageBird\Wire\Model\WhatsAppReadReceiptRequest;

$ack = $bird->whatsapp->markRead(
    'wam_01krdgeqcxet5s7t44vh8rt9mg',
    new WhatsAppReadReceiptRequest(),
);
var_dump($ack->getTypingIndicator());

bird whatsapp mark-read wam_01krdgeqcxet5s7t44vh8rt9mg

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

एक सफल अनुरोध typing_indicator: false के साथ 202 लौटाता है। पावती प्रोसेसिंग के लिए स्वीकार की जाती है; प्रतिक्रिया इसकी पुष्टि नहीं करती कि संपर्क ने इसे देखा है। पढ़ने की पावतियाँ कोई बिल योग्य आउटबाउंड संदेश नहीं बनातीं।

2. उत्तर तैयार करते समय टाइपिंग दिखाएँ

संदेश को पढ़ा हुआ चिह्नित करने और टाइपिंग दिखाने के लिए, उसी अनुरोध में typing_indicator: true पास करें:

await bird.whatsapp.markRead("wam_01krdgeqcxet5s7t44vh8rt9mg", {
  typing_indicator: true,
});

ack = client.whatsapp.mark_read("wam_01krdgeqcxet5s7t44vh8rt9mg", typing_indicator=True)
print(ack.typing_indicator)

ack, err := client.Whatsapp.MarkRead(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg", bird.WhatsappMarkReadParams{
	TypingIndicator: bird.Ptr(true),
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(ack.TypingIndicator)

$ack = $bird->whatsapp->markRead(
    'wam_01krdgeqcxet5s7t44vh8rt9mg',
    (new WhatsAppReadReceiptRequest())->setTypingIndicator(true),
);
var_dump($ack->getTypingIndicator());

bird whatsapp mark-read wam_01krdgeqcxet5s7t44vh8rt9mg --typing-indicator=true

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages/wam_01krdgeqcxet5s7t44vh8rt9mg/read" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"typing_indicator": true}'

जब आप कोई संदेश भेजते हैं या 25 सेकंड के बाद WhatsApp इंडिकेटर को हटा देता है। कॉल दोहराना सुरक्षित है। टाइपिंग रिफ़्रेश करने के लिए Idempotency-Key हटाएँ या नई key का उपयोग करें; पहले का अनुरोध दोबारा भेजने से इंडिकेटर रिफ़्रेश नहीं होता।

3. प्राप्त संदेश की जाँच करें

read_at की जाँच करने के लिए संदेश प्राप्त करें। WhatsApp द्वारा पावती स्वीकार करने के बाद, प्राप्त संदेश अपनी received स्थिति बनाए रखते हुए यह टाइमस्टैम्प ले सकता है। ट्रैक करने के लिए कोई अलग पावती संसाधन या डिलीवरी webhook नहीं है।

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

404 (E15071): Message ID और वर्कस्पेस जाँचें। Bird पावती के लिए संदेश को 15 दिनों तक रिज़ॉल्व कर सकता है; इससे पुराने संदेश को इस ऑपरेशन से पढ़ा हुआ चिह्नित नहीं किया जा सकता।
422 (E15074): ऐसा इनबाउंड संदेश उपयोग करें जिसे आपका वर्कस्पेस पावती दे सके। कोई आउटबाउंड संदेश पात्र लक्ष्य नहीं है।
503 (E15073): संदेश रिज़ॉल्व करने में अस्थायी विफलता के बाद फिर से प्रयास करें।