SendGrid

  Integrasi SendGrid 

## Gambaran Umum

sendgrid adalah integrasi yang memungkinkan chatbot Botpress mengirim email melalui API SendGrid .

## Konfigurasi

### Mengautentikasi domain Andasendgrid

1. Masuk ke dasbor SendGrid sendgrid
2. Pada bilah navigasi di sebelah kiri, buka submenu "Pengaturan", klik "Otentikasi Pengirim"
3. Di bagian kanan tengah layar, klik tombol "Mulai" (Hanya untuk otentikasi domain pertama)
   - (Otentikasi domain ke-2+) Di dekat kiri bawah pada bagian "Otentikasi Domain", klik "Autentikasi Domain Anda"
4. Pilih penyedia untuk domain Anda, jika penyedia tidak terdaftar, pilih "Saya Tidak Yakin" (Lebih mudah daripada opsi "Host lain")
   - Juga diuji dengan Domain SquareSpace
5. Pada kolom "From Domain", masukkan domain Anda (misalnyaBotpress.com")
6. Tambahkan catatan DNS di portal penyedia domain Anda (mis. Cloudflare, GoDaddy, SquareSpace, dll.)
7. Centang "Saya telah menambahkan catatan ini" & klik "Verifikasi" dan tunggu hingga SendGrid mengonfirmasi bahwa catatan tersebut telah diverifikasi.
   - Jika kesalahan masih muncul meskipun Anda telah menambahkan record DNS 'CNAME' dengan benar ke penyedia domain Anda, coba hapus akhiran domain dari kunci host. (contoh: "em1234botpress.com" > "em1234")
8. Sekarang Anda sudah siap mengirim email dengan domain Anda. Selamat berkirim email!

### Mendapatkan kunci APIsendgrid

1. Masuk ke dasbor SendGrid sendgrid
2. Pada bilah navigasi di sebelah kiri, buka submenu "Pengaturan", klik "Kunci API"
3. Di dekat bagian kanan atas, klik "Buat Kunci API"
4. Beri nama kunci tersebut
5. Berikan izin kunci dengan "Akses Penuh" atau jika menggunakan "Akses Terbatas", pilih yang berikut ini:
   - "Kirim Email" (Akses Penuh)
6. Klik "Buat & Lihat"

### Menyiapkan Webhookwebhook

1. Masuk ke dasbor SendGrid sendgrid
2. Pada bilah navigasi di sebelah kiri, buka submenu "Pengaturan", klik "Pengaturan Email"
3. Di Pengaturan Mail, klik "Event Webhooks"
4. Di bagian kanan tengah layar, klik "Buat webhook baru"
5. (Opsional) Berikan "Nama Ramah" pada webhook (misal:Botpress ")
6. Salin URL webhook dari konfigurasi integrasi Botpress & tempelkan ke dalam kolom "Post URL" di Sendgrid
7. Pilih "Actions to be posted", ini akan menjadi event yang akan diterima oleh integrasi Botpress .
   1. Catatan: Integrasi ini belum mendukung semua event
8. (Opsional, tetapi disarankan) Aktifkan "Verifikasi Tanda Tangan"
   1. Jika Anda telah mengaktifkan ini, setelah webhook disimpan, klik roda gigi pada webhook dan klik "edit"
   2. Salin "Kunci verifikasi" dari Sendgrid dan tempelkan ke dalam bidangWebhook Kunci VerifikasiWebhook " pada konfigurasi integrasi Botpress 
9. Klik "Simpan" dan Anda siap untuk menggunakan event di bot Botpress Anda

## Catatan Samping

Implementasi saat ini terbatas hanya untuk mengirim email teks kaya [markdown](https://spec.commonmark.org/0.31.2/), meskipun hal ini akan diperluas di masa mendatang.

## Sumber Daya

- https://www.twilio.com/docs/sendgrid/for-developers
- https://www.twilio.com/docs/sendgrid/api-reference
- https://www.twilio.com/docs/sendgrid/ui/account-and-settings/api-keys
- https://www.twilio.com/docs/sendgrid/ui/account-and-settings/how-to-set-up-domain-authentication