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-kolom pada dokumen menetapkan siapa yang akan dikirimi pesan dan isi pesannya, serta dapat pula menetapkan nomor yang akan digunakan untuk 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 penerima pesan. Nomor telepon harus dalam format e.164. |
body
|
Isi pesan |
Kolom Opsional
| Kolom | Deskripsi |
|---|---|
from
|
Nomor telepon Twilio atau Messaging Service yang ingin Anda gunakan untuk mengirim pesan. Mengganti format dari nomor atau Messaging Service yang ditetapkan di setelan ekstensi |
mediaUrls
|
Array URL media yang akan dikirim dengan pesan. Hanya didukung di Amerika Serikat dan Kanada. Lihat Membuat dokumen Pesan untuk mengetahui informasi selengkapnya. |
Penyiapan tambahan
Sebelum menginstal ekstensi ini, pastikan:
- Anda telah menyiapkan database Cloud Firestore di project Firebase
- Anda telah mendaftar ke akun Twilio
Mengirim SMS
- Anda memerlukan nomor telepon Twilio yang dapat mengirim pesan SMS
- Jika menggunakan akun uji coba, Anda hanya dapat mengirim pesan ke nomor yang telah Anda verifikasi dengan Twilio
Mengirim pesan WhatsApp
- Anda dapat menguji nomor yang diberikan di Twilio Sandbox for WhatsApp
- Untuk mengirim 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 biaya dalam jumlah kecil (biasanya sekitar $0,01/bulan) untuk resource Firebase yang diperlukan oleh ekstensi ini (meski tidak digunakan).
- Ekstensi ini menggunakan layanan Firebase dan Google Cloud Platform lainnya, yang memiliki biaya terkait jika penggunaan Anda melebihi paket gratis layanan:
- Cloud Firestore
- Cloud Functions (runtime Node.js 10+. 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
Step 4 (Optional): Test this extension locally with the Firebase Emulator Suite
firebase emulators:start
Langkah 5: Deploy ekstensi dalam manifes ke project Anda
firebase deploy --only extensions --project=projectId_or_alias