Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt

Use this file to discover all available pages before exploring further.

Gmail es el canal de comunicación formal que complementa la inmediatez de WhatsApp o Slack. Mientras otras integraciones resuelven la coordinación en tiempo real, Gmail permite que tus flujos envíen correos de seguimiento, confirmaciones, propuestas y escalaciones formales desde la cuenta conectada. En Brain Studio, la integración conecta tu buzón para que flujos y agentes envíen, busquen y organicen correos directamente desde la conversación, sin que nadie tenga que abrir Gmail aparte.

​
Qué habilita Gmail

Al conectar Gmail, puedes:
  • Cerrar el loop comercial desde el chat — enviar propuestas, seguimientos o confirmaciones por correo después de una conversación en WhatsApp o webchat
  • Buscar y leer correos existentes para dar contexto al agente antes de responder: hilos previos, adjuntos o estado de una comunicación
  • Organizar el buzón desde el flujo — crear etiquetas, etiquetar mensajes, archivar o mover a papelera según reglas de negocio
  • Preparar borradores para revisión humana antes de enviar correos sensibles
  • Gestionar firmas y alias para mantener consistencia de marca en comunicaciones automatizadas

​
Instalación

​
Requisitos previos

  1. Una cuenta de Google con acceso a Gmail.

​
Cómo conectarla

La forma más directa es usar Jelou Agent: describe lo que necesitas y el agente conecta Gmail automáticamente dentro del flujo. Si prefieres instalar manualmente, sigue estos pasos en el Marketplace. La conexión usa OAuth de Google; no necesitas copiar credenciales.
1

Abrir el Marketplace

En Brain Studio, abre Marketplace desde el menú lateral.
2

Buscar Gmail

Encuentra Gmail en el catálogo y haz clic en Conectar.
3

Autorizar acceso con Google

Se abrirá una ventana de autorización segura de Google. Inicia sesión si hace falta y acepta los permisos solicitados.
4

Confirmar la instalación

Al volver a Brain Studio, deja finalizar el asistente hasta que la integración aparezca como conectada.
En el Marketplace, Gmail debe mostrarse como conectada. Desde el Canvas puedes añadir su nodo, y en AI Agent → Herramientas puedes activarla.

​
Tools disponibles

A alto nivel, las acciones se agrupan así:
  • Consultar — buscar correos, listar etiquetas, hilos y alias.
  • Crear o modificar — enviar correo, crear borradores y etiquetas, añadir o quitar etiquetas, actualizar firmas.
  • Operar flujo — aprobar flujo de trabajo y descargar adjuntos.
  • Eliminar — enviar mensajes a la papelera y archivar correos.
La integración expone 16 tools en Brain Studio; a continuación, cada una con propósito, inputs y ejemplo.
Añade una o más etiquetas a un mensaje existente usando la API de modificación de mensajes.Inputs:
  • messageId (string) — ID del mensaje.
  • addLabelIds (array de string) — IDs de etiquetas a añadir (p. ej. STARRED, IMPORTANT o ID de etiqueta personalizada).
Ejemplo:
{
  "messageId": "188c9a0f12abcde3",
  "addLabelIds": ["Label_123", "STARRED"]
}
Documentación de Google: users.messages.modify
Suspende la ejecución del flujo hasta que se apruebe mediante el mecanismo de aprobación por correo configurado en la plataforma. Útil para pasos que requieren validación humana antes de continuar.Inputs:
  • Depende de la configuración del flujo (identificadores de aprobación, mensaje, destinatarios, etc.). Revisa los campos en Brain Studio.
Los parámetros exactos los define tu flujo y la tool en el builder.
Documentación: suspender y reanudar flujos
Archiva un mensaje (normalmente quitando la etiqueta INBOX u operación equivalente según la implementación).Inputs:
  • messageId (string) — ID del mensaje a archivar.
Ejemplo:
{
  "messageId": "188c9a0f12abcde3"
}
Documentación de Google: users.messages.modify
Crea un borrador de mensaje en la cuenta conectada.Inputs:
  • to (opcional, array de string) — Destinatarios.
  • subject (opcional, string) — Asunto.
  • body / htmlBody (opcional, string) — Cuerpo en texto o HTML.
  • threadId (opcional, string) — Para responder en un hilo existente.
Ejemplo:
{
  "to": ["[email protected]"],
  "subject": "Propuesta (borrador)",
  "body": "Hola, adjuntamos la propuesta para revisión."
}
Documentación de Google: users.drafts.create
Crea una etiqueta nueva en la cuenta de Gmail.Inputs:
  • name (string) — Nombre visible de la etiqueta.
  • messageListVisibility / labelListVisibility (opcional, string) — Visibilidad según la API de Gmail.
Ejemplo:
{
  "name": "Clientes / Prioritario",
  "messageListVisibility": "show",
  "labelListVisibility": "labelShow"
}
Documentación de Google: users.labels.create
Mueve el mensaje a la papelera (no borrado permanente inmediato salvo que la tool indique lo contrario).Inputs:
  • messageId (string) — ID del mensaje.
