Apa yang dilakukan ekstensi Bird Firebase?

Ini mendengarkan perubahan dalam koleksi Firestore dan mengirimkan pesan melalui API Percakapan Bird setiap kali dokumen baru ditambahkan.

Saluran mana saja yang dapat digunakan ekstensi untuk mengirim pesan?

SMS, WhatsApp, Facebook Messenger, Google Business Messages, Telegram, LINE, Viber, dan saluran lain yang didukung Bird.

Apakah saya perlu server backend untuk mengirim pesan?

Tidak. Ekstensi menangani semua interaksi API—pengiriman pesan menjadi sesederhana menulis dokumen ke Firestore.

Informasi apa yang diperlukan dari akun Bird saya?

Anda akan memerlukan kunci API Bird Anda dan ID saluran (misalnya, untuk SMS).

Bagaimana cara saya menginstal ekstensi?

Melalui konsol Firebase → Ekstensi → Instal “Kirim Pesan dengan Bird,” dan kemudian konfigurasi kunci API dan nama koleksi Anda.

Bagaimana ekstensi tahu kapan harus mengirim pesan?

Ini memantau koleksi Firestore yang ditentukan dan memicu setiap kali dokumen baru dibuat.

Bagaimana format dokumen pesan itu?

Sebuah JSON sederhana yang berisi tujuan, ID saluran, dan teks pesan (atau payload untuk saluran lainnya).

Apa yang terjadi setelah pesan dikirim?

Ekstensi memperbarui dokumen Firestore dengan metadata pengiriman seperti delivery.state, stempel waktu, dan rincian kesalahan (jika ada).

Bagaimana saya bisa memeriksa kesalahan?

Kesalahan muncul di dokumen Firestore yang diperbarui dan juga di log Cloud Functions dalam Firebase.

Bagaimana cara mengamankan koleksi Firestore saya?

Gunakan aturan keamanan Firestore untuk membatasi akses baca/tulis hanya untuk pengguna atau akun layanan yang berwenang.

Bisakah saya menggunakan ekstensi ini untuk alur kerja yang lebih canggih?

Ya — Anda dapat menggabungkannya dengan Flow Builder, API eksternal, atau alat pembelajaran mesin seperti Google Vision untuk membangun pengalaman interaktif dan otomatis.

Apa contoh dunia nyata dari penggunaan ekstensi ini?

Sistem antrean 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

Poin Penting

- Bird | Ekstensi Firebase 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 telah dikonfigurasi, ekstensi mengubahnya menjadi payload pesan yang dapat dibaca dan mengirimkannya melalui API Percakapan Bird, lalu memperbarui dokumen dengan status pengiriman.
- Ekstensi ini menghilangkan kebutuhan untuk integrasi backend dengan API Bird, memungkinkan tim untuk mengirim fitur pesan lebih cepat dengan kode minimal.
- Infrastruktur real-time dan skalabel Firebase dipadukan dengan konektivitas global Bird, memastikan pengiriman pesan yang andal di mana pun di dunia.
- Contoh kasus penggunaan menunjukkan bagaimana restoran dapat mengotomatisasi notifikasi SMS kepada pelanggan yang menunggu tempat—hanya memerlukan penulisan Firestore.
- Pengaturan hanya memerlukan kunci API Bird dan ID SMS (atau saluran lainnya); konfigurasi dilakukan melalui wizard instalasi ekstensi Firebase.
- Pengembang mendefinisikan koleksi Firestore yang didengarkan oleh ekstensi—setiap dokumen baru menjadi pemicu pesan.
- Setelah mengirim, ekstensi memperkaya dokumen Firestore dengan data pengiriman, status, dan pesan kesalahan jika berlaku.
- Praktik terbaik keamanan sangat penting: aturan Firestore harus membatasi akses baca/tulis dengan ketat untuk mencegah penyalahgunaan atau pengiriman pesan yang tidak sah.
- Log Cloud Functions memungkinkan pengembang untuk memeriksa kegagalan pesan, kesalahan eksekusi ekstensi, dan hasil pengiriman.
- Ekstensi ini bekerja tanpa masalah dengan ekosistem Bird yang lebih luas, memungkinkan peningkatan di masa depan seperti alur berbasis AI, pengenalan gambar, atau otomatisasi CRM.
- Integrasi ini menciptakan fondasi 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 Tanya jawab

