Saltearse al contenido
Nappai Documentation

sendgrid

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

Este componente permite enviar correos electrónicos a través de la plataforma SendGrid, integrándose con tu flujo de trabajo en Nappai.

¿Cómo funciona?

El componente se conecta a la API de SendGrid usando una clave de acceso (API Key) que se recupera de la configuración de autenticación de Nappai. Cuando lo activas, construye un mensaje de correo con los campos que le pases: destinatarios, copia, copia oculta, asunto, cuerpo y archivos adjuntos. Si no se proporciona una configuración de correo personalizada, utiliza los valores que ingreses directamente en los campos. Los archivos adjuntos se leen desde el sistema de archivos, se codifican en Base64 y se añaden al mensaje. Finalmente, envía el correo a través de la API de SendGrid y devuelve true si la respuesta indica que el correo fue aceptado (código 202).

Entradas

  • Mail Configuration [DataInput]: Objeto de datos para configurar SendGrid.
  • Attachments [MessageTextInput]: Archivos adjuntos que se enviarán con el correo.
  • BCC [MessageTextInput]: Copia oculta de los destinatarios.
  • Body [MessageTextInput]: Contenido del cuerpo del correo.
  • CC [MessageTextInput]: Copia de los destinatarios.
  • Sender [MessageTextInput]: Dirección de correo del remitente.
  • Subject [MessageTextInput]: Asunto del correo.
  • Recipient [MessageTextInput] (REQUERIDO): Dirección(es) de correo del destinatario.

Salidas

  • Mail Status: bool (método: send_email). Indica si el correo fue aceptado por SendGrid.

Ejemplo de Uso

  1. Arrastra el componente sendgrid al lienzo.
  2. En el campo Recipient escribe usuario@ejemplo.com.
  3. En Subject escribe Prueba de envío.
  4. En Body escribe Hola, este es un correo de prueba.
  5. (Opcional) En Attachments escribe la ruta a un archivo, por ejemplo C:/documentos/ejemplo.pdf.
  6. Haz clic en Run.
  7. Si la salida Mail Status es true, el correo se envió correctamente.

Componentes Relacionados

  • Email Template: Permite crear plantillas de correo que se pueden usar con este componente.
  • Send Email via SMTP: Alternativa para enviar correos sin usar SendGrid.
  • Authentication Manager: Gestiona las credenciales de API Key necesarias para SendGrid.

Consejos y Mejores Prácticas

  • Mantén tu API Key segura: No la incluyas en el código fuente ni la compartas públicamente.
  • Valida los correos: Asegúrate de que las direcciones de correo estén bien formadas antes de enviarlas.
  • Limita los adjuntos: Evita enviar archivos muy grandes para no sobrecargar la API y el ancho de banda.
  • Prueba en modo sandbox: Si SendGrid ofrece un entorno de pruebas, utilízalo para evitar envíos accidentales.

Consideraciones de Seguridad

  • La clave de acceso a SendGrid debe almacenarse como secreto en Nappai y nunca exponerse en el flujo de trabajo.
  • Los archivos adjuntos se leen localmente; asegúrate de que el usuario que ejecuta el flujo tenga permisos adecuados sobre esos archivos.
  • Si el componente se usa en entornos compartidos, revisa los permisos de acceso a la API Key para evitar usos indebidos.