Saltearse al contenido
Nappai Documentation

Gmail Thread

Gmail Thread trabaja con conversaciones de Gmail, lo que Gmail llama hilos: el correo original y todas sus respuestas juntos. Con él puedes listar las conversaciones de una etiqueta, enviar una conversación a la papelera o sacarla de ella, y eliminarla.

Úsalo cuando la unidad de trabajo es la conversación entera y no un correo suelto. Para enviar, leer o responder correos concretos, usa Gmail Message.

Cuándo usarlo

  • Quieres obtener la lista de conversaciones recientes de una etiqueta para revisarlas o contarlas.
  • Después de atender una consulta, quieres mandar toda la conversación a la papelera.
  • Un agente de IA ha enviado a la papelera una conversación por error y quieres recuperarla.
  • Quieres eliminar de forma definitiva las conversaciones de una campaña ya cerrada.

Configuración

Necesitas una credencial Google Gmail, que se conecta iniciando sesión con tu cuenta de Google. Para mover o eliminar conversaciones, la credencial debe tener el acceso Create, Update, Delete, Read. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Google Gmail de la cuenta con la que trabajas.
OperationLo que hace el componente: Get Thread, Trash Thread o Delete Thread. Ver Operaciones.
Thread IdEl identificador de la conversación. Obligatorio en Trash Thread y Delete Thread. En Get Thread es opcional: si lo rellenas, solo devuelve esa conversación.
LabelsSolo en Get Thread. La etiqueta de la que se leen las conversaciones, por ejemplo INBOX. La lista se carga con las etiquetas de tu cuenta al elegir la credencial.
Select ActionSolo en Trash Thread. Trash envía la conversación a la papelera y Untrash la saca de ella. Por defecto, Trash.

Operaciones

OperaciónQué hace
Get ThreadDevuelve las conversaciones más recientes de una etiqueta, o una sola si indicas su Thread Id.
Trash ThreadEnvía una conversación a la papelera o la recupera, según Select Action.
Delete ThreadElimina una conversación de forma definitiva, sin pasar por la papelera.

Opciones avanzadas

Solo en Get Thread:

CampoQué hace
QueryFiltra las conversaciones con la misma búsqueda que usarías en Gmail, por ejemplo from:cliente@empresa.com o subject:presupuesto.
Number of Emails to readCuántas conversaciones leer, empezando por las más recientes. Por defecto, 10.

Resultado

La salida Data depende de la operación:

  • En Get Thread, un elemento por cada conversación, con su identificador (id) y un resumen corto de su contenido (snippet). Usa ese identificador en Thread Id para enviarla a la papelera o eliminarla.
  • En Trash Thread, los datos del correo con el que empieza la conversación después del cambio.
  • En Delete Thread, una confirmación.

Puedes conectar el resultado a un agente de IA o a otro componente del flujo. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo consultar o archivar conversaciones. Ver Tool Mode.

Ejemplo

Un equipo de soporte quiere limpiar cada viernes las conversaciones de una etiqueta Resueltas.

  1. Programa el flujo para que se ejecute los viernes. Consulta Programador.
  2. Añade Gmail Thread con la operación Get Thread y elige Resueltas en Labels.
  3. Conecta la salida a un Agente que tenga como herramienta otro Gmail Thread con la operación Trash Thread, y pídele en sus instrucciones que envíe a la papelera cada conversación de la lista.
  4. Revisa la papelera de Gmail la primera vez para comprobar que se han movido las conversaciones correctas.

Buenas prácticas

  • Delete Thread no se puede deshacer y borra todos los correos de la conversación. Si dudas, usa Trash Thread: Gmail guarda la papelera durante un tiempo y puedes recuperarla con Untrash.
  • En Get Thread, Thread Id solo encuentra la conversación si está entre las que se leen con Number of Emails to read, Labels y Query.

Componentes relacionados