Mengirim Pesan dengan Twilio
Made by Twilio
Mengirim pesan menggunakan Twilio API berdasarkan konten dokumen yang ditulis ke koleksi Cloud Firestore tertentu.
Cara kerja ekstensi ini
Gunakan ekstensi ini untuk mengirimkan pesan (SMS atau WhatsApp) menggunakan Twilio Programmable Messaging API berdasarkan informasi dari dokumen yang ditambahkan ke koleksi Cloud Firestore tertentu. Ekstensi juga akan merekam status pengiriman setiap pesan.
Menambahkan dokumen akan memicu ekstensi ini untuk mengirimkan pesan yang di-build dari kolom dokumen. Kolom dokumen menentukan siapa yang akan mengirim pesan dan isi pesan, serta dapat secara opsional menentukan nomor yang akan mengirim pesan.
Berikut adalah contoh dokumen yang akan memicu ekstensi ini:
admin.firestore().collection('messages').add({ to: '+15551234567', body: 'Hello from Firebase!' });
Required fields
Field | Description |
---|---|
to |
Nomor telepon atau WhatsApp yang menjadi tujuan pengiriman pesan. Nomor telepon harus dalam format e.164. |
body |
Isi pesan |
Optional fields
Field | Description |
---|---|
from |
Nomor telepon Twilio atau Layanan Pesan yang ingin Anda gunakan untuk mengirim pesan. Mengganti nomor telepon pengiriman pesan atau Layanan Pesan yang ditetapkan dalam setelan ekstensi |
Penyiapan tambahan
Sebelum menginstal ekstensi ini, pastikan:
- Anda telah menyiapkan database Cloud Firestore di project Firebase
- Anda telah mendaftar untuk membuat akun Twilio
Mengirim SMS
- Anda akan memerlukan nomor telepon Twilio yang dapat mengirimkan pesan SMS
- Jika menggunakan akun uji coba, Anda hanya akan dapat mengirimkan pesan ke nomor yang telah diverifikasi dengan Twilio
Mengirim pesan WhatsApp
- Anda dapat menguji dengan nomor yang diberikan di Twilio Sandbox for WhatsApp
- Untuk mengirimkan pesan WhatsApp dalam produksi, Anda harus menghubungkan nomor Twilio ke Profil Bisnis WhatsApp
Penagihan
Untuk menginstal ekstensi, project Anda harus menggunakan paket Blaze (bayar sesuai penggunaan)
- Anda akan dikenai sedikit biaya (biasanya sekitar $0,01/bulan) untuk resource Firebase yang diperlukan oleh ekstensi ini (meskipun jika tidak digunakan).
- Ekstensi ini menggunakan layanan Firebase dan Google Cloud Platform lainnya, yang akan mengenakan biaya terkait jika Anda melebihi paket tanpa biaya layanan:
- Cloud Firestore
- Cloud Functions (Node.js 10+ runtime. Lihat FAQ)
- Cloud Secret Manager
Penggunaan ekstensi ini juga mengharuskan Anda memiliki akun Twilio dan kredensial agar dapat menggunakan Twilio API untuk pengiriman pesan. Anda bertanggung jawab atas semua biaya terkait penggunaan Twilio Anda.
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 twilio/send-message --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