Google Gmail Thread

El Google Gmail Thread es un componente de Nappai que te permite trabajar directamente con los hilos de correo de tu cuenta de Gmail. Con él puedes leer mensajes, añadir o quitar etiquetas, eliminar hilos o moverlos a la papelera, todo desde el mismo dashboard de Nappai.

¿Cómo funciona?

El componente se conecta a la Google Gmail API. Cuando lo añades a tu flujo, Nappai envía las peticiones HTTP necesarias a la API de Gmail usando la credencial que hayas configurado previamente. Dependiendo de la operación seleccionada, el componente construye la solicitud adecuada (por ejemplo, modifyThread, deleteThread, getThread o trashThread) y devuelve los datos recibidos de Gmail. Si el modo de mapeo está activado, el componente puede procesar varios hilos a la vez, leyendo cada registro de la entrada “Mapping Data” y enviando una petición por cada uno.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

Modify Label in Thread: Añade o elimina etiquetas de un hilo de correo.
Delete Thread: Elimina permanentemente un hilo de correo.
Get Thread: Lee y devuelve la información de uno o varios hilos.
Trash Thread: Mueve un hilo a la papelera.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

Fixed (Fijo): Escribes el valor directamente en el campo.
Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Operation: Selecciona la operación que quieres ejecutar.
- Visible en: Modify Label in Thread, Delete Thread, Get Thread, Trash Thread
Labels: Etiquetas para filtrar correos. Puedes usar varias etiquetas.
- Visible en: Modify Label in Thread, Get Thread
Select Action: Selecciona la acción que quieres realizar sobre la etiqueta del hilo.
- Visible en: Modify Label in Thread
Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
- Visible en: Modify Label in Thread, Delete Thread, Get Thread, Trash Thread
Number of Emails to read: Número de correos a leer. Si lo dejas vacío, leerá por defecto 10 hilos.
- Visible en: Get Thread
Query: Consulta para filtrar correos. Con esta consulta puedes filtrar los correos que quieres leer si el mensaje contiene la consulta.
- Visible en: Get Thread
Thread Id: Id del hilo. Si no se proporciona en get threads, devolverá todos los hilos.
- Visible en: Modify Label in Thread, Delete Thread, Get Thread, Trash Thread
Select Action: Selecciona la acción que quieres realizar sobre el hilo.
- Visible en: Trash Thread
Tool Name: El nombre de la herramienta que se usará cuando este componente esté conectado como una herramienta. Este nombre se mostrará al agente cuando elija herramientas para usar.
- Visible en: Modify Label in Thread, Delete Thread, Get Thread, Trash Thread
Tool Description: Una descripción detallada de lo que hace esta herramienta. Esta descripción ayudará al agente a entender cuándo y cómo usarla de manera efectiva.
- Visible en: Modify Label in Thread, Delete Thread, Get Thread, Trash Thread
Tools arguments metadata: Define los metadatos de los argumentos para las herramientas.
- Visible en: Modify Label in Thread, Delete Thread, Get Thread, Trash Thread

Credencial
Este componente requiere una credencial de tipo GMail.

Configura primero la credencial GMail en la sección de credenciales de Nappai.

Luego selecciona esa credencial en el campo Credential del componente.
La credencial GMail necesita:

Client Id (clave de cliente de Google Cloud)

Client Secret (secreto de cliente de Google Cloud)

Google drive access (opción de acceso a Google Drive)

Salidas

Data: Devuelve los datos obtenidos de Gmail (por ejemplo, la lista de hilos o la información de un hilo).
Tool: Devuelve una herramienta que puede ser utilizada por agentes de IA para ejecutar la operación seleccionada.

Ejemplo de Uso

Escenario: Quieres leer los 5 hilos más recientes que tengan la etiqueta “ProyectoX” y luego añadirles la etiqueta “Revisado”.

Añade el componente Google Gmail Thread al flujo.
Selecciona la operación Get Thread.
En Labels escribe ProyectoX.
En Number of Emails to read escribe 5.
Conecta la salida Data a un componente de mapeo (por ejemplo, un Mapper) para extraer los IDs de los hilos.
Añade otro componente Google Gmail Thread y selecciona la operación Modify Label in Thread.
Conecta la salida Data del mapper a la entrada Thread Id del segundo componente.
En Labels escribe Revisado.
En Select Action elige Add.
Ejecuta el flujo y observa que los hilos seleccionados reciben la nueva etiqueta.

Componentes Relacionados

Consejos y Mejores Prácticas

Usa el modo de mapeo cuando necesites procesar varios hilos a la vez; evita ejecutar el componente varias veces.
Limita la cantidad de hilos que lees en una sola operación para no superar los límites de la API de Gmail (por defecto 10, pero puedes cambiarlo).
Revisa las etiquetas antes de añadirlas o eliminarlas para evitar errores.
Guarda la salida en una variable de flujo para usarla en pasos posteriores (por ejemplo, para enviar notificaciones).

Consideraciones de Seguridad

La credencial GMail debe guardarse con cuidado; no la compartas públicamente.
Asegúrate de que la cuenta de Gmail tenga los permisos necesarios (lectura, escritura, borrado) según la operación que vayas a usar.
Si usas el componente como herramienta para agentes, revisa que la descripción de la herramienta sea clara para evitar usos indebidos.