SendGrid

  # SendGrid 

## Überblick

sendgrid ist eine Integration, die es einem Botpress ermöglicht, E-Mails über die SendGrid zu versenden.

## Konfiguration

### Authentifizierung Ihrer Domainsendgrid

1. Loggen Sie sich in das SendGrid einsendgrid
2. Öffnen Sie in der linken Navigationsleiste das Untermenü "Einstellungen" und klicken Sie auf "Absender-Authentifizierung".
3. Klicken Sie rechts in der Mitte des Bildschirms auf die Schaltfläche "Get Started" (nur Authentifizierung für die erste Domain)
   - (2nd+ domain auth) Klicken Sie unten links im Abschnitt "Domain Authentication" auf "Authenticate Your Domain".
4. Wählen Sie den Provider für Ihre Domain, wenn der Provider nicht aufgelistet ist, wählen Sie "I'm Not Sure" (Es ist einfacher als die Option "Other host")
   - Auch mit SquareSpace Domains getestet
5. Geben Sie im Feld "Von Domain" Ihre Domain ein (z.B.Botpress.com")
6. Fügen Sie die DNS-Einträge im Portal Ihres Domain-Providers hinzu (z.B. Cloudflare, GoDaddy, SquareSpace, etc.)
7. Setzen Sie ein Häkchen bei "I've added these records" & klicken Sie auf "Verify" und warten Sie auf die Bestätigung SendGrid , dass der Eintrag verifiziert wurde.
   - Wenn trotz des korrekten Hinzufügens der CNAME-DNS-Einträge zu Ihrem Domain-Provider immer noch ein Fehler angezeigt wird, versuchen Sie, das Domain-Suffix aus dem Host-Key zu entfernen. (z. B. "em1234botpress.com" > "em1234")
8. Jetzt können Sie E-Mails mit Ihrer Domäne versenden. Viel Spaß beim E-Mail-Versand!

### Erwerben eines API-Schlüsselssendgrid

1. Loggen Sie sich in das SendGrid einsendgrid
2. Öffnen Sie in der linken Navigationsleiste das Untermenü "Einstellungen" und klicken Sie auf "API-Schlüssel".
3. Oben rechts klicken Sie auf "API-Schlüssel erstellen".
4. Geben Sie dem Schlüssel einen Namen
5. Erteilen Sie dem Schlüssel entweder die Berechtigung "Voller Zugriff" oder, wenn Sie "Eingeschränkter Zugriff" verwenden, wählen Sie die folgenden Optionen:
   - "Mail senden" (Voller Zugriff)
6. Klicken Sie auf "Erstellen & Anzeigen".

### Einrichten von Webhookswebhook

1. Melden Sie sich im SendGrid ansendgrid
2. Öffnen Sie in der linken Navigationsleiste das Untermenü "Einstellungen" und klicken Sie auf "Mail-Einstellungen".
3. In den Mail-Einstellungen klicken Sie auf "Event Webhooks".
4. Klicken Sie in der rechten Mitte des Bildschirms auf "Neuen webhook erstellen".
5) (Optional) Geben Sie dem webhook einen "Friendly Name" (z.B.Botpress Bot")
6. Kopieren Sie die webhook aus der Botpress und fügen Sie sie in das Feld "Post-URL" von Sendgrid ein.
7. Wählen Sie die "Zu sendenden Aktionen" aus. Dies sind die Ereignisse, die die Botpress empfangen wird.
   1. Hinweis: Diese Integration unterstützt noch nicht alle Ereignisse.
8. (Optional, aber empfohlen) Aktivieren Sie "Signature Verification".
   1. Wenn Sie dies aktiviert haben, klicken Sie nach dem Speichern des webhook auf das Zahnrad am webhook und dann auf "Bearbeiten".
   2. Kopieren Sie den "Verifizierungsschlüssel" von Sendgrid und fügen Sie ihn in das FeldWebhook " in der Botpress ein.
9. Klicken Sie auf "Speichern" und schon können Sie die Ereignisse in Ihrem Botpress verwenden.

## Randbemerkungen

Die derzeitige Implementierung beschränkt sich auf das Versenden von [markdown](https://spec.commonmark.org/0.31.2/) Rich-Text-E-Mails, dies wird jedoch in Zukunft erweitert.

## Ressourcen

- 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