Cara membangun bot WhatsApp untuk daftar tugas menggunakan API Percakapan Terprogram Bird
Burung
5 Feb 2020
1 min read

Intisari Utama
Bird’s Programmable Conversations API menyatukan WhatsApp, Messenger, dan SMS menjadi satu lapisan komunikasi, menyederhanakan pengembangan bot multi-channel.
Anda dapat dengan cepat membuat prototipe bot daftar tugas WhatsApp menggunakan webhooks dan simple POST requests.
Alat seperti ngrok memungkinkan Anda mengekspos server lokal Anda untuk pengujian webhook tanpa pengaturan hosting yang rumit.
API menangani percakapan di berbagai saluran, memungkinkan satu basis logika untuk WhatsApp, WeChat, dan aplikasi lainnya.
Gunakan endpoint archiveConversation untuk menutup percakapan atau "topik," yang ideal untuk dukungan atau pelacakan alur kerja.
Logika bot dapat mengelola percakapan bersamaan dengan aman dalam memori dengan struktur data sederhana.
Handler webhook yang sama bekerja di berbagai saluran—Bird secara otomatis mengarahkan balasan berdasarkan ID percakapan asal.
Sorotan Q&A
Seberapa sulit membangun bot WhatsApp menggunakan Bird’s API?
Ini sangat mudah mengejutkan. Dengan webhook dan beberapa panggilan API, Anda dapat membangun bot fungsional yang membaca dan membalas pesan dalam hitungan menit.
Apakah saya perlu pengaturan khusus untuk menerima pesan?
Ya — bot harus dapat dijangkau dari internet. Alat seperti ngrok membantu membuat terowongan aman dari mesin lokal Anda.
Dapatkah I menggunakan kode yang sama untuk aplikasi pesan yang berbeda?
Tentu saja. API Percakapan mengabstraksi saluran, sehingga bot Anda dapat berjalan di WhatsApp, WeChat, atau Messenger menggunakan logika yang sama.
Bagaimana cara saya menutup atau mereset chat thread?
Kirim permintaan PATCH ke endpoint percakapan dengan status yang tepat untuk mengarsipkannya. Pesan baru secara otomatis membuka percakapan baru.
Di mana saya dapat menemukan contoh kode?
A: Demo lengkap yang berfungsi — Wabot on GitHub — menunjukkan implementasi penanganan pesan, konkruensi, dan pengarsipan.
Bird baru saja meluncurkan Percakapan yang Dapat Diprogram. Ini memungkinkan perusahaan mencampurkan platform komunikasi seperti WhatsApp, Messenger, dan SMS ke dalam sistem mereka — menggunakan satu API.
Bird baru-baru ini meluncurkan Programmable Conversations. Ini memungkinkan perusahaan menggabungkan platform komunikasi seperti WhatsApp, Messenger dan SMS ke dalam sistem mereka — menggunakan satu API.
Saya ingin mencobanya, jadi saya membangun bot WhatsApp daftar tugas, karena siapa yang tidak membutuhkan daftar tugas otomatis untuk membantu mengatur hari mereka? Mungkin terdengar rumit, tetapi sebenarnya mudah, dan saya ingin memberi tahu Anda semua tentangnya.
Sekarang, saya bekerja di MessageBird, jadi saya bisa langsung mulai membangun. Jika Anda mencoba ini, Anda harus meminta akses awal. Tetapi setelah Anda mengatur saluran WhatsApp, Anda dapat masuk ke Dashboard di situs web MessageBird dan mulai bekerja.
Hal pertama yang saya lakukan adalah membaca dokumen. Saya mengetahui bahwa, untuk mendapatkan pesan dari bot, saya harus menggunakan webhook. Ini berarti bahwa bot saya harus dapat diakses dari internet. Saat membangun API seperti ini, penting untuk mengikuti praktik terbaik versi API untuk mempertahankan keberlanjutannya. Karena saya baru mulai mengkodekannya, saya memutuskan menggunakan ngrok. Ini menciptakan terowongan dari internet publik ke port localhost tercinta Anda 5007. Enggak!
ngrok http 5007 -region eu -subdomain todobot
Selanjutnya, saya perlu melakukan panggilan ke Programmable Conversations API untuk membuat webhook. Ini adalah POST ke https://conversations.messagebird.com/v1/webhooks dan kelihatannya seperti ini:
Bagus. Sekarang Conversations API akan melakukan permintaan POST ke:
https://todobot.eu.ngrok.io/create-hook setiap kali pesan baru dibuat di saluran WhatsApp yang Anda siapkan sebelumnya.
Ini adalah tampilan payload webhook:
Kita ingin menjawab pesan-pesan itu. Mari kita mulai dengan memantulkannya, bagaimana menurutmu?
Sekarang, untuk bagian yang menarik. Lakukan permintaan POST ke:
https://conversations.messagebird.com/v1/conversations/<conversationID>/messages untuk menjawab permintaan tersebut.
Ini dia. Ini semua yang Anda butuhkan untuk membuat bot yang bertingkah seperti manusia berusia 5 tahun.
Sekarang, mari kita dorong untuk membangun daftar tugas lengkap. Pertama, modifikasi fungsi createHookHandler agar memanggil fungsi handleMessage baru alih-alih respond.
handle akan memparsing pesan secara sederhana, melakukan beberapa pekerjaan, dan memilih tanggapan. Mari kita lihat perintah “add”:
Di sini, kami mengatur: list := manager.fetch(whp.Conversation.ID). Pada dasarnya, “manager” adalah peta aman dari aktivitas bersamaan yang memetakan ID percakapan ke daftar tugas.
Daftar tugas adalah potongan string aman dari aktivitas bersamaan. Semuanya di memori!
Hal penting lainnya! Anda dapat mengarsipkan percakapan. Dalam beberapa aplikasi, seperti CRM, penting untuk melacak interaksi tertentu — untuk melacak efektivitas karyawan dukungan pelanggan, misalnya. Conversations API memungkinkan Anda mengarsipkan percakapan untuk “menutup” topik. Jika pengguna/klien mengirim pesan lain, Conversations API akan membuka topik baru secara otomatis.
Selain itu. Melakukan permintaan PATCH ke https://conversations.messagebird.com/v1/conversations/{id} dengan status yang tepat pada body memungkinkan Anda mengarsipkan percakapan dengan id tersebut. Kami melakukan ini dengan perintah “bye”:
archiveConversation akan melakukan permintaan PATCH dan manager.close(whp.Conversation.ID) akan menghapus percakapan daftar tugas.
Tapi hei, Programmable Conversations adalah solusi omni-channel. Bagaimana jika Anda ingin menggunakan kembali kode bot untuk platform lain, seperti WeChat? Pendekatan multi-channel ini adalah bagian dari strategi pengalihan pertanyaan ke saluran yang lebih murah. Bagaimana Anda melakukannya?
Hanya membuat webhook baru untuk menargetkan saluran itu! Webhook yang mengirim permintaan ke url https://todobot.eu.ngrok.io/create-hook yang sama yang kami gunakan untuk WhatsApp!
Ini akan berhasil karena kode penangan selalu menggunakan conversationID dari payload webhook untuk menjawab pesan alih-alih channelID yang sudah dikodekan. Conversations API MessageBird secara otomatis akan menentukan saluran untuk percakapan untuk mengirim pesan Anda.
Apakah Anda ingin membangun bot Anda sendiri? Lihat kode lengkapnya di Github: Wabot di Github, minta akses awal ke WhatsApp dengan mengunjungi halaman WhatsApp dan klik tombol Hubungi Penjualan untuk mengisi formulir. Selamat membuat bot!



