Menyinkronkan Kontak dengan SendGrid
Made by Twilio
Menjaga agar koleksi data kontak Firestore tetap sinkron dengan daftar kontak Kampanye Pemasaran SendGrid
Cara kerja ekstensi ini
Gunakan ekstensi ini untuk menambahkan, memperbarui, atau menghapus kontak dari daftar kontak Kampanye Pemasaran SendGrid Anda berdasarkan informasi yang ditambahkan ke koleksi Cloud Firestore yang ditentukan.
Menambahkan dokumen akan memicu ekstensi ini untuk menambahkan kontak ke daftar kontak Kampanye Pemasaran. Memperbarui dokumen akan memperbarui data kontak dan menghapus dokumen akan memicu penghapusannya dari daftar kontak di SendGrid.
Berikut contoh dokumen yang akan memicu ekstensi ini:
admin.firestore().collection('contacts').add({ email: 'someone@example.com', first_name: 'Bob', last_name: 'Bobson' });
Dalam dokumen, Anda dapat menambahkan kolom berikut ini ke dokumen Anda dan kolom tersebut akan diterapkan ke kontak Anda:
Kolom | jenis | |
---|---|---|
email |
string | wajib diisi |
alternate_emails |
Array |
|
first_name |
string | |
last_name |
string | |
address_line_1 |
string | |
address_line_2 |
string | |
city |
string | |
postal_code |
string | |
state_province_region |
string | |
country |
string | |
phone_number |
string | |
whatsapp |
string | |
line |
string | |
facebook |
string | |
unique_name |
string | |
custom_fields |
Map |
custom_fields
harus ditetapkan di dalam akun SendGrid Anda dan merupakan peta ID kolom kustom ke isinya.
Penyiapan tambahan
Sebelum menginstal ekstensi ini, pastikan:
- Anda telah menyiapkan database Cloud Firestore di project Firebase
- Anda telah mendaftar untuk akun Kampanye Pemasaran SendGrid Twilio
- Anda telah membuat Kunci API SendGrid dengan akses ke API Pemasaran
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 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 untuk memiliki akun SendGrid Twilio dan kredensial agar dapat menggunakan SendGrid API Twilio untuk kampanye pemasaran. Anda bertanggung jawab atas semua biaya terkait penggunaan SendGrid 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/sendgrid-sync-contacts --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