SendGrid

  # Integración de SendGrid 

## Visión general

sendgrid es una integración que permite a un chatbot Botpress enviar correos electrónicos a través de la API SendGrid .

## Configuración

### Autenticación de su dominiosendgrid

1. Inicie sesión en el panel de SendGrid sendgrid
2. En la barra de navegación de la izquierda, abra el submenú "Configuración", haga clic en "Autenticación del remitente"
3. 3. En la parte central derecha de la pantalla, haga clic en el botón "Empezar" (Sólo autenticación de primer dominio).
   - (2nd+ domain auth) Cerca de la parte inferior izquierda en la sección "Domain Authentication", haga clic en "Authenticate Your Domain"
4. Seleccione el proveedor para su dominio, si el proveedor no está en la lista, elija "No estoy seguro" (Es más fácil que la opción "Otro host")
   - También probado con dominios SquareSpace
5. En el campo "Desde dominio", introduce tu dominio (por ejemplo,Botpress.com")
6. Añade los registros DNS en el portal de tu proveedor de dominio (por ejemplo, Cloudflare, GoDaddy, SquareSpace, etc.)
7. Marque "He añadido estos registros" y haga clic en "Verificar" y espere a que SendGrid confirme que se ha verificado.
   - Si sigue apareciendo un error a pesar de haber añadido correctamente los registros DNS "CNAME" a su proveedor de dominio, intente eliminar el sufijo del dominio de la clave de host. (por ejemplo, "em1234botpress.com" > "em1234")
8. Ahora ya puedes enviar correos electrónicos con tu dominio. ¡Feliz envío de emails!

### Adquirir una clave APIsendgrid

1. Inicie sesión en el panel de SendGrid sendgrid
2. En la barra de navegación de la izquierda, abra el submenú "Configuración", haga clic en "Claves API"
3. Cerca de la parte superior derecha, haga clic en "Crear clave de API"
4. Asigne un nombre a la clave
5. 5. Conceda a la clave permisos de "Acceso total" o, si utiliza "Acceso restringido", seleccione lo siguiente:
   - "Enviar correo" (Acceso total)
6. 6. Haga clic en "Crear y ver".

### Configuración de Webhookswebhook

1. Inicie sesión en el panel de SendGrid sendgrid
2. En la barra de navegación de la izquierda, abra el submenú "Configuración", haga clic en "Configuración de correo"
3. En Ajustes de correo, haga clic en "Webhooks de eventos"
4. 4. En la parte central derecha de la pantalla, haga clic en "Crear nuevo webhook".
5. (Opcional) Dale al webhook un "Nombre amigable" (ej.Botpress Bot")
6. Copie la URL webhook de la configuración de integración de Botpress y péguela en el campo "Post URL" de Sendgrid
7. Seleccione las "Acciones a publicar", estos serán los eventos que recibirá la integración Botpress .
   1. Nota: Esta integración aún no soporta todos los eventos
8. (Opcional, pero recomendado) Habilitar "Verificación de Firma"
   1. Si lo has habilitado, una vez guardado el webhook , haz clic en el engranaje del webhook y haz clic en "editar"
   2. Copia la "Clave de verificación" de Sendgrid y pégala en el campoWebhook Clave de verificaciónWebhook " del config de integración Botpress 
9. Haz clic en "Guardar" y ya puedes utilizar los eventos en tu bot Botpress .

## Notas al margen

La implementación actual se limita al envío de correos electrónicos de texto enriquecido [markdown](https://spec.commonmark.org/0.31.2/), aunque esto se ampliará en el futuro.

## Recursos

- 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