WhatsAppApi

Tambahkan pesan WhatsApp ke aplikasi Anda.

Kirim pembaruan yang berguna, terima balasan pelanggan, dan ikuti setiap pesan melalui siklus hidupnya. Gunakan API dan SDK Bird yang dipublikasikan untuk menghubungkan WhatsApp ke aplikasi dan alur kerja yang sudah diandalkan pelanggan Anda.

Mulai membangun dengan WhatsApp Baca panduan pengiriman

Siapkan dengan agen Anda:

CursorCopied!

const msg = await bird.whatsapp.send({
  to: "+15551234567",
  template: {
    slug: "bird_otp",
    components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
  },
});
console.log(msg.id, msg.status);

Pilih SDK Anda atau gunakan HTTP secara langsung. Contoh-contoh ini dihasilkan dari operasi Bird yang dipublikasikan.

Satu permintaan yang jelas

Pilih pesan yang tepat untuk momennya.

Gunakan template yang disetujui untuk pesan yang memenuhi syarat yang dimulai oleh bisnis, atau respons bebas yang didukung di dalam jendela layanan pelanggan. Pastikan pengirim, penerima, bahasa, dan konten dinyatakan secara eksplisit.

Gunakan contoh yang dipublikasikan

Mulai dari contoh SDK atau HTTP yang dihasilkan di atas. Ikuti bentuk konten dan validasi operasi yang sebenarnya, bukan menebak metode dari ilustrasi pemasaran.

Atur laju beban kerja

Gunakan respons pembatasan laju permintaan dan antrean terbatas. Saat aplikasi melakukan fanout pesan, simpan catatan permanen setiap penerima dan permintaan yang dimaksud.

Siklus hidup yang bisa Anda pahami

Ikuti penerimaan hingga respons pelanggan.

Permintaan yang diterima API mulai diproses. Penerimaan pesan oleh Meta, sampainya pesan ke penerima, dan pembaruan status dibaca merupakan tahap berikutnya; tahap-tahap ini tidak menjamin bahwa pelanggan telah menyelesaikan tugas bisnis Anda.

Rekonsiliasi dengan pembacaan pesan

Konsumsi webhook yang relevan dan ambil catatan pesan saat menyelidiki kesenjangan. Pisahkan percobaan yang belum pasti dari kegagalan yang terkonfirmasi.

Buat keputusan retry yang tepat

Gunakan perlindungan permintaan dan klasifikasi error yang terdokumentasi. Jangan asumsikan percobaan provider yang belum pasti dapat diulang tanpa batas.

Satu pesan, dari permintaan hingga responsContoh alur

Diterima

Bird menerima permintaan dan mengembalikan identitas pesannya.

Diproses

Pesan bergerak melalui alur pengiriman.

Terkirim atau dibaca

Observasi dari penyedia memperbarui catatan pesan jika tersedia.

Terima kasih! Saya akan mengambilnya besok.

Tangani penolakan, kegagalan, dan observasi yang tidak tersedia sebagai bagian dari integrasi yang sama.

Sebuah percakapan, bukan sekadar endpoint

Bawa konteks yang berguna ke dalam balasan.

Gunakan identifier balasan tombol atau daftar yang eksplisit serta state percakapan di aplikasi Anda. Balasan dapat mengutip pesan sebelumnya, tetapi referensi tersebut bersifat opsional dan mungkin tidak tersedia.

Simpan metadata pada tempatnya

Metadata keluar milik catatan keluar. Jangan asumsikan metadata tersebut disalin ke pesan masuk dari pelanggan.

Hubungkan alat dengan izin yang sama

CLI dan MCP dapat membantu developer mengoperasikan channel. Keduanya tetap tunduk pada akses workspace, kepemilikan sender, dan aturan pengiriman yang sama.

Pertanyaan WhatsApp API

Apakah permintaan yang diterima berarti pesan telah terkirim?

Tidak. Diterimanya permintaan oleh API, diterimanya pesan oleh Meta, sampainya pesan ke penerima, dan status dibaca merupakan kejadian yang berbeda. Konfirmasikan status pesan yang relevan dan hasil bisnis secara terpisah.

Bisakah saya mengirim pesan bebas kapan saja?

Balasan bebas bergantung pada jendela layanan pelanggan dan tipe konten yang didukung. Di luar jendela tersebut, gunakan template yang disetujui dan memenuhi syarat.

Apakah ada endpoint batch WhatsApp?

API pesan yang dipublikasikan mengirim pesan satu per satu. Atur laju fanout aplikasi menggunakan batas yang didokumentasikan; jangan berasumsi bahwa endpoint broadcast email juga mengirim WhatsApp.

Bagaimana cara mencocokkan balasan interaktif ke aplikasi saya?

Gunakan pengidentifikasi balasan eksplisit dengan status percakapan atau tugas yang Anda simpan. Referensi pesan yang dikutip dapat membantu jika tersedia, tetapi metadata keluar tidak secara otomatis diwariskan oleh balasan.

Hubungkan perjalanan lengkap

Panduan WhatsApp APIIkuti langkah setup, keputusan operasional, dan langkah verifikasi.Template WhatsAppBuat pesan yang dapat digunakan ulang dan ikuti persetujuan berdasarkan bahasa.Percakapan WhatsAppGabungkan konteks pelanggan, AI, dan tim Anda dalam satu percakapan.Analitik WhatsAppPantau pengiriman, respons pelanggan, dan hasil bisnis.Pustaka referensi WhatsAppJelajahi panduan implementasi, jawaban penjelasan, dan perbandingan.Platform WhatsAppJelajahi produk yang terhubung dan pilih kapabilitas berikutnya.

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 Ikuti jalur pembelajaranBuild your first integration

Coba praktiknya dan dapatkan ringkasan implementasi

Jadikan permintaan pertama bagian dari integrasi yang berfungsi.

Siapkan workspace Anda, gunakan contoh yang telah dipublikasikan, dan periksa responsnya. Hubungkan balasan dan event pengiriman sebelum memperbesar traffic.