Mulai dengan ekstensi Bird di Firebase
Burung
1 Jun 2021
Ekstensi Firebase
1 min read
Intisari Utama
Bird | Firebase Extension memungkinkan pengembang untuk mengirim pesan dan notifikasi melalui SMS, WhatsApp, Messenger, Google Business Messages, Telegram, LINE, Viber, dan lainnya—langsung dari penulisan dokumen Firestore.
Ketika dokumen baru ditambahkan ke koleksi Firestore yang dikonfigurasi, ekstensi mengubahnya menjadi payload pesan yang dapat dibaca dan mengirimkannya melalui Bird's Conversations API, kemudian memperbarui dokumen dengan status pengiriman.
Ekstensi ini menghilangkan kebutuhan untuk integrasi backend dengan Bird's API, memungkinkan tim untuk memasang fitur pesan lebih cepat dengan kode minimal.
Infrastruktur real-time dan skala Firebase dipasangkan dengan konektivitas global Bird, memastikan pengiriman pesan yang dapat diandalkan di manapun di dunia.
Contoh penggunaan menunjukkan bagaimana restoran dapat mengotomatisasi notifikasi SMS kepada pelanggan yang menunggu meja—hanya memerlukan penulisan Firestore.
Pengaturan hanya memerlukan kunci API Bird dan ID SMS (atau saluran lain); konfigurasi dilakukan melalui wizard pemasangan ekstensi Firebase.
Pengembang menentukan koleksi Firestore yang didengarkan oleh ekstensi—setiap dokumen baru menjadi pemicu pesan.
Setelah pengiriman, ekstensi memperkaya dokumen Firestore dengan data pengiriman, status, dan pesan kesalahan jika berlaku.
Praktik terbaik keamanan sangat penting: aturan Firestore harus membatasi akses bacaan/tulisan secara ketat untuk mencegah penyalahgunaan atau pengiriman pesan tanpa izin.
Log Cloud Functions memungkinkan pengembang untuk memeriksa kegagalan pesan, kesalahan eksekusi ekstensi, dan hasil pengiriman.
Ekstensi bekerja dengan lancar dengan ekosistem Bird yang lebih luas, memungkinkan peningkatan di masa depan seperti alur berbasis AI, pengenalan gambar, atau otomatisasi CRM.
Integrasi ini menciptakan dasar untuk pengalaman yang lebih kaya, seperti memungkinkan pelanggan membalas dengan kata kunci, membangun fitur antrean restoran, atau menghubungkan ke API eksternal melalui Flow Builder.
Sorotan Q&A
Apa yang dilakukan ekstensi Bird Firebase?
Ini mendengarkan perubahan dalam koleksi Firestore dan mengirim pesan melalui Bird’s Conversations API setiap kali dokumen baru ditambahkan.
Melalui saluran mana ekstensi dapat mengirim pesan?
SMS, WhatsApp, Facebook Messenger, Google Business Messages, Telegram, LINE, Viber, dan saluran lain yang didukung Bird.
Apakah saya memerlukan backend server untuk mengirim pesan?
Tidak. Ekstensi menangani semua interaksi API—pengiriman pesan menjadi semudah menulis dokumen ke Firestore.
Informasi apa yang diperlukan dari akun Bird saya?
Anda memerlukan API key Bird dan ID saluran (misalnya, untuk SMS).
Bagaimana cara menginstal ekstensi?
Melalui konsol Firebase → Extensions → Instal "Send Messages with Bird," dan kemudian konfigurasikan API key dan nama koleksi Anda.
Bagaimana ekstensi tahu kapan mengirim pesan?
Ini memantau koleksi Firestore yang ditentukan dan memicu setiap kali dokumen baru dibuat.
Seperti apa format dokumen pesan?
Sebuah JSON sederhana yang berisi tujuan, ID saluran, dan teks pesan (atau payload untuk saluran lainnya).
Apa yang terjadi setelah sebuah pesan dikirim?
Ekstensi memperbarui dokumen Firestore dengan metadata pengiriman seperti delivery.state, stempel waktu, dan detail kesalahan (jika ada).
Bagaimana saya dapat memeriksa kesalahan?
Kesalahan muncul dalam dokumen Firestore yang diperbarui dan juga dalam log Cloud Functions di Firebase.
Bagaimana saya mengamankan koleksi Firestore saya?
Gunakan aturan keamanan Firestore untuk membatasi akses baca/tulis hanya kepada pengguna atau akun layanan yang berwenang.
Dapatkah saya menggunakan ekstensi ini untuk alur kerja yang lebih canggih?
Ya — Anda dapat memasangkannya dengan Flow Builder, API eksternal, atau alat pembelajaran mesin seperti Google Vision untuk membangun pengalaman interaktif dan otomatis.
Apa contoh nyata penggunaan extension ini?
Sistem antrian restoran yang mengirimkan notifikasi SMS ketika meja sudah siap — dipicu hanya dengan menambahkan dokumen Firestore.
Firebase memungkinkan Anda untuk dengan cepat mengembangkan dan menerapkan aplikasi berkualitas tinggi, dipasangkan dengan fungsionalitas lengkap yang memungkinkan Anda untuk terus mengoptimalkan dan meningkatkan skala aplikasi Anda. Firebase juga menyediakan ekstensi open-source yang sudah dikemas sebelumnya untuk membantu Anda mengotomatisasi tugas pengembangan umum.
Hari ini, kami dengan senang hati membahas Bird | Firebase extension.
Kirim pesan dan notifikasi dengan Bird
Ekstensi Bird di Firebase menghubungkan Anda ke portofolio omnichannel terbesar di dunia untuk mengirim pesan dan notifikasi di semua saluran yang disukai pelanggan Anda. Didukung oleh konektivitas global Bird, ini berarti Anda dapat menjangkau pelanggan Anda dengan cepat — dan di mana saja di dunia!
Untuk lebih merampingkan proses, ketika Anda menambahkan dokumen ke koleksi Firebase tertentu, ekstensi akan memanfaatkan Bird’s Conversations API untuk mengonversi dokumen tersebut menjadi teks yang dapat dibaca dan memperbarui dokumen dengan status pengirimannya.
Dalam artikel ini, Anda akan belajar bagaimana Anda bisa mulai mengirim hanya dalam beberapa langkah!
Contoh kasus penggunaan
Cara untuk memulai
Dalam contoh ini, kami akan mengasumsikan Anda memiliki akun Firebase dan Bird.
Jika Anda belum memiliki akun Bird, Anda dapat membuatnya di sini.
Untuk memulai, dibutuhkan informasi dari akun Bird Anda.
Pertama, Anda akan memerlukan API key Anda untuk memungkinkan ekstensi Firebase berinteraksi dengan Bird API atas nama Anda. Anda dapat menemukan API key Anda di pengaturan Bird API. Kedua, Anda akan memerlukan nomor SMS dan saluran SMS yang terinstal. Jika Anda belum memiliki Channel ID, navigasilah ke halaman pengaturan saluran SMS untuk mendapatkannya.
Setelah Anda memiliki kedua API key dan SMS Channel ID Anda, kembali ke konsol Firebase Anda dan navigasi ke tab Ekstensi.
Dari sini, instal ekstensi Firebase [Send Messages with Bird].
Selama wizard instalasi, Anda akan diminta untuk menambahkan API key Anda dan nama koleksi yang akan digunakan.
Nama koleksi akan didengarkan oleh ekstensi Firebase.
Ketika sebuah dokumen ditambahkan ke koleksi, itu akan memicu ekstensi.
Di balik layar, ekstensi adalah Fungsi Cloud, yang mendengarkan perubahan pada koleksi yang ditentukan, membaca dokumen yang ditambahkan, dan berinteraksi dengan Bird API untuk mengirim pesan.
Setelah instalasi ekstensi Anda selesai, navigasi ke Firestore dalam konsol Firebase. Kemudian, tambahkan ID koleksi yang sesuai dengan nama koleksi yang Anda gunakan saat menginstal ekstensi.
Catatan: Sangat penting untuk membatasi siapa yang dapat menulis dan membaca ke koleksi ini. Jika koleksi dibiarkan terbuka, pihak ketiga mungkin dapat membaca nomor pengguna dan bahkan mengirim pesan dengan akun Anda. Kami menyarankan menggunakan aturan keamanan Firestore sehingga hanya pengguna tertentu yang memiliki hak istimewa ini dan mengikuti semua praktik keamanan terbaik yang disarankan oleh tim Firebase.
Cara mengirim pesan
Koleksi messages yang kami konfigurasikan selama pengaturan akan menyimpan semua pesan Anda. Untuk mengirim pesan SMS, Anda perlu menambahkan dokumen ke koleksi yang Anda beri nama di wizard menggunakan format ini:
Setelah dokumen ditambahkan ke koleksi, ekstensi Bird kemudian akan berinteraksi dengan Bird API dan memperbarui dokumen dengan bidang tambahan seperti di bawah ini. Bidang delivery.state di bawah ini menggambarkan berbagai status yang dapat dialami oleh pesan.
Jika pengiriman pesan mengakibatkan kegagalan, bidang state akan menjadi ERROR, dan bidang error akan diisi dengan string pesan kesalahan.
Juga dimungkinkan untuk mengamati kesalahan dari ekstensi dan penggunaan melalui tab fungsi Cloud di konsol Firebase:
Pengalaman untuk Anda dan pelanggan Anda
Pasang ekstensi Bird Firebase untuk berkomunikasi dengan pelanggan Anda — lebih mudah dari sebelumnya
Sekarang, Anda tidak lagi memerlukan integrasi API backend langsung untuk berinteraksi dengan Bird API.
Anda dapat menyederhanakan implementasi melalui ekstensi Firebase dan membuat pengiriman notifikasi semudah operasi tulis dokumen — tidak peduli saluran komunikasi yang ingin Anda gunakan.
Ini hanya menggores permukaan dari apa yang dapat Anda lakukan dengan ekstensi dan API kami.
Kami menawarkan banyak saluran dan kami juga memiliki editor visual yang sangat kuat di Flow Builder yang memungkinkan Anda menciptakan pengalaman yang lebih dinamis. Untuk kasus penggunaan lanjutan, Anda bahkan dapat mengintegrasikan Flow Builder dengan API eksternal seperti Google Vision API dan Cloud Functions untuk menambahkan pengenalan gambar bertenaga AI pada interaksi pelanggan Anda. Dengan Flow Builder, Anda juga dapat mengotomatisasi alur kerja CRM seperti membuat lead dan kasus di Salesforce langsung dari interaksi pelanggan.
Mengikuti kasus penggunaan di atas, Flow Builder akan memungkinkan Anda menambahkan fitur balasan pada notifikasi yang dikirimkan, yang memungkinkan pelanggan untuk membalas dengan kata kunci atau frasa untuk membatalkan reservasi mereka. Namun itu untuk artikel mendatang! 🙂
Jika Anda memiliki kasus penggunaan lain yang Anda minati, insinyur solusi kami siap membantu Anda. Silakan hubungi tim kami dan beri tahu kami!