Apa yang dilakukan ekstensi Bird Firebase?
Ini mendengarkan perubahan dalam koleksi Firestore dan mengirimkan pesan melalui API Percakapan Bird setiap kali dokumen baru ditambahkan.
Saluran mana saja yang dapat digunakan ekstensi untuk mengirim pesan?
SMS, WhatsApp, Facebook Messenger, Google Business Messages, Telegram, LINE, Viber, dan saluran lain yang didukung Bird.
Apakah saya perlu server backend untuk mengirim pesan?
Tidak. Ekstensi menangani semua interaksi API—pengiriman pesan menjadi sesederhana menulis dokumen ke Firestore.
Informasi apa yang diperlukan dari akun Bird saya?
Anda akan memerlukan kunci API Bird Anda dan ID saluran (misalnya, untuk SMS).
Bagaimana cara saya menginstal ekstensi?
Melalui konsol Firebase → Ekstensi → Instal “Kirim Pesan dengan Bird,” dan kemudian konfigurasi kunci API dan nama koleksi Anda.
Bagaimana ekstensi tahu kapan harus mengirim pesan?
Ini memantau koleksi Firestore yang ditentukan dan memicu setiap kali dokumen baru dibuat.
Bagaimana format dokumen pesan itu?
Sebuah JSON sederhana yang berisi tujuan, ID saluran, dan teks pesan (atau payload untuk saluran lainnya).
Apa yang terjadi setelah pesan dikirim?
Ekstensi memperbarui dokumen Firestore dengan metadata pengiriman seperti delivery.state, stempel waktu, dan rincian kesalahan (jika ada).
Bagaimana saya bisa memeriksa kesalahan?
Kesalahan muncul di dokumen Firestore yang diperbarui dan juga di log Cloud Functions dalam Firebase.
Bagaimana cara mengamankan koleksi Firestore saya?
Gunakan aturan keamanan Firestore untuk membatasi akses baca/tulis hanya untuk pengguna atau akun layanan yang berwenang.
Bisakah saya menggunakan ekstensi ini untuk alur kerja yang lebih canggih?
Ya — Anda dapat menggabungkannya dengan Flow Builder, API eksternal, atau alat pembelajaran mesin seperti Google Vision untuk membangun pengalaman interaktif dan otomatis.
Apa contoh dunia nyata dari penggunaan ekstensi ini?
Sistem antrean 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 tambahan yang memungkinkan Anda untuk terus mengoptimalkan dan memperbesar aplikasi Anda. Firebase juga menyimpan ekstensi sumber terbuka yang sudah dikemas untuk membantu Anda mengotomatiskan tugas pengembangan yang umum.

Saat ini, kami sangat senang untuk membahas Bird | ekstensi Firebase.

Kirim pesan dan notifikasi dengan Bird

Ekstensi ini menghubungkan Firebase ke API pesan multikanal Bird, memungkinkan Anda untuk mengirim pesan melalui penulisan Firestore yang sederhana.

Ekstensi Bird di Firebase menghubungkan Anda ke portofolio multikanal terbesar di dunia untuk mengirim pesan dan notifikasi di semua saluran yang disukai pelanggan Anda. Didukung oleh konektivitas global Bird, ini berarti Anda dapat mencapai 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 menyederhanakan proses, ketika Anda menambahkan dokumen ke koleksi Firebase tertentu, ekstensi akan memanfaatkan API Percakapan Bird untuk mengubah dokumen tersebut menjadi teks yang dapat dibaca dan memperbarui dokumen dengan status pengiriman.

Bagaimana cara kerja ekstensi Firebase Bird

Komponen	Apa yang dilakukannya	Siapa yang mengelolanya
Koleksi Firestore	Bertindak sebagai pemicu pesan ketika dokumen ditulis	Pengembang
Ekstensi Firebase	Memantau dokumen baru dan mengeksekusi logika	Firebase
Fungsi Cloud	Mengubah data dokumen menjadi permintaan pesan	Ekstensi
API Percakapan Bird	Mengirim pesan ke saluran yang dipilih	Bird
Pembaruan status pengiriman	Menulis kembali status pesan ke Firestore	Ekstensi
Saluran pesan	SMS, WhatsApp, Messenger, dll.	Infrastruktur Bird

