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

जब आप किसी संपर्क का 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. प्राप्त संदेश को पढ़ा गया चिह्नित करें

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

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 छोड़ दें या नई कुंजी का उपयोग करें। पहले वाले अनुरोध को दोबारा चलाने से संकेतक ताज़ा नहीं होता।

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

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

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

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

अगले चरण

• जवाब भेजें
• प्राप्त संदेश पर प्रतिक्रिया दें
• WhatsApp संदेश प्राप्त करें