Saltearse al contenido
Nappai Documentation

Gmail Webhook

Gmail Webhook pone en marcha un flujo cada vez que pasa algo en tu buzón de Gmail: llega un correo nuevo, se elimina un correo o se le pone o se le quita una etiqueta. Puedes limitarlo a las etiquetas que te interesan, por ejemplo solo la bandeja de entrada.

NappAI revisa tu buzón aproximadamente cada minuto y, si encuentra cambios, ejecuta el flujo con los datos de cada correo afectado. No tienes que configurar nada en Google: basta con la credencial y con suscribir el flujo.

Cuándo usarlo

  • Quieres que un agente de IA lea cada correo que llega a la bandeja de entrada y prepare una respuesta.
  • Llegan pedidos o facturas por correo y quieres registrarlos en una hoja de cálculo en cuanto entran.
  • Quieres avisar a tu equipo cuando alguien marca un correo como importante o con estrella.
  • Necesitas llevar un registro de los correos que se eliminan de una cuenta compartida.

Configuración

Necesitas una credencial Google Gmail, que se conecta iniciando sesión con tu cuenta de Google. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Google Gmail de la cuenta que quieres vigilar.
EventsLos cambios que inician el flujo: Message Added (llega o se importa un correo), Message Deleted (un correo se elimina de forma definitiva, por ejemplo al vaciar la papelera), Label Added (se pone una etiqueta a un correo) y Label Removed (se le quita una etiqueta). Por defecto, Message Added.
Label FiltersLas etiquetas que se vigilan: INBOX, SENT, DRAFT, STARRED, IMPORTANT, UNREAD, CATEGORY_PERSONAL, CATEGORY_SOCIAL, CATEGORY_PROMOTIONS, CATEGORY_UPDATES o CATEGORY_FORUMS. Por defecto, INBOX. Si no eliges ninguna, se usa INBOX.
DataCampo de prueba. Te permite probar el flujo con un evento de ejemplo sin esperar a que pase algo en Gmail. Déjalo vacío en el uso normal.

Activar la suscripción

El flujo solo recibe cambios cuando está suscrito:

  1. Guarda el flujo y publica una versión. Para suscribirte necesitas una versión publicada del flujo. Consulta Versiones y publicación.
  2. En el panel de ajustes del nodo pulsa Suscribirse.
  3. En el panel que se abre pulsa Suscribirse. El estado pasa a Sincronizado.

Solo llegan los cambios que ocurren después de suscribirte. Si más adelante cambias los eventos o las etiquetas, el estado aparece como Desincronizado: vuelve a suscribirte para aplicar los cambios. Desde el mismo panel puedes Cancelar suscripción cuando ya no quieras recibir cambios.

Resultado

La salida Data contiene un elemento por cada cambio, con el tipo de cambio (messageAdded, messageDeleted, labelAdded o labelRemoved) y el identificador del correo (messageId). En los correos nuevos incluye además el remitente (from), los destinatarios (to), el asunto (subject), la fecha, un resumen corto (snippet), sus etiquetas y el identificador de la conversación (threadId). En los cambios de etiqueta, las etiquetas que se han puesto o quitado. Si llegan varios cambios a la vez, salen todos juntos.

El resultado no trae el texto completo del correo. Para leerlo, conecta Gmail Message con la operación Get Message y el messageId en Email Id., o pasa los datos directamente a un agente de IA.

Ejemplo

Una tienda en línea recibe los pedidos de sus distribuidores por correo.

  1. Añade Gmail Webhook y elige la credencial Google Gmail de la tienda.
  2. Deja Events en Message Added y Label Filters en INBOX.
  3. Conecta la salida Data a Gmail Message con la operación Get Message para leer el texto del pedido, y después a un agente que extraiga los productos y las cantidades.
  4. Publica el flujo y pulsa Suscribirse.

Buenas prácticas

  • Elige solo los eventos y las etiquetas que necesitas: el flujo se ejecuta menos veces y solo con lo que te interesa.
  • Si el flujo envía correos desde la misma cuenta y vigilas SENT, se volverá a ejecutar con sus propios correos. Vigila INBOX o filtra por remitente dentro del flujo.

Componentes relacionados