Dalam artikel ini, Anda akan belajar bagaimana Anda dapat mulai mengirim dalam hanya beberapa langkah!

Ekstensi ini menghubungkan Firebase ke API pesan multikanal Bird, memungkinkan Anda untuk mengirim pesan melalui penulisan Firestore yang sederhana.

Bagaimana cara kerja ekstensi Firebase Bird

Komponen	Apa yang dilakukannya	Siapa yang mengelolanya
Koleksi Firestore	Bertindak sebagai pemicu pesan ketika dokumen ditulis	Pengembang
Ekstensi Firebase	Memantau dokumen baru dan mengeksekusi logika	Firebase
Fungsi Cloud	Mengubah data dokumen menjadi permintaan pesan	Ekstensi
API Percakapan Bird	Mengirim pesan ke saluran yang dipilih	Bird
Pembaruan status pengiriman	Menulis kembali status pesan ke Firestore	Ekstensi
Saluran pesan	SMS, WhatsApp, Messenger, dll.	Infrastruktur Bird

Dalam artikel ini, Anda akan belajar bagaimana Anda dapat mulai mengirim dalam hanya beberapa langkah!

Ekstensi ini menghubungkan Firebase ke API pesan multikanal Bird, memungkinkan Anda untuk mengirim pesan melalui penulisan Firestore yang sederhana.

Bagaimana cara kerja ekstensi Firebase Bird

Komponen	Apa yang dilakukannya	Siapa yang mengelolanya
Koleksi Firestore	Bertindak sebagai pemicu pesan ketika dokumen ditulis	Pengembang
Ekstensi Firebase	Memantau dokumen baru dan mengeksekusi logika	Firebase
Fungsi Cloud	Mengubah data dokumen menjadi permintaan pesan	Ekstensi
API Percakapan Bird	Mengirim pesan ke saluran yang dipilih	Bird
Pembaruan status pengiriman	Menulis kembali status pesan ke Firestore	Ekstensi
Saluran pesan	SMS, WhatsApp, Messenger, dll.	Infrastruktur Bird

Dalam artikel ini, Anda akan belajar bagaimana Anda dapat mulai mengirim dalam hanya beberapa langkah!

Contoh kasus penggunaan: notifikasi antrean restoran

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

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

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

Pemilik restoran atau penyambut dapat mendaftarkan pelanggan di antarmuka web atau pelanggan dapat mendaftar sendiri. Ketika meja mereka siap, hanya dengan satu klik tombol dari seorang karyawan restoran, notifikasi akan dikirim kepada pelanggan untuk kembali ke restoran.

Sementara ada banyak cara untuk membangun sistem untuk memberi tahu pengguna, solusi terbaik mengurangi sejumlah pekerjaan yang mungkin dilakukan oleh pelanggan. Ini membantu bisnis memberikan pengalaman yang baik bagi pelanggan mereka.

Itulah mengapa kami akan memanfaatkan ekstensi Bird | Firebase yang baru untuk memastikan pelanggan diberi tahu melalui SMS. Dengan cara ini, pelanggan dapat menikmati waktu tunggu mereka dan tidak stres tentang kehilangan kesempatan, sambil juga memudahkan staf restoran untuk mengelola antrean.

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

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

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

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

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

Cara menyiapkan

Dalam contoh ini, kami akan mengasumsikan Anda memiliki akun Firebase dan Bird.

Prasyarat

Jika Anda tidak memiliki akun Bird, Anda dapat membuat satu di sini.

Komponen pengaturan yang dibutuhkan sebelum instalasi

Persyaratan	Tujuan	Dari mana asalnya
Akun Bird	Mengizinkan akses ke API pesan	Dasbor Bird
Kunci API	Mengesahkan Firebase dengan Bird	Pengaturan API Bird
ID Saluran	Menetapkan saluran mana yang mengirim pesan	Pengaturan saluran Bird
Proyek Firebase	Menampung Firestore dan ekstensi	Konsol Firebase
Aturan Firestore	Mencegah pengiriman pesan yang tidak sah	Aturan keamanan Firebase

