GmailToolkit

El GmailToolkit es un componente que te permite interactuar con tu cuenta de Gmail directamente desde el dashboard de Nappai. Con él puedes enviar correos, leer los que recibes y organizar tu bandeja de entrada sin salir de la plataforma.

⚠️ 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.

¿Cómo funciona?

El GmailToolkit se conecta a la API de Gmail de Google mediante OAuth2. Para ello necesita una credencial GMail previamente configurada en Nappai. Cuando se ejecuta, el componente construye un BaseToolkit que agrupa varias herramientas (send, read, manage) que pueden ser usadas por otros componentes o flujos de trabajo. El toolkit también permite personalizar el remitente de los correos y el estilo CSS que se aplicará al generar PDFs de los mensajes.

Credencial requerida

1. Ve a la sección Credenciales de Nappai y crea una nueva credencial de tipo GMail.
2. Proporciona el Client Id, el Client Secret y selecciona el acceso a Google Drive según tus necesidades.
3. En el componente GmailToolkit, selecciona la credencial recién creada en el campo Credential.

Entradas

Campos de Entrada

• CSS Style for PDF generation: Define el estilo CSS que se aplicará al generar PDFs de los correos. Puedes usar el valor por defecto o personalizarlo.

  body {
      font-family: Arial, sans-serif;
      line-height: 1.6;
      max-width: 800px;
      margin: 0 auto;
      padding: 20px;
  }
  h1, h2 {
      color: #333;
  }

• From Email: Especifica la dirección de correo que aparecerá como remitente cuando envíes mensajes. Debe estar en formato Nombre o Alias <email@dominio.com>.
• description: Descripción breve del toolkit, se muestra en la interfaz.

Salidas

• BaseToolkit: Tipo de datos BaseToolkit. Este objeto contiene las herramientas de Gmail (enviar, leer, gestionar) que pueden ser conectadas a otros componentes dentro del flujo de trabajo.

Ejemplo de Uso

1. Configura la credencial: Crea y selecciona la credencial GMail en el componente.
2. Arrastra el componente GmailToolkit al lienzo.
3. Define el remitente: En el campo From Email escribe Mi Empresa <contacto@miempresa.com>.
4. (Opcional) Personaliza el estilo PDF: Si necesitas un PDF con un diseño específico, pega tu CSS en el campo CSS Style for PDF generation.
5. Conecta la salida: Arrastra la salida BaseToolkit a otro componente que requiera herramientas de Gmail, como un EmailSender o un EmailReader.
6. Ejecuta el flujo: El toolkit ahora permite enviar, leer o gestionar correos directamente desde tu flujo de trabajo.

Componentes Relacionados

• EmailSender – Envía correos electrónicos usando el toolkit.
• EmailReader – Lee correos de la bandeja de entrada.
• EmailManager – Gestiona etiquetas y filtros en Gmail.

Consejos y Mejores Prácticas

• Configura la credencial antes de usar el componente para evitar errores de autenticación.
• Revisa el CSS antes de generar PDFs para asegurarte de que el diseño sea el esperado.
• No compartas la credencial con usuarios que no necesiten acceso a tu cuenta de Gmail.
• Actualiza la credencial periódicamente para mantener la seguridad y la compatibilidad con la API de Google.

Consideraciones de Seguridad

• La credencial GMail almacena tokens OAuth2 que otorgan acceso a tu cuenta de Gmail; protégela como cualquier credencial sensible.
• Asegúrate de que el acceso a Google Drive esté limitado solo a los recursos necesarios.
• Utiliza la política de menor privilegio: solicita únicamente los scopes que realmente necesitas (por ejemplo, https://www.googleapis.com/auth/gmail.readonly si solo vas a leer correos).