SendGrid

  # Integratie SendGrid 

## Overzicht

sendgrid is een integratie waarmee een Botpress chatbot e-mails kan versturen via de SendGrid API.

## Configuratie

### Uw domein authenticerensendgrid

1. Log in op het SendGrid dashboardsendgrid
2. In de navigatiebalk aan de linkerkant, open "Instellingen" submenu, klik op "Verzender Authenticatie"
3. 3. In het midden-rechts deel van het scherm, klik op de "Get Started" knop (Alleen eerste domein authenticatie)
   - (2e+ domein verificatie) Klik linksonder in het gedeelte "Domein verificatie" op "Uw domein verifiëren".
4. Selecteer de provider voor uw domein, als de provider niet in de lijst staat, kies dan "I'm Not Sure" (dit is makkelijker dan de optie "Other host").
   - Ook getest met SquareSpace domeinen
5. Voer in het veld "Van domein" je domein in (bijv.Botpress.com")
6. Voeg de DNS-records toe in het portaal van je domeinprovider (bijv. Cloudflare, GoDaddy, SquareSpace, etc.)
7. Vink "I've added these records" aan & klik op "Verify" en wacht tot SendGrid bevestigt dat het geverifieerd is.
   - Als er nog steeds een fout wordt weergegeven ondanks het correct toevoegen van de 'CNAME' DNS-records aan uw domeinprovider, probeer dan het domeinsuffix te verwijderen uit de hostsleutel. (bijv. "em1234botpress.com" > "em1234")
8. Nu ben je klaar om e-mails te versturen met je domein. Veel e-mailplezier!

### Een API-sleutel verkrijgensendgrid

1. Log in op het SendGrid dashboardsendgrid
2. Open in de navigatiebalk aan de linkerkant het submenu "Instellingen" en klik op "API Keys".
3. In de rechterbovenhoek, klik op "Creëer API Sleutel".
4. Geef de sleutel een naam
5. Geef de sleutel rechten met "Volledige toegang" of selecteer het volgende als u "Beperkte toegang" gebruikt:
   - "Mail verzenden" (Volledige toegang)
6. Klik op "Aanmaken & weergeven".

### Webhooks instellenwebhook

1. Log in op het SendGrid dashboardsendgrid
2. Open in de navigatiebalk aan de linkerkant het submenu "Instellingen" en klik op "Mailinstellingen".
3. In Mail Settings, klik op "Event Webhooks".
4. Klik rechts in het midden van het scherm op "Nieuwe webhook maken".
5. (Optioneel) Geef de webhook een "Vriendelijke naam" (bijv.Botpress Bot")
6. Kopieer de webhook URL van de Botpress integration config en plak deze in Sendgrid's "Post URL" veld
7. Selecteer de "Acties die gepost moeten worden", dit zullen de gebeurtenissen zijn die de Botpress integratie zal ontvangen.
   1. Opmerking: Deze integratie ondersteunt nog niet alle gebeurtenissen
8. (Optioneel, maar aanbevolen) Schakel "Handtekeningverificatie" in
   1. Als je dit hebt ingeschakeld, klik dan zodra de webhook is opgeslagen op het tandwiel op de webhook en klik op "bewerken"
   2. Kopieer de "Verificatiesleutel" van Sendgrid en plak deze in het veldWebhook Verificatiesleutel" van de Botpress integratie config
9. Klik op "Opslaan" en je bent klaar om de gebeurtenissen te gebruiken in je Botpress bot

## Opmerkingen

De huidige implementatie is beperkt tot het verzenden van [markdown](https://spec.commonmark.org/0.31.2/) rich text e-mails, maar dit zal in de toekomst worden uitgebreid.

## Bronnen

- 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