---
title: Gmail
description: Envía, lee, busca y mueve mensajes de Gmail o activa flujos de
  trabajo a partir de eventos de Gmail
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="gmail"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Gmail](https://gmail.com) es el popular servicio de correo electrónico de Google que proporciona una plataforma robusta para enviar, recibir y gestionar comunicaciones por correo electrónico. Con más de 1.800 millones de usuarios activos en todo el mundo, Gmail ofrece una experiencia rica en funciones con potentes capacidades de búsqueda, herramientas de organización y opciones de integración.

Con Gmail, puedes:

- **Enviar y recibir correos electrónicos**: Comunícate con contactos a través de una interfaz limpia e intuitiva
- **Organizar mensajes**: Usa etiquetas, carpetas y filtros para mantener tu bandeja de entrada organizada
- **Buscar eficientemente**: Encuentra mensajes específicos rápidamente con la potente tecnología de búsqueda de Google
- **Automatizar flujos de trabajo**: Crea filtros y reglas para procesar automáticamente los correos entrantes
- **Acceder desde cualquier lugar**: Usa Gmail en diferentes dispositivos con contenido y configuraciones sincronizados
- **Integrar con otros servicios**: Conéctate con Google Calendar, Drive y otras herramientas de productividad

En Sim, la integración con Gmail permite a tus agentes gestionar completamente los correos electrónicos de forma programática con amplias capacidades de automatización. Esto permite potentes escenarios de automatización como enviar notificaciones, procesar mensajes entrantes, extraer información de correos electrónicos y gestionar flujos de comunicación a gran escala. Tus agentes pueden:

- **Redactar y enviar**: Crear correos electrónicos personalizados con archivos adjuntos y enviarlos a destinatarios
- **Leer y buscar**: Encontrar mensajes específicos utilizando la sintaxis de búsqueda de Gmail y extraer contenido
- **Organizar inteligentemente**: Marcar mensajes como leídos/no leídos, archivar o desarchivar correos y gestionar etiquetas
- **Limpiar la bandeja de entrada**: Eliminar mensajes, mover correos entre etiquetas y mantener la bandeja de entrada vacía
- **Activar flujos de trabajo**: Escuchar nuevos correos en tiempo real, permitiendo flujos de trabajo receptivos que reaccionan a los mensajes entrantes

Esta integración cierra la brecha entre tus flujos de trabajo de IA y las comunicaciones por correo electrónico, permitiendo una interacción perfecta con una de las plataformas de comunicación más utilizadas del mundo. Ya sea que estés automatizando respuestas de atención al cliente, procesando recibos, gestionando suscripciones o coordinando comunicaciones de equipo, la integración con Gmail proporciona todas las herramientas que necesitas para una automatización completa del correo electrónico.
{/* MANUAL-CONTENT-END */}

## Instrucciones de uso

Integra Gmail en el flujo de trabajo. Puede enviar, leer, buscar y mover correos electrónicos. Se puede usar en modo de activación para iniciar un flujo de trabajo cuando se recibe un nuevo correo electrónico.

## Herramientas

### `gmail_send`

Enviar correos electrónicos usando Gmail

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `to` | string | Sí | Dirección de correo electrónico del destinatario |
| `subject` | string | No | Asunto del correo electrónico |
| `body` | string | Sí | Contenido del cuerpo del correo electrónico |
| `contentType` | string | No | Tipo de contenido para el cuerpo del correo electrónico \(texto o html\) |
| `threadId` | string | No | ID del hilo para responder \(para encadenar mensajes\) |
| `replyToMessageId` | string | No | ID del mensaje de Gmail para responder - use el campo "id" de los resultados de Gmail Read \(no el "messageId" de RFC\) |
| `cc` | string | No | Destinatarios en CC \(separados por comas\) |
| `bcc` | string | No | Destinatarios en CCO \(separados por comas\) |
| `attachments` | file[] | No | Archivos para adjuntar al correo electrónico |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del correo electrónico |

### `gmail_draft`

Crear borradores de correos electrónicos usando Gmail

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `to` | string | Sí | Dirección de correo electrónico del destinatario |
| `subject` | string | No | Asunto del correo electrónico |
| `body` | string | Sí | Contenido del cuerpo del correo electrónico |
| `contentType` | string | No | Tipo de contenido para el cuerpo del correo electrónico \(texto o html\) |
| `threadId` | string | No | ID del hilo para responder \(para encadenar mensajes\) |
| `replyToMessageId` | string | No | ID del mensaje de Gmail para responder - use el campo "id" de los resultados de Gmail Read \(no el "messageId" de RFC\) |
| `cc` | string | No | Destinatarios en CC \(separados por comas\) |
| `bcc` | string | No | Destinatarios en CCO \(separados por comas\) |
| `attachments` | file[] | No | Archivos para adjuntar al borrador del correo electrónico |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del borrador |

### `gmail_read`

Leer correos electrónicos de Gmail

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | No | ID del mensaje a leer |
| `folder` | string | No | Carpeta/etiqueta de donde leer los correos electrónicos |
| `unreadOnly` | boolean | No | Recuperar solo mensajes no leídos |
| `maxResults` | number | No | Número máximo de mensajes a recuperar (predeterminado: 1, máximo: 10) |
| `includeAttachments` | boolean | No | Descargar e incluir archivos adjuntos del correo electrónico |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Contenido de texto del correo electrónico |
| `metadata` | json | Metadatos del correo electrónico |
| `attachments` | file[] | Archivos adjuntos del correo electrónico |

### `gmail_search`

Buscar correos electrónicos en Gmail

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `query` | string | Sí | Consulta de búsqueda para correos electrónicos |
| `maxResults` | number | No | Número máximo de resultados a devolver |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Resumen de resultados de búsqueda |
| `metadata` | object | Metadatos de búsqueda |

### `gmail_move`

Mover correos electrónicos entre etiquetas/carpetas de Gmail

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Sí | ID del mensaje a mover |
| `addLabelIds` | string | Sí | IDs de etiquetas separados por comas para añadir (ej., INBOX, Label_123) |
| `removeLabelIds` | string | No | IDs de etiquetas separados por comas para eliminar (ej., INBOX, SPAM) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del correo electrónico |

### `gmail_mark_read`

Marcar un mensaje de Gmail como leído

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Sí | ID del mensaje a marcar como leído |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del correo electrónico |

### `gmail_mark_unread`

Marcar un mensaje de Gmail como no leído

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Sí | ID del mensaje para marcar como no leído |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del correo electrónico |

### `gmail_archive`

Archivar un mensaje de Gmail (quitar de la bandeja de entrada)

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Sí | ID del mensaje para archivar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del correo electrónico |

### `gmail_unarchive`

Desarchivar un mensaje de Gmail (volver a la bandeja de entrada)

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Sí | ID del mensaje para desarchivar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del correo electrónico |

### `gmail_delete`

Eliminar un mensaje de Gmail (mover a la papelera)

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Sí | ID del mensaje a eliminar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del correo electrónico |

### `gmail_add_label`

Añadir etiqueta(s) a un mensaje de Gmail

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Sí | ID del mensaje al que añadir etiquetas |
| `labelIds` | string | Sí | IDs de etiquetas separadas por comas para añadir \(p.ej., INBOX, Label_123\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de éxito |
| `metadata` | object | Metadatos del correo electrónico |

### `gmail_remove_label`

Eliminar etiqueta(s) de un mensaje de Gmail

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Sí | ID del mensaje del que eliminar etiquetas |
| `labelIds` | string | Sí | IDs de etiquetas separadas por comas para eliminar \(p.ej., INBOX, Label_123\) |

#### Salida