Ejemplo:
{
  "messageId": "188c9a0f12abcde3"
}
Documentación de Google: users.messages.trash
Obtiene un adjunto por su attachmentId asociado a un mensaje (p. ej. para guardarlo o procesarlo en el flujo).Inputs:
  • messageId (string) — ID del mensaje.
  • attachmentId (string) — ID del adjunto devuelto por la API al listar o obtener el mensaje.
Ejemplo:
{
  "messageId": "188c9a0f12abcde3",
  "attachmentId": "ANGjdJ8..."
}
Documentación de Google: users.messages.attachments.get
Busca mensajes usando el motor de búsqueda de Gmail (misma sintaxis que la barra de búsqueda de Gmail).Inputs:
  • query (string) — Consulta (p. ej. from:[email protected] is:unread).
  • maxResults (opcional, number) — Máximo de resultados.
Ejemplo:
{
  "query": "from:[email protected] subject:Factura is:unread",
  "maxResults": 20
}
Documentación de Google: users.messages.list
Obtiene la configuración de un alias “Enviar como” concreto para el usuario autenticado.Inputs:
  • sendAsEmail (string) — Dirección del alias (debe existir en la configuración de envío).
Ejemplo:
{
  "sendAsEmail": "[email protected]"
}
Documentación de Google: users.settings.sendAs.get
Lista todas las etiquetas de la cuenta (sistema y personalizadas).Inputs:
  • Normalmente ninguno obligatorio.
Ejemplo:
{}
Documentación de Google: users.labels.list
Lista todas las direcciones “Enviar como” configuradas para el usuario.Inputs:
  • Normalmente ninguno obligatorio.
Ejemplo:
{}
Documentación de Google: users.settings.sendAs.list
Obtiene los mensajes de un hilo (conversación) por su threadId.Inputs:
  • threadId (string) — ID del hilo.
Ejemplo:
{
  "threadId": "188c1234abcd5678"
}
Documentación de Google: users.threads.get
Quita una o más etiquetas de un mensaje.Inputs:
  • messageId (string) — ID del mensaje.
  • removeLabelIds (array de string) — IDs de etiquetas a quitar.
Ejemplo:
{
  "messageId": "188c9a0f12abcde3",
  "removeLabelIds": ["INBOX", "UNREAD"]
}
Documentación de Google: users.messages.modify
Envía un correo desde la cuenta conectada, con soporte para HTML, CC, BCC y respuesta en hilo.Inputs:
  • to (array de string) — Destinatarios.
  • subject (string) — Asunto.
  • body (string) — Cuerpo en texto plano si no hay HTML.
  • htmlBody (opcional, string) — Cuerpo HTML.
  • mimeType (opcional, enum) — text/plain | text/html | multipart/alternative.
  • cc / bcc (opcional, array de string)
  • threadId / inReplyTo (opcional, string) — Para responder en un hilo.
Ejemplo:
{
  "to": ["[email protected]"],
  "subject": "Actualización de proyecto",
  "body": "Hola, aquí va el resumen.",
  "htmlBody": "<p>Hola,</p><p>Resumen del <strong>avance</strong>.</p>",
  "cc": ["[email protected]"],
  "threadId": "188c1234abcd5678"
}
Documentación de Google: users.messages.send
Actualiza la firma para una dirección concreta en un contexto de organización. Suele requerir cuenta de servicio de Google Cloud con delegación de dominio y permisos administrativos.Inputs:
  • sendAsEmail (string) — Dirección “Enviar como” a actualizar.
  • signature (string) — Contenido HTML o texto de la firma.
  • Otros campos opcionales según la API (replyToAddress, etc.).
Esta acción no está disponible para todas las cuentas. Si falla o no aparece, confirma con el administrador de Google Workspace y el equipo de soporte de Brain Studio.
Ejemplo:
{
  "sendAsEmail": "[email protected]",
  "signature": "<p>Saludos,<br/>Equipo de soporte</p>"
}
Documentación de Google: users.settings.sendAs.update
Actualiza la firma asociada a la dirección principal de envío del usuario.Inputs:
  • signature (string) — Contenido de la firma (HTML según permita la API).
  • Parámetros adicionales si el formulario los muestra (p. ej. identificador del sendAs por defecto).
Ejemplo:
{
  "signature": "<p>--<br/>Nombre Apellido<br/>Tel: +34 600 000 000</p>"
}
Documentación de Google: users.settings.sendAs.update

​
Cómo usar en Brain

Una vez conectada, puedes usar Gmail en dos superficies:

​
En AI Agent

Ideal cuando el usuario quiere buscar, redactar, responder o etiquetar correo en lenguaje natural.
1

Abre el nodo AI Agent

En el Canvas, selecciona o añade el nodo AI Agent.
2

Abre Herramientas

En el panel derecho, entra a la pestaña Herramientas.
3

Agrega Gmail

Usa Agregar tool, busca Gmail y actívala.
4

Configura las tools

