Tandai pesan sebagai sudah dibaca

Konfirmasi pesan WhatsApp dari kontak saat Anda telah membacanya atau mulai menangani permintaan mereka. Anda juga dapat menampilkan indikator mengetik saat menyiapkan balasan.

Prasyarat

Anda memerlukan kunci API dengan izin tulis WhatsApp dan ID pesan Bird (wam_…) dari pesan yang diterima workspace Anda. Gunakan data.whatsapp_id dari webhook whatsapp.received, atau id pesan dari log WhatsApp.

Ganti contoh ID pesan dengan ID pesan yang diterima workspace Anda. Inisialisasi klien untuk bahasa Anda menggunakan panduan TypeScript, Python, Go, atau PHP SDK. Untuk contoh CLI, instal dan autentikasi CLI dengan akses tulis WhatsApp. Gunakan host API untuk region workspace Anda dalam permintaan cURL.

1. Tandai pesan yang diterima sebagai sudah dibaca

Panggil Tandai pesan sebagai sudah dibaca dengan ID pesan yang diterima. WhatsApp juga menandai pesan sebelumnya dalam percakapan yang sama sebagai sudah dibaca, jadi pilih pesan yang mewakili sejauh mana Anda telah membaca.

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 '{}'

Permintaan yang berhasil mengembalikan 202 dengan typing_indicator: false. Konfirmasi diterima untuk diproses; respons tidak mengonfirmasi bahwa kontak telah melihatnya. Konfirmasi baca tidak menghasilkan pesan keluar yang ditagih.

2. Tampilkan indikator mengetik saat menyiapkan balasan

Untuk menandai pesan sebagai sudah dibaca dan menampilkan indikator mengetik, kirim typing_indicator: true dalam permintaan yang sama:

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}'

WhatsApp menghapus indikator saat Anda mengirim pesan atau setelah 25 detik. Mengulangi panggilan ini aman. Untuk memperbarui indikator mengetik, hapus Idempotency-Key atau gunakan kunci baru; mengulang permintaan sebelumnya tidak memperbarui indikator.

3. Periksa pesan yang diterima

Ambil pesan untuk memeriksa read_at. Setelah WhatsApp menerima konfirmasi, pesan yang diterima dapat memuat timestamp ini sambil mempertahankan status received. Tidak ada resource konfirmasi terpisah atau webhook pengiriman untuk dilacak.

Pemecahan masalah

404 (E15071): Periksa ID pesan dan workspace. Bird dapat menemukan pesan untuk konfirmasi selama 15 hari; pesan yang lebih lama tidak dapat ditandai sudah dibaca melalui operasi ini.
422 (E15074): Gunakan pesan masuk yang dapat dikonfirmasi oleh workspace Anda. Pesan keluar bukan target yang valid.
503 (E15073): Coba lagi setelah kegagalan sementara dalam menemukan pesan.

Langkah selanjutnya

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaConnecting WhatsApp to Bird: from buying a number to a live channel Pahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builder Jelajahi kemampuannyaWhatsApp

Coba praktiknya dan dapatkan ringkasan implementasi