
Mengirim Pesan dengan MessageBird
Made by MessageBird
Mengirim pesan dan notifikasi menggunakan MessageBird Conversations API.
Cara kerja ekstensi ini
Gunakan ekstensi ini untuk mengirimkan pesan omnichannel (SMS, WhatsApp, Business Messages Google, Messenger, Telegram, Line, Viber, dll.) dengan MessageBird. Saat dokumen ditambahkan ke koleksi Firestore tertentu, ekstensi ini akan menggunakan MessageBird Conversations API untuk mengubah dokumen tersebut menjadi pesan dan memperbarui dokumen dengan status pengiriman.
db.collection('YOUR_DOCUMENT_COLLECTION').add({ channelId: 'YOUR_CHANNEL_ID', type: 'text', content: { text: 'YOUR_MESSAGE_CONTENT' }, to: 'RECIPIENT_OF_THE_MESSAGE', });
Catatan: Anda dapat menemukan daftar lengkap jenis pesan yang didukung dan kolom konten yang diperlukan dalam dokumentasi Conversations API.
Penyiapan tambahan
Sebelum menginstal ekstensi ini, siapkan layanan Firebase berikut di project Firebase Anda:
- Cloud Firestore untuk menyimpan dokumen pesan.
- Ikuti langkah-langkah dalam dokumentasi untuk membuat database Cloud Firestore. Anda harus memiliki akun MessageBird dan kunci akses MessageBird API sebelum menginstal ekstensi ini. Anda juga harus membuat saluran yang sesuai (saluran SMS, saluran WhatsApp, saluran Facebook Messenger, saluran Telegram, dll.) yang ingin digunakan untuk mengirim pesan karena Anda harus menentukan saluran saat mengirimkan pesan.
Langkah demi langkah pembuatan akun MessageBird
- Buat akun MessageBird di halaman MessageBird, dan jika diminta, pilih jalur "APIs"
- Setelah akun dibuat, Anda dapat melihat kunci API di dasbor atau di halaman setelan Developer.
Anda dapat menyiapkan saluran yang ingin digunakan di halaman Saluran
- untuk SMS, Anda harus memperoleh nomor pengirim
- untuk WhatsApp, Anda harus membuat WhatsApp for Business Account dengan mengikuti wizard penginstalan WhatsApp. Anda mungkin juga perlu membuat template pesan WhatsApp jika ingin mengirimkan pesan WhatsApp informal.
- untuk saluran lainnya, ikuti petunjuk di halaman Saluran
Catatan: MessageBird juga memiliki mode pengujian yang memungkinkan Anda melakukan panggilan API tanpa mengirimkan pesan yang sebenarnya. Anda dapat menggunakannya untuk tujuan pengujian guna menghindari biaya tambahan selama pengembangan.
Penagihan
Ekstensi ini menggunakan layanan Firebase berikut yang mungkin mengenakan biaya terkait:
- Cloud Firestore
- Cloud Functions
Ekstensi ini juga menggunakan layanan pihak ketiga berikut:
- Penagihan MessageBird (informasi harga)
Anda bertanggung jawab atas segala biaya yang timbul akibat penggunaan layanan ini.
Catatan dari Firebase
Untuk menginstal ekstensi ini, project Firebase harus menggunakan paket Blaze (bayar sesuai penggunaan). Anda hanya akan dikenai biaya atas resource yang digunakan. Sebagian besar layanan Firebase menawarkan paket tanpa biaya untuk penggunaan bervolume rendah. Pelajari penagihan Firebase lebih lanjut.
Anda akan dikenai biaya dalam jumlah kecil (biasanya kurang dari $0,10) saat menginstal atau mengonfigurasi ulang ekstensi ini. Lihat Cloud Functions pada bagian Harga Firebase untuk mendapatkan penjelasan yang mendetail.
Cara menginstal ekstensi ini
Menggunakan Firebase console
Anda dapat menggunakan Firebase console untuk menginstal dan mengelola ekstensi.
Instal menggunakan konsolMenggunakan Firebase CLI
Anda juga dapat menggunakan Firebase CLI untuk menginstal dan mengelola ekstensi:
Langkah 1: Jalankan perintah npm berikut untuk menginstal CLI atau mengupdate ke versi CLI terbaru.
npm install -g firebase-toolsTidak berhasil? Lihat referensi Firebase CLI atau ubah izin npm Anda.
Langkah 2: Siapkan direktori project Firebase baru atau buka direktori yang sudah ada
Langkah 3: Tambahkan ekstensi ini ke manifes ekstensi Anda dengan menjalankan
firebase ext:install messagebird/firestore-messagebird-send-msg --local --project=projectId_or_alias
Langkah 4 (Opsional): Uji ekstensi ini secara lokal dengan Firebase Emulator Suite
firebase emulators:start
Langkah 5: Deploy ekstensi dalam manifes ke project Anda
firebase deploy --only extensions --project=projectId_or_alias