Saltearse al contenido
Nappai Documentation

Gmail Label

Gmail Label gestiona las etiquetas de tu cuenta de Gmail, las que usas para clasificar los correos: crear una etiqueta nueva, consultar las que tienes y eliminar una que ya no uses.

Suele acompañar a Gmail Message: con este componente preparas las etiquetas y con aquel se las pones o se las quitas a los correos.

Cuándo usarlo

  • Cada vez que das de alta un cliente nuevo, quieres crear una etiqueta con su nombre para clasificar sus correos.
  • Necesitas el identificador de una etiqueta para usarlo en otro paso del flujo.
  • Quieres revisar qué etiquetas existen en una cuenta compartida por varias personas.
  • Al cerrar un proyecto, quieres eliminar la etiqueta que usabas para él.

Configuración

Necesitas una credencial Google Gmail, que se conecta iniciando sesión con tu cuenta de Google. Para crear o eliminar etiquetas, 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. Ver Operaciones. Por defecto, Create Label.
Label NameSolo en Create Label. El nombre de la etiqueta nueva. Obligatorio.
Label IdEl identificador de la etiqueta. Obligatorio en Delete Label. En Get Label es opcional: si lo dejas vacío, devuelve todas las etiquetas de la cuenta.

Operaciones

OperaciónQué hace
Create LabelCrea una etiqueta nueva, visible en la lista de etiquetas de Gmail.
Get LabelDevuelve una etiqueta concreta o todas las de la cuenta.
Delete LabelElimina una etiqueta. Los correos que la tenían no se borran: solo pierden esa etiqueta.

Resultado

La salida Data devuelve las etiquetas con las que has trabajado, con su identificador (id), su nombre (name) y su tipo (system para las de Gmail, como INBOX, y user para las tuyas). Con Get Label y sin Label Id sale un elemento por cada etiqueta. Delete Label devuelve una confirmación.

Puedes usar el identificador en otro paso del flujo o conectar el resultado a un agente de IA. El componente también se puede conectar a un Agente como herramienta, para que el agente cree o consulte etiquetas cuando lo necesite. Ver Tool Mode.

Ejemplo

Un despacho quiere una etiqueta por cada cliente nuevo.

  1. El alta del cliente llega al flujo con su nombre.
  2. Añade Gmail Label con la operación Create Label.
  3. En Label Name pon el nombre del cliente.
  4. A partir de ahí puedes elegir la etiqueta en el campo Labels de Gmail Message para clasificar los correos de ese cliente.

Buenas prácticas

  • Las etiquetas de Gmail (INBOX, SENT, STARRED…) no se pueden eliminar.
  • Si una etiqueta con el mismo nombre ya existe, Gmail no deja crearla otra vez. Consulta antes las etiquetas con Get Label si no estás seguro.

Componentes relacionados