# SendGrid Integrasi ## Gambaran Keseluruhan `@botpresshub/ sendgrid ` ialah integrasi yang membolehkan a Botpress chatbot untuk menghantar e-mel melalui SendGrid API. ## Konfigurasi ### Mengesahkan domain anda (https://app. sendgrid .com/settings/sender_auth) 1. Log masuk ke SendGrid papan pemuka (https://app. sendgrid .com/) 2. Dalam bar navigasi di sebelah kiri, buka submenu "Tetapan", klik pada "Pengesahan Penghantar" 3. Di bahagian tengah-kanan skrin, klik butang "Bermula" (Pengesahan domain pertama sahaja) - (Pengesahan domain ke-2+) Berhampiran kiri bawah dalam bahagian "Klik Domain" Pengesahan 4 anda, jika domain Pilih "Pengesahan" anda, jika domain anda pilih. pembekal tidak disenaraikan, pilih "Saya Tidak Pasti" (Ia lebih mudah daripada pilihan "Hos lain") - Juga diuji dengan Domain SquareSpace 5. Dalam medan "Dari Domain", masukkan domain anda (cth " Botpress .com") 6. Tambahkan rekod DNS dalam portal pembekal domain anda (cth Cloudflare, GoDaddy, SquareSpace, dll.) 7. Tandakan "Saya telah menambah rekod ini" & klik "Sahkan" dan tunggu untuk SendGrid untuk mengesahkan ia telah disahkan. - Jika ralat masih ditunjukkan walaupun telah menambah rekod DNS 'CNAME' dengan betul pada pembekal domain anda, cuba alih keluar akhiran domain daripada kunci hos. (cth "em1234. botpress .com" > "em1234") 8. Kini anda bersedia untuk menghantar e-mel dengan domain anda. Selamat Menge-mel! ### Memperoleh kunci API (https://app. sendgrid .com/settings/api_keys) 1. Log masuk ke SendGrid papan pemuka (https://app. sendgrid .com/) 2. Dalam bar navigasi di sebelah kiri, buka submenu "Tetapan", klik pada "Kekunci API" 3. Berhampiran bahagian atas sebelah kanan, klik "Buat Kunci API" 4. Beri nama kunci 5. Berikan keizinan kunci sama ada dengan "Akses Penuh" atau jika menggunakan "Akses Terhad" pilih yang berikut: - "Full Click ViewC" (F. Klik "Lihat Akses" Hantar) (F. ### Menyediakan Webhooks (https://app. sendgrid .com/settings/mail_settings/ webhook _setting) 1. Log masuk ke SendGrid papan pemuka (https://app. sendgrid .com/) 2. Dalam bar navigasi di sebelah kiri, buka submenu "Settings", klik pada "Mail Settings" 3. Dalam Mail Settings, klik pada "Event Webhooks" 4. Di bahagian tengah-kanan skrin, klik "Create new webhook " 5. (Pilihan) Berikan webhook "Nama Mesra" (cth " Botpress Bot") 6. Salin webhook URL daripada Botpress konfigurasi integrasi & tampalkannya ke dalam Sendgrid Medan "URL Siaran" 7. Pilih "Tindakan untuk disiarkan", ini akan menjadi peristiwa yang Botpress integrasi akan menerima. 1. Nota: Penyepaduan ini belum menyokong semua acara lagi 8. (Pilihan, tetapi disyorkan) Dayakan "Pengesahan Tandatangan" 1. Jika anda telah mendayakan ini, sebaik sahaja webhook telah disimpan, klik cog pada webhook dan klik "edit" 2. Salin "Kunci pengesahan" daripada Sendgrid dan tampalkannya ke dalam " Webhook Kunci Pengesahan" medan Botpress konfigurasi penyepaduan 9. Klik "Simpan" dan anda sudah bersedia untuk menggunakan acara dalam anda Botpress bot ## Nota Sampingan Pelaksanaan semasa terhad kepada hanya menghantar e-mel teks kaya [markdown](https://spec.commonmark.org/0.31.2/), walaupun ini akan dikembangkan pada masa hadapan. ## Sumber - https://www. twilio .com/docs/ sendgrid /untuk-pembangun - 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