> ## 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

> Envía correos, busca mensajes y gestiona etiquetas, borradores y firmas de Gmail desde tus flujos en Brain Studio.

**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**](/guides/getting-started/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.

<Steps>
  <Step title="Abrir el Marketplace">
    En Brain Studio, abre **Marketplace** desde el menú lateral.
  </Step>

  <Step title="Buscar Gmail">
    Encuentra **Gmail** en el catálogo y haz clic en **Conectar**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Confirmar la instalación">
    Al volver a Brain Studio, deja finalizar el asistente hasta que la integración aparezca como **conectada**.

    <Check>
      En el **Marketplace**, Gmail debe mostrarse como conectada. Desde el **Canvas** puedes añadir su nodo, y en **AI Agent** → **Herramientas** puedes activarla.
    </Check>
  </Step>
</Steps>

***

## 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.

<AccordionGroup>
  <Accordion title="Añadir etiqueta al correo electrónico">
    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:**

    ```json theme={null}
    {
      "messageId": "188c9a0f12abcde3",
      "addLabelIds": ["Label_123", "STARRED"]
    }
    ```

    [Documentación de Google: `users.messages.modify`](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/modify)
  </Accordion>

  <Accordion title="Aprobar flujo de trabajo">
    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.

    <Note>
      Los parámetros exactos los define tu flujo y la tool en el builder.
    </Note>

    [Documentación: suspender y reanudar flujos](https://pipedream.com/docs/code/nodejs/rerun#flowsuspend)
  </Accordion>

  <Accordion title="Archivar correo">
    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:**

    ```json theme={null}
    {
      "messageId": "188c9a0f12abcde3"
    }
    ```

    [Documentación de Google: `users.messages.modify`](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/modify)
  </Accordion>

  <Accordion title="Crear borrador">
    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:**

    ```json theme={null}
    {
      "to": ["cliente@ejemplo.com"],
      "subject": "Propuesta (borrador)",
      "body": "Hola, adjuntamos la propuesta para revisión."
    }
    ```

    [Documentación de Google: `users.drafts.create`](https://developers.google.com/gmail/api/reference/rest/v1/users.drafts/create)
  </Accordion>

  <Accordion title="Crear etiqueta">
    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:**

    ```json theme={null}
    {
      "name": "Clientes / Prioritario",
      "messageListVisibility": "show",
      "labelListVisibility": "labelShow"
    }
    ```

    [Documentación de Google: `users.labels.create`](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/create)
  </Accordion>

  <Accordion title="Eliminar correo electrónico">
    Mueve el mensaje a la **papelera** (no borrado permanente inmediato salvo que la tool indique lo contrario).

    **Inputs:**

    * **messageId** (string) — ID del mensaje.

    **Ejemplo:**

    ```json theme={null}
    {
      "messageId": "188c9a0f12abcde3"
    }
    ```

    [Documentación de Google: `users.messages.trash`](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/trash)
  </Accordion>

  <Accordion title="Descargar adjunto">
    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:**

    ```json theme={null}
    {
      "messageId": "188c9a0f12abcde3",
      "attachmentId": "ANGjdJ8..."
    }
    ```

    [Documentación de Google: `users.messages.attachments.get`](https://developers.google.com/gmail/api/reference/rest/v1/users.messages.attachments/get)
  </Accordion>

  <Accordion title="Buscar correo electrónico">
    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:ventas@ejemplo.com is:unread`).
    * **maxResults** (opcional, number) — Máximo de resultados.

    **Ejemplo:**

    ```json theme={null}
    {
      "query": "from:ventas@ejemplo.com subject:Factura is:unread",
      "maxResults": 20
    }
    ```

    [Documentación de Google: `users.messages.list`](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/list)
  </Accordion>

  <Accordion title="Obtener Enviar como alias">
    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:**

    ```json theme={null}
    {
      "sendAsEmail": "ventas@miempresa.com"
    }
    ```

    [Documentación de Google: `users.settings.sendAs.get`](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.sendAs/get)
  </Accordion>

  <Accordion title="Listar etiquetas">
    Lista todas las etiquetas de la cuenta (sistema y personalizadas).

    **Inputs:**

    * Normalmente ninguno obligatorio.

    **Ejemplo:**

    ```json theme={null}
    {}
    ```

    [Documentación de Google: `users.labels.list`](https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list)
  </Accordion>

  <Accordion title="Lista de alias para Enviar como">
    Lista todas las direcciones “Enviar como” configuradas para el usuario.

    **Inputs:**

    * Normalmente ninguno obligatorio.

    **Ejemplo:**

    ```json theme={null}
    {}
    ```

    [Documentación de Google: `users.settings.sendAs.list`](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.sendAs/list)
  </Accordion>

  <Accordion title="Listar mensajes del hilo">
    Obtiene los mensajes de un hilo (conversación) por su **threadId**.

    **Inputs:**

    * **threadId** (string) — ID del hilo.

    **Ejemplo:**

    ```json theme={null}
    {
      "threadId": "188c1234abcd5678"
    }
    ```

    [Documentación de Google: `users.threads.get`](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get)
  </Accordion>

  <Accordion title="Eliminar etiqueta del correo">
    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:**

    ```json theme={null}
    {
      "messageId": "188c9a0f12abcde3",
      "removeLabelIds": ["INBOX", "UNREAD"]
    }
    ```

    [Documentación de Google: `users.messages.modify`](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/modify)
  </Accordion>

  <Accordion title="Enviar correo electrónico">
    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:**

    ```json theme={null}
    {
      "to": ["destinatario@ejemplo.com"],
      "subject": "Actualización de proyecto",
      "body": "Hola, aquí va el resumen.",
      "htmlBody": "<p>Hola,</p><p>Resumen del <strong>avance</strong>.</p>",
      "cc": ["lider@ejemplo.com"],
      "threadId": "188c1234abcd5678"
    }
    ```

    [Documentación de Google: `users.messages.send`](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/send)
  </Accordion>

  <Accordion title="Actualizar la firma de correo electrónico en la organización">
    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.).

    <Warning>
      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.
    </Warning>

    **Ejemplo:**

    ```json theme={null}
    {
      "sendAsEmail": "equipo@miempresa.com",
      "signature": "<p>Saludos,<br/>Equipo de soporte</p>"
    }
    ```

    [Documentación de Google: `users.settings.sendAs.update`](https://developers.google.com/gmail/api/reference/rest/v1/users.settings.sendAs/update)
  </Accordion>

  <Accordion title="Actualizar firma para la dirección de correo electrónico principal">
    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:**

    ```json theme={null}
    {
      "signature": "<p>--<br/>Nombre Apellido<br/>Tel: +34 600 000 000</p>"
    }
    ```

    [Documentación de Google: `users.settings.sendAs.update`](https://developers.google.com/gmail/api/reference/rest/v1/users.settings.sendAs/update)
  </Accordion>
</AccordionGroup>

***

## 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.

<Steps>
  <Step title="Abre el nodo AI Agent">
    En el Canvas, selecciona o añade el nodo **AI Agent**.
  </Step>

  <Step title="Abre Herramientas">
    En el panel derecho, entra a la pestaña **Herramientas**.
  </Step>

  <Step title="Agrega Gmail">
    Usa **Agregar tool**, busca **Gmail** y actívala.
  </Step>

  <Step title="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.

    <Check>
      **Gmail** aparece en la lista de herramientas del agente y puedes abrir su configuración con el icono de ajustes.
    </Check>
  </Step>
</Steps>

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).

<Steps>
  <Step title="Arrastra Gmail al Canvas">
    En el panel lateral, abre **Marketplace** y arrastra **Gmail** al flujo.
  </Step>

  <Step title="Selecciona la tool">
    Con el nodo seleccionado, en **Tools** elige la acción (por ejemplo **Enviar correo electrónico**).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Conecta el flujo">
    Enlaza las salidas **Finalizó la tarea** y **Hubo un error** con los nodos siguientes.

    <Check>
      El nodo queda listo para ejecutarse en el orden definido por tu flujo.
    </Check>
  </Step>
</Steps>

**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.

```json theme={null}
{
  "to": ["{{$memory.email_destino}}"],
  "subject": "{{$memory.asunto}}",
  "body": "{{$memory.mensaje}}",
  "cc": ["{{$memory.email_cc}}"]
}
```

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Seguimiento comercial automático después de una conversación">
    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.
  </Accordion>

  <Accordion title="Escalación formal: del chat al correo con contexto completo">
    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 [compliance@empresa.com](mailto:compliance@empresa.com) 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.
  </Accordion>

  <Accordion title="Asistente de inbox para consultas rápidas por chat">
    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.
  </Accordion>
</AccordionGroup>

***

## Integraciones que combinan bien con Gmail

<AccordionGroup>
  <Accordion title="Google Calendar">
    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](/guides/integraciones/agendamiento/google-calendar)
  </Accordion>

  <Accordion title="Google Sheets">
    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](/guides/integraciones/productividad/google-sheets)
  </Accordion>

  <Accordion title="HubSpot">
    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](/guides/integraciones/crm/hubspot)
  </Accordion>

  <Accordion title="Google Drive">
    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](/guides/integraciones/productividad/google-drive)
  </Accordion>
</AccordionGroup>

***

## Artículos relacionados

<CardGroup cols={2}>
  <Card title="Integraciones" href="/guides/integraciones/integraciones" icon="grid">
    Catálogo de integraciones disponibles en el Marketplace.
  </Card>

  <Card title="Cómo usar integraciones en Brain" href="/guides/integraciones/como-usar-integraciones-en-brain" icon="book-open">
    Flujo general para instalar y usar integraciones en Brain Studio.
  </Card>
</CardGroup>