Untuk memulai, diperlukan informasi dari akun Bird Anda.

Pertama, Anda perlu kunci API Anda agar ekstensi Firebase dapat berinteraksi dengan API Bird atas nama Anda. Anda dapat menemukan kunci API Anda di pengaturan API Bird. Kedua, Anda akan memerlukan nomor SMS dan saluran SMS yang terinstal. Jika Anda belum memiliki ID Saluran, navigasikan ke halaman pengaturan saluran SMS untuk mendapatkannya.

Instal ekstensi Firebase

Setelah Anda memiliki kedua kunci API Anda dan ID Saluran SMS, kembali ke konsol Firebase Anda dan navigasikan ke tab Ekstensi.

Dari sini, instal ekstensi Firebase [Kirim Pesan dengan 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 kunci API Anda dan nama koleksi yang akan digunakan.

Nama koleksi akan didengarkan oleh ekstensi Firebase.

Ketika 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 API Bird untuk mengirim pesan.

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

Konfigurasi aturannya Firestore dan keamanan

Setelah instalasi ekstensi Anda selesai, navigasikan ke Firestore dalam konsol Firebase. Kemudian, tambahkan ID koleksi yang cocok dengan nama koleksi yang Anda gunakan saat memasang ekstensi.

Catatan: Sangat penting untuk membatasi siapa yang dapat menulis dan membaca koleksi ini. Jika koleksi dibiarkan terbuka, pihak ketiga mungkin dapat membaca nomor pengguna dan bahkan mengirim pesan dengan akun Anda. Kami merekomendasikan untuk menggunakan aturan keamanan Firestore sehingga hanya pengguna tertentu yang memiliki hak istimewa ini dan mengikuti semua praktik keamanan terbaik yang diajukan oleh tim Firebase.

Dalam contoh ini, kami akan mengasumsikan Anda memiliki akun Firebase dan Bird.

Prasyarat

Jika Anda tidak memiliki akun Bird, Anda dapat membuat satu di sini.

Komponen pengaturan yang dibutuhkan sebelum instalasi

Persyaratan	Tujuan	Dari mana asalnya
Akun Bird	Mengizinkan akses ke API pesan	Dasbor Bird
Kunci API	Mengesahkan Firebase dengan Bird	Pengaturan API Bird
ID Saluran	Menetapkan saluran mana yang mengirim pesan	Pengaturan saluran Bird
Proyek Firebase	Menampung Firestore dan ekstensi	Konsol Firebase
Aturan Firestore	Mencegah pengiriman pesan yang tidak sah	Aturan keamanan Firebase

Untuk memulai, diperlukan informasi dari akun Bird Anda.

Instal ekstensi Firebase

Setelah Anda memiliki kedua kunci API Anda dan ID Saluran SMS, kembali ke konsol Firebase Anda dan navigasikan ke tab Ekstensi.

Dari sini, instal ekstensi Firebase [Kirim Pesan dengan Bird].

Selama wizard instalasi, Anda akan diminta untuk menambahkan kunci API Anda dan nama koleksi yang akan digunakan.

Nama koleksi akan didengarkan oleh ekstensi Firebase.

Ketika 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 API Bird untuk mengirim pesan.

Konfigurasi aturannya Firestore dan keamanan

Setelah instalasi ekstensi Anda selesai, navigasikan ke Firestore dalam konsol Firebase. Kemudian, tambahkan ID koleksi yang cocok dengan nama koleksi yang Anda gunakan saat memasang ekstensi.

Dalam contoh ini, kami akan mengasumsikan Anda memiliki akun Firebase dan Bird.

Prasyarat

Jika Anda tidak memiliki akun Bird, Anda dapat membuat satu di sini.

Komponen pengaturan yang dibutuhkan sebelum instalasi

Persyaratan	Tujuan	Dari mana asalnya
Akun Bird	Mengizinkan akses ke API pesan	Dasbor Bird
Kunci API	Mengesahkan Firebase dengan Bird	Pengaturan API Bird
ID Saluran	Menetapkan saluran mana yang mengirim pesan	Pengaturan saluran Bird
Proyek Firebase	Menampung Firestore dan ekstensi	Konsol Firebase
Aturan Firestore	Mencegah pengiriman pesan yang tidak sah	Aturan keamanan Firebase

Untuk memulai, diperlukan informasi dari akun Bird Anda.

Instal ekstensi Firebase

Setelah Anda memiliki kedua kunci API Anda dan ID Saluran SMS, kembali ke konsol Firebase Anda dan navigasikan ke tab Ekstensi.

Dari sini, instal ekstensi Firebase [Kirim Pesan dengan Bird].

Selama wizard instalasi, Anda akan diminta untuk menambahkan kunci API Anda dan nama koleksi yang akan digunakan.

Nama koleksi akan didengarkan oleh ekstensi Firebase.

Ketika 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 API Bird untuk mengirim pesan.

Konfigurasi aturannya Firestore dan keamanan

Setelah instalasi ekstensi Anda selesai, navigasikan ke Firestore dalam konsol Firebase. Kemudian, tambahkan ID koleksi yang cocok dengan nama koleksi yang Anda gunakan saat memasang ekstensi.

Cara mengirim pesan

Koleksi pesan yang kita atur selama pengaturan akan menyimpan semua pesan Anda. Untuk mengirim pesan SMS, Anda perlu menambahkan dokumen ke koleksi yang Anda beri nama dalam wizard menggunakan format ini:

Format dokumen pesan

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 Burung akan berinteraksi dengan API Burung dan memperbarui dokumen dengan bidang tambahan seperti di bawah ini. Bidang delivery.state di bawah ini menggambarkan status berbeda yang dapat dimiliki 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 mengirim pesan mengakibatkan kegagalan, bidang state akan menjadi ERROR, dan bidang error akan diisi dengan string pesan kesalahan.

Adalah mungkin juga untuk mengamati kesalahan dari ekstensi dan penggunaannya melalui tab fungsi Cloud di konsol Firebase:

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

Format dokumen pesan

Jika mengirim pesan mengakibatkan kegagalan, bidang state akan menjadi ERROR, dan bidang error akan diisi dengan string pesan kesalahan.

Adalah mungkin juga untuk mengamati kesalahan dari ekstensi dan penggunaannya melalui tab fungsi Cloud di konsol Firebase:

Format dokumen pesan

Jika mengirim pesan mengakibatkan kegagalan, bidang state akan menjadi ERROR, dan bidang error akan diisi dengan string pesan kesalahan.

Adalah mungkin juga untuk mengamati kesalahan dari ekstensi dan penggunaannya 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.

Mulai dengan ekstensi Bird Firebase

Sekarang, Anda tidak lagi memerlukan integrasi API backend langsung untuk berinteraksi dengan Bird API.

Anda dapat memperlancar implementasi melalui ekstensi Firebase dan membuat pengiriman notifikasi semudah operasi penulisan dokumen — tidak peduli saluran komunikasi yang ingin Anda gunakan.

Ini baru 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 untuk membuat pengalaman yang lebih dinamis. Untuk kasus penggunaan yang lebih maju, Anda bahkan dapat mengintegrasikan Flow Builder dengan API eksternal seperti Google Vision API dan Cloud Functions untuk menambahkan pengenalan gambar yang didukung AI ke interaksi pelanggan Anda. Dengan Flow Builder, Anda juga dapat mengotomatisasi alur kerja CRM seperti membuat prospek dan kasus di Salesforce langsung dari interaksi pelanggan.

Mengikuti kasus penggunaan di atas, Flow Builder akan memungkinkan Anda menambahkan fitur balasan pada notifikasi yang dikirim, yang memungkinkan pelanggan membalas dengan kata kunci atau frasa untuk membatalkan reservasi mereka. Tapi itu untuk artikel masa depan! 🙂

Jika Anda memiliki kasus penggunaan lain yang Anda minati, insinyur solusi kami di sini untuk membantu Anda. Silakan hubungi tim kami dan beri tahu kami!