SendGrid

  # Integracja z SendGrid 

## Przegląd

sendgrid to integracja, która umożliwia chatbotowi Botpress wysyłanie wiadomości e-mail za pośrednictwem interfejsu API SendGrid .

## Konfiguracja

### Uwierzytelnianie domenysendgrid

1. Zaloguj się do pulpitu nawigacyjnego SendGrid sendgrid
2. Na pasku nawigacyjnym po lewej stronie otwórz podmenu "Ustawienia", kliknij "Uwierzytelnianie nadawcy".
3. W prawej środkowej części ekranu kliknij przycisk "Rozpocznij" (tylko uwierzytelnianie pierwszej domeny).
   - (Uwierzytelnianie domeny 2+) W pobliżu lewego dolnego rogu w sekcji "Uwierzytelnianie domeny" kliknij przycisk "Uwierzytelnij swoją domenę".
4. Wybierz dostawcę dla swojej domeny, jeśli dostawcy nie ma na liście, wybierz "Nie jestem pewien" (jest to łatwiejsze niż opcja "Inny host").
   - Przetestowano również z domenami SquareSpace
5. W polu "From Domain" wprowadź swoją domenę (np.Botpress.com").
6. Dodaj rekordy DNS w portalu dostawcy domeny (np. Cloudflare, GoDaddy, SquareSpace itp.).
7. Zaznacz "Dodałem te rekordy" i kliknij "Zweryfikuj" i poczekaj, aż SendGrid potwierdzi, że został zweryfikowany.
   - Jeśli błąd jest nadal wyświetlany pomimo prawidłowego dodania rekordów DNS "CNAME" do dostawcy domeny, spróbuj usunąć sufiks domeny z klucza hosta. (np. "em1234botpress.com" > "em1234").
8. Teraz możesz wysyłać wiadomości e-mail ze swoją domeną. Szczęśliwego wysyłania e-maili!

### Uzyskiwanie klucza APIsendgrid

1. Zaloguj się do panelu SendGrid sendgrid
2. Na pasku nawigacyjnym po lewej stronie otwórz podmenu "Ustawienia", kliknij "Klucze API".
3. W prawym górnym rogu kliknij "Utwórz klucz API".
4. Nadaj kluczowi nazwę
5. Przyznaj kluczowi uprawnienia "Pełny dostęp" lub, jeśli korzystasz z "Ograniczonego dostępu", wybierz następujące opcje:
   - "Mail Send" (Pełny dostęp)
6. Kliknij "Utwórz i wyświetl"

### Konfiguracja Webhookswebhook

1. Zaloguj się do pulpitu nawigacyjnego SendGrid sendgrid
2. Na pasku nawigacyjnym po lewej stronie otwórz podmenu "Ustawienia", kliknij "Ustawienia poczty".
3. W Ustawieniach poczty kliknij "Webhooki zdarzeń".
4. W prawej środkowej części ekranu kliknij "Utwórz nowy webhook".
5. (Opcjonalnie) Nadaj webhook "Przyjazną nazwę" (np.Botpress Bot").
6. Skopiuj adres URL webhook z konfiguracji integracji Botpress i wklej go w polu "Post URL" Sendgrid.
7. Wybierz "Akcje do wysłania", będą to zdarzenia, które otrzyma integracja Botpress .
   1. Uwaga: Ta integracja nie obsługuje jeszcze wszystkich zdarzeń.
8. (Opcjonalnie, ale zalecane) Włącz "Weryfikację podpisu"
   1. Jeśli włączyłeś tę opcję, po zapisaniu webhook kliknij trybik na webhook i kliknij "edytuj".
   2. Skopiuj "Klucz weryfikacji" z Sendgrid i wklej go w poluWebhook Klucz weryfikacjiWebhook " w konfiguracji integracji Botpress .
9. Kliknij "Zapisz" i jesteś gotowy do korzystania z wydarzeń w swoim bocie Botpress .

## Uwagi dodatkowe

Obecna implementacja jest ograniczona tylko do wysyłania wiadomości e-mail z tekstem sformatowanym [markdown](https://spec.commonmark.org/0.31.2/), choć zostanie to rozszerzone w przyszłości.

## Zasoby

- 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