Elige integración completa o activa solo las acciones que necesites. Ajusta el prompt para pedir destinatario, asunto y cuerpo si faltan; usar borrador y confirmación antes de Enviar correo electrónico en mensajes sensibles; y usar búsqueda, etiquetas o archivado cuando el usuario pida organizar la bandeja.
Gmail aparece en la lista de herramientas del agente y puedes abrir su configuración con el icono de ajustes.
El agente decidirá automáticamente cuándo buscar, borronear o enviar correos según la conversación.

​
En Canvas

Ideal cuando necesitas control total del flujo (por ejemplo: validar destinatario → redactar → confirmar → enviar).
1

Arrastra Gmail al Canvas

En el panel lateral, abre Marketplace y arrastra Gmail al flujo.
2

Selecciona la tool

Con el nodo seleccionado, en Tools elige la acción (por ejemplo Enviar correo electrónico).
3

Configura el cuerpo y la memoria

Completa el JSON del cuerpo de la petición y, si aplica, Guardar respuesta en una variable de memoria.
4

Conecta el flujo

Enlaza las salidas Finalizó la tarea y Hubo un error con los nodos siguientes.
El nodo queda listo para ejecutarse en el orden definido por tu flujo.
Ejemplo de configuración: El editor del nodo muestra un cuerpo JSON alineado con la tool Enviar correo electrónico. Los campos dependen de la tool seleccionada; este ejemplo cubre un envío básico con destinatario, asunto y cuerpo desde memoria. 
{
  "to": ["{{$memory.email_destino}}"],
  "subject": "{{$memory.asunto}}",
  "body": "{{$memory.mensaje}}",
  "cc": ["{{$memory.email_cc}}"]
}

​
Casos de uso

El prospecto muestra interés por WhatsApp. En lugar de que el ejecutivo abra Gmail después, el flujo envía la propuesta o el follow-up desde la cuenta conectada en el mismo proceso.Ejemplo concreto: una agencia B2B recibe consultas por webchat. El prospecto pide información de precios. El agente recopila email y necesidad, redacta un correo de seguimiento con la propuesta y lo envía vía Gmail. El lead recibe el correo de seguimiento sin depender de que alguien lo redacte manualmente. Si el flujo requiere revisión, primero crea un borrador para que el ejecutivo lo apruebe.Ideal para: ventas B2B, agencias y SaaS con captación conversacional donde la velocidad del follow-up marca la diferencia.
Cuando una conversación de soporte necesita pasar a correo formal (por política interna, por el tipo de cliente o por trazabilidad), el flujo arma el correo con el contexto del caso y lo envía sin que nadie copie ni pegue.Ejemplo concreto: una empresa de servicios financieros cierra un caso de soporte por WhatsApp. El flujo arma un correo a [email protected] con asunto, resumen del caso, resolución aplicada y referencia del ticket. El hilo de correo queda como respaldo formal del proceso.Ideal para: soporte al cliente, mesa de ayuda, compliance y onboarding donde se necesita comunicación formal con trazabilidad.
Un ejecutivo o profesional puede pedir por WhatsApp “¿tengo correos pendientes de Industrias López?” y el agente busca, resume y hasta prepara un borrador de respuesta.Ejemplo concreto: un consultor independiente con alto volumen de correo. Mientras va camino a una reunión, pregunta por WhatsApp “¿qué me respondió el cliente sobre el presupuesto?”. El agente busca el hilo por remitente y asunto, resume la última respuesta y ofrece redactar un borrador. El consultor aprueba y el correo se envía sin abrir Gmail.Ideal para: profesionales con alto volumen de correo, ejecutivos y equipos pequeños que operan desde el celular.

​
Integraciones que combinan bien con Gmail

Después de agendar una cita en Google Calendar, el flujo puede enviar un correo de confirmación con fecha, hora, enlace de la reunión y material preparatorio.Flujo combinado: evento creado en Google Calendar → correo vía Gmail al invitado con detalles y agenda.Documentación de Google Calendar
Cada correo enviado puede registrarse en una hoja como log operativo: destinatario, asunto, fecha y estado. Útil para seguimiento comercial o auditoría de comunicaciones.Flujo combinado: correo enviado vía Gmail → nueva fila en Sheets con destinatario, asunto y timestamp.Documentación de Google Sheets
El flujo puede actualizar el contacto o la oferta en HubSpot y enviar el correo de seguimiento desde Gmail en el mismo proceso, alineando CRM y comunicación formal.Flujo combinado: oferta actualizada en HubSpot → correo de propuesta al contacto vía Gmail.Documentación de HubSpot
Cuando el correo necesita un adjunto que ya existe en Drive (propuesta, contrato, reporte), el flujo puede localizarlo, ajustar permisos y enlazarlo en el correo sin intervención manual.Flujo combinado: buscar archivo en Drive → generar enlace compartido → enviar correo con enlace vía Gmail.Documentación de Google Drive

​
Artículos relacionados

Integraciones

Catálogo de integraciones disponibles en el Marketplace.

Cómo usar integraciones en Brain

Flujo general para instalar y usar integraciones en Brain Studio.