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.

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!

Communication app icons with platforms including WhatsApp, Telegram, Instagram, Messenger, and various social media apps.

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

Ketika saya mendengar bahwa rekan-rekan saya bekerja pada pembuatan ekstensi Firebase yang memungkinkan Anda untuk dengan mudah mengintegrasikan pengiriman pesan dalam aplikasi Anda, saya harus mencobanya dan membuat sesuatu dengannya.

Catatan: Anda dapat menemukan ekstensi Bird di Firebase di sini.

Untuk membawa ekstensi ke dalam konteks, kita akan mempertimbangkan contoh aplikasi kecil untuk mengelola antrian di sebuah restoran.

Pemilik restoran atau tuan rumah dapat mendaftarkan pelanggan di antarmuka web atau pelanggan dapat mendaftarkan diri sendiri. Ketika meja mereka siap, dengan hanya sekali klik tombol dari karyawan restoran, notifikasi akan dikirimkan kepada pelanggan untuk kembali ke restoran.

Sementara ada banyak cara untuk membangun sistem untuk memberi notifikasi kepada pengguna, solusi terbaik mengurangi sebanyak mungkin pekerjaan dari pelanggan. Ini membantu bisnis memberikan pengalaman yang sangat baik kepada pelanggan mereka.

Itulah mengapa kita akan menggunakan ekstensi Bird | Firebase baru untuk memastikan pelanggan diberitahu melalui SMS. Dengan cara ini, pelanggan dapat menikmati waktu menunggu mereka dan tidak cemas akan ketinggalan, sambil juga memudahkan staf restoran untuk mengelola antrian.

Contoh ini mengirim notifikasi SMS, di dalam ekstensi Anda dapat menggunakan saluran apa pun yang diinginkan pelanggan (WhatsApp, Pesan Bisnis Google, Facebook Messenger, Telegram, Line, Viber, dll.) sehingga Anda dapat menyesuaikan notifikasi dengan preferensi pelanggan.

Catatan: Anda dapat menemukan ekstensi Bird di Firebase di sini.

Untuk membawa ekstensi ke dalam konteks, kita akan mempertimbangkan contoh aplikasi kecil untuk mengelola antrian di sebuah restoran.

Catatan: Anda dapat menemukan ekstensi Bird di Firebase di sini.

Untuk membawa ekstensi ke dalam konteks, kita akan mempertimbangkan contoh aplikasi kecil untuk mengelola antrian di sebuah restoran.

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].

Firebase Extensions marketplace showing the 'Send Messages with Bird' integration among other available extensions, allowing developers to connect Firebase with Bird's messaging API.

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.

Configuration page for installing the MessageBird Firebase extension, showing setup fields for API key, message collection name, and deployment options.

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.

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.

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.

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.

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.

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:

Code snippet showing the JSON structure for sending messages through Bird API with fields for channel ID, recipient, and message content.

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.

JavaScript code example showing how to send SMS notifications through Firebase and Bird integration, with template for restaurant table readiness alerts and delivery status monitoring.

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:

Firebase Cloud Functions dashboard showing the deployed MessageBird extension triggered by document writes to the messages collection.

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:

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

Confirmation page showing a customer named Jim has been added to the restaurant waitlist, with notification that an SMS will be sent when their table is ready.

Restaurant staff interface showing waitlist with customers and their party sizes, where three parties have been notified and Jim's party of four is ready to be notified.

Restaurant management interface showing all waitlisted customers have been notified, including Jim's party of four who was previously pending notification.

Mobile phone screen showing an SMS notification from a restaurant informing Jim that his table is almost ready.

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!