# SendGrid Pagsasama ## Pangkalahatang-ideya @botpresshub/ sendgrid ay isang integrasyon na nagbibigay-daan sa a Botpress chatbot upang magpadala ng mga email sa pamamagitan ng SendGrid API. ## Configuration ### Pag-authenticate ng iyong domain (https://app. sendgrid .com/settings/sender_auth) 1. Mag-login sa SendGrid dashboard (https://app. sendgrid .com/) 2. Sa navigation bar sa kaliwa, buksan ang "Settings" submenu, i-click ang "Sender Authentication" 3. Sa gitna-kanang bahagi ng screen, i-click ang "Get Started" button (First domain authentication only) - (2nd+ domain authentication) Malapit sa ibabang kaliwa sa "Domain click"Authentication" na seksyon, kung ang iyong domain ay i-click ang "Authentication" na seksyon, kung ang iyong domain ay i-click ang "Authentication". ang provider ay hindi nakalista, piliin ang "Hindi Ako Sigurado" (Ito ay mas madali kaysa sa opsyon na "Iba pang host") - Sinubukan din gamit ang SquareSpace Domains 5. Sa field na "Mula sa Domain," ilagay ang iyong domain (hal. " Botpress .com") 6. Idagdag ang mga DNS record sa portal ng iyong domain provider (hal. Cloudflare, GoDaddy, SquareSpace, atbp.) 7. Lagyan ng check ang "Idinagdag ko ang mga talaang ito" at i-click ang "I-verify" at hintayin ang SendGrid para kumpirmahin na na-verify na ito. - Kung ang isang error ay ipinapakita pa rin sa kabila ng wastong pagdaragdag ng 'CNAME' na mga tala ng DNS sa iyong domain provider, subukang alisin ang domain suffix mula sa host key. (hal. "em1234. botpress .com" > "em1234") 8. Ngayon ay handa ka nang magpadala ng mga email gamit ang iyong domain. Maligayang Pag-email! ### Pagkuha ng API key (https://app. sendgrid .com/settings/api_keys) 1. Mag-login sa SendGrid dashboard (https://app. sendgrid .com/) 2. Sa navigation bar sa kaliwa, buksan ang "Settings" submenu, i-click ang "API Keys" 3. Malapit sa kanang tuktok, i-click ang "Gumawa ng API Key" 4. Bigyan ng pangalan ang key 5. Bigyan ang key na mga pahintulot na may alinman sa "Full Access" o kung gumagamit ng "Restricted Access" piliin ang sumusunod: - "Restricted Access" piliin ang sumusunod: - "Pag-click sa Pag-access sa Mail" (F. ### Pagse-set up ng Webhooks (https://app. sendgrid .com/settings/mail_settings/ webhook _setting) 1. Mag-login sa SendGrid dashboard (https://app. sendgrid .com/) 2. Sa navigation bar sa kaliwa, buksan ang "Settings" submenu, i-click ang "Mail Settings" 3. Sa Mail Settings, i-click ang "Event Webhooks" 4. Sa gitnang kanang bahagi ng screen, i-click ang "Create new webhook " 5. (Opsyonal) Ibigay ang webhook isang "Friendly Name" (hal. " Botpress Bot") 6. Kopyahin ang webhook URL mula sa Botpress integration config at i-paste ito sa Sendgrid 's "Post URL" field 7. Piliin ang "Mga aksyon na ipo-post", ito ang magiging mga kaganapan na Botpress matatanggap ang pagsasama. 1. Tandaan: Ang pagsasamang ito ay hindi pa sumusuporta sa lahat ng mga kaganapan 8. (Opsyonal, ngunit inirerekomenda) Paganahin ang "Pag-verify ng Lagda" 1. Kung pinagana mo ito, sa sandaling ang webhook ay naka-save, i-click ang cog sa webhook at i-click ang "edit" 2. Kopyahin ang "Verification key" mula sa Sendgrid at idikit ito sa " Webhook Verification Key" na field ng Botpress integration config 9. I-click ang "I-save" at handa ka nang gamitin ang mga kaganapan sa iyong Botpress bot ## Side Notes Ang kasalukuyang pagpapatupad ay limitado sa pagpapadala lamang ng markdown mga rich text na email, bagama't ito ay palalawakin sa hinaharap. ## Mga Mapagkukunan - https://www. twilio .com/docs/ sendgrid /para sa mga developer - 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
# SendGrid Pagsasama ## Pangkalahatang-ideya `@botpresshub/ sendgrid ` ay isang integrasyon na nagbibigay-daan sa a Botpress chatbot upang magpadala ng mga email sa pamamagitan ng SendGrid API. ## Configuration ### Pag-authenticate ng iyong domain (https://app. sendgrid .com/settings/sender_auth) 1. Mag-login sa SendGrid dashboard (https://app. sendgrid .com/) 2. Sa navigation bar sa kaliwa, buksan ang "Settings" submenu, i-click ang "Sender Authentication" 3. Sa gitna-kanang bahagi ng screen, i-click ang "Get Started" button (First domain authentication only) - (2nd+ domain authentication) Malapit sa ibabang kaliwa sa "Domain click"Authentication" na seksyon, kung ang iyong domain ay i-click ang "Authentication" na seksyon, kung ang iyong domain ay i-click ang "Authentication". ang provider ay hindi nakalista, piliin ang "Hindi Ako Sigurado" (Ito ay mas madali kaysa sa opsyon na "Iba pang host") - Sinubukan din gamit ang SquareSpace Domains 5. Sa field na "Mula sa Domain," ilagay ang iyong domain (hal. " Botpress .com") 6. Idagdag ang mga DNS record sa portal ng iyong domain provider (hal. Cloudflare, GoDaddy, SquareSpace, atbp.) 7. Lagyan ng check ang "Idinagdag ko ang mga talaang ito" at i-click ang "I-verify" at hintayin ang SendGrid para kumpirmahin na na-verify na ito. - Kung ang isang error ay ipinapakita pa rin sa kabila ng wastong pagdaragdag ng 'CNAME' na mga tala ng DNS sa iyong domain provider, subukang alisin ang domain suffix mula sa host key. (hal. "em1234. botpress .com" > "em1234") 8. Ngayon ay handa ka nang magpadala ng mga email gamit ang iyong domain. Maligayang Pag-email! ### Pagkuha ng API key (https://app. sendgrid .com/settings/api_keys) 1. Mag-login sa SendGrid dashboard (https://app. sendgrid .com/) 2. Sa navigation bar sa kaliwa, buksan ang "Settings" submenu, i-click ang "API Keys" 3. Malapit sa kanang tuktok, i-click ang "Gumawa ng API Key" 4. Bigyan ng pangalan ang key 5. Bigyan ang key na mga pahintulot na may alinman sa "Full Access" o kung gumagamit ng "Restricted Access" piliin ang sumusunod: - "Restricted Access" piliin ang sumusunod: - "Pag-click sa Pag-access sa Mail" (F. ### Pagse-set up ng Webhooks (https://app. sendgrid .com/settings/mail_settings/ webhook _setting) 1. Mag-login sa SendGrid dashboard (https://app. sendgrid .com/) 2. Sa navigation bar sa kaliwa, buksan ang "Settings" submenu, i-click ang "Mail Settings" 3. Sa Mail Settings, i-click ang "Event Webhooks" 4. Sa gitnang kanang bahagi ng screen, i-click ang "Create new webhook " 5. (Opsyonal) Ibigay ang webhook isang "Friendly Name" (hal. " Botpress Bot") 6. Kopyahin ang webhook URL mula sa Botpress integration config at i-paste ito sa Sendgrid 's "Post URL" field 7. Piliin ang "Mga aksyon na ipo-post", ito ang magiging mga kaganapan na Botpress matatanggap ang pagsasama. 1. Tandaan: Ang pagsasamang ito ay hindi pa sumusuporta sa lahat ng mga kaganapan 8. (Opsyonal, ngunit inirerekomenda) Paganahin ang "Pag-verify ng Lagda" 1. Kung pinagana mo ito, sa sandaling ang webhook ay naka-save, i-click ang cog sa webhook at i-click ang "edit" 2. Kopyahin ang "Verification key" mula sa Sendgrid at idikit ito sa " Webhook Verification Key" na field ng Botpress integration config 9. I-click ang "I-save" at handa ka nang gamitin ang mga kaganapan sa iyong Botpress bot ## Side Notes Ang kasalukuyang pagpapatupad ay limitado sa pagpapadala lamang ng [markdown](https://spec.commonmark.org/0.31.2/) mga rich text na email, bagama't ito ay palalawakin sa hinaharap. ## Mga Mapagkukunan - https://www. twilio .com/docs/ sendgrid /para sa mga developer - 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
