SendGrid

  # Integrazione di SendGrid 

## Panoramica

sendgrid è un'integrazione che consente a un chatbot Botpress di inviare e-mail tramite l'API SendGrid .

## Configurazione

### Autenticazione del dominiosendgrid

1. Accedere alla dashboard di SendGrid sendgrid
2. Nella barra di navigazione a sinistra, aprire il sottomenu "Impostazioni", fare clic su "Autenticazione mittente".
3. Nella parte centrale destra dello schermo, fare clic sul pulsante "Inizia" (solo per l'autenticazione del primo dominio).
   - (autenticazione del 2°+ dominio) In basso a sinistra, nella sezione "Autenticazione del dominio", fare clic su "Autentica il tuo dominio".
4. Selezionare il provider per il proprio dominio; se il provider non è elencato, scegliere "Non sono sicuro" (è più semplice dell'opzione "Altro host").
   - Testato anche con i domini SquareSpace
5. Nel campo "Da dominio", inserite il vostro dominio (ad esempio,Botpress.com").
6. Aggiungete i record DNS nel portale del vostro provider di domini (ad es. Cloudflare, GoDaddy, SquareSpace, ecc.).
7. Selezionare "Ho aggiunto questi record" e fare clic su "Verifica" e attendere che SendGrid confermi l'avvenuta verifica.
   - Se nonostante l'aggiunta corretta dei record DNS 'CNAME' al vostro provider di domini, viene ancora visualizzato un errore, provate a rimuovere il suffisso del dominio dalla chiave host. (ad esempio, "em1234botpress.com" > "em1234").
8. Ora siete pronti a inviare e-mail con il vostro dominio. Buon invio di e-mail!

### Acquisizione di una chiave APIsendgrid

1. Accedere alla dashboard di SendGrid sendgrid
2. Nella barra di navigazione a sinistra, aprire il sottomenu "Impostazioni" e fare clic su "Chiavi API".
3. In alto a destra, fare clic su "Crea chiave API".
4. Assegnare un nome alla chiave
5. Concedere alla chiave le autorizzazioni con "Accesso completo" o, se si utilizza "Accesso limitato", selezionare le seguenti opzioni:
   - "Invio di posta" (accesso completo)
6. Fare clic su "Crea e visualizza".

### Impostazione dei Webhook (webhook

1. Accedere alla dashboard di SendGrid sendgrid
2. Nella barra di navigazione a sinistra, aprire il sottomenu "Impostazioni" e fare clic su "Impostazioni di posta".
3. In Impostazioni di posta, fare clic su "Webhook eventi".
4. Nella parte centrale destra della schermata, fare clic su "Crea nuovo webhook".
5. (Facoltativo) Assegnare al webhook un "nome amico" (ad es.Botpress Bot").
6. Copiare l'URL del webhook dalla configurazione dell'integrazione Botpress e incollarlo nel campo "Post URL" di Sendgrid.
7. Selezionare le "Azioni da pubblicare", che saranno gli eventi che l'integrazione Botpress riceverà.
   1. Nota: questa integrazione non supporta ancora tutti gli eventi.
8. (Opzionale, ma consigliato) Abilitare la "Verifica della firma".
   1. Se è stata abilitata, una volta salvato il webhook , fare clic sull'ingranaggio del webhook e fare clic su "modifica".
   2. Copiare la "Chiave di verifica" da Sendgrid e incollarla nel campoWebhook Chiave di verificaWebhook " della configurazione dell'integrazione Botpress .
9. Fare clic su "Salva" e si è pronti a utilizzare gli eventi nel bot Botpress .

## Note a margine

L'implementazione attuale è limitata all'invio di email di testo ricco [markdown](https://spec.commonmark.org/0.31.2/), anche se questo verrà ampliato in futuro.

## Risorse

- 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