Mengirim reaksi WhatsApp

Bereaksi terhadap pesan kontak dengan emoji, misalnya jempol untuk mengonfirmasi balasan mereka. Anda dapat mengganti reaksi atau menghapusnya nanti.

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 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 SDK TypeScript, Python, Go, atau PHP. Untuk contoh CLI, instal dan autentikasi CLI dengan akses tulis WhatsApp. Gunakan host API sesuai region workspace Anda dalam permintaan cURL.

1. Menambahkan reaksi

Panggil React to a WhatsApp message dengan satu emoji:

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 mengembalikan 202 dengan id (war_…) dan emoji reaksi yang diterima. Simpan ID reaksi untuk menemukan hasilnya di log reaksi. Penerimaan tidak mengonfirmasi bahwa WhatsApp menerapkan reaksi tersebut.

Anda hanya memiliki satu reaksi per pesan. Untuk menggantinya, ulangi permintaan PUT dengan emoji berbeda. Reaksi tidak dikenakan biaya.

2. Memeriksa hasil reaksi

Retrieve the message untuk melihat reactions saat ini, dengan satu entri per pengirim. Untuk hasil perubahan tertentu, list the message's reaction events dan temukan ID reaksi yang disimpan.

Log reaksi mencatat hasil akhir: sent berarti WhatsApp menerima perubahan Anda, failed berarti WhatsApp menolaknya, dan rejected berarti Bird menolaknya sebelum transmisi. Periksa error pada event untuk perubahan yang gagal atau ditolak. Reaksi yang masih tertunda belum memiliki entri log. Reaksi tidak memiliki tanda terima pengiriman atau baca, dan tidak ada webhook reaksi keluar.

3. Menghapus reaksi Anda

Panggil Remove a WhatsApp reaction dengan ID pesan yang sama:

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 mengembalikan 202 tanpa body respons. Penghapusan diproses secara asinkron; periksa reactions pesan saat ini atau log reaksinya untuk mengonfirmasi hasilnya. Entri log penghapusan memiliki emoji: null. Menghapus reaksi yang tidak ada aman dilakukan, dan operasi ini menghapus reaksi workspace Anda, bukan reaksi kontak.

Pemecahan masalah

404 (E15071): Periksa ID pesan target dan workspace. Bird menyimpan referensi pesan yang diperlukan untuk menambah atau menghapus reaksi selama 15 hari.
422 (E01001): Gunakan pesan yang diterima dan satu emoji. Anda tidak dapat bereaksi terhadap pesan yang dikirim workspace Anda. Emoji gabungan dihitung sebagai satu emoji; dua emoji terpisah tidak.
Reaksi tidak berubah setelah 202: Periksa log reaksi untuk perubahan yang gagal atau ditolak. Respons HTTP yang berhasil mengonfirmasi penerimaan untuk diproses.

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