Gmail
Gestiona el correo de Gmail desde el agente.
Gmail
Permite que el agente busque, lea, envíe, mueva y elimine correos en Gmail. Requiere una conexión con Google Gmail configurada en el workspace.
Las operaciones disponibles
Al añadir esta herramienta, elige qué operaciones puede ejecutar el agente.
Buscar correos
Busca en la bandeja de entrada con una consulta en el formato de Gmail.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| Consulta | Sí | — | El criterio de búsqueda, al estilo de Gmail (p. ej. from:joao@ejemplo.com, subject:reunión, is:unread, has:attachment) |
| Máximo de resultados | No | 10 | Cuántos mensajes devolver como mucho |
| Incluir spam y papelera | No | false | Con true, se incluyen los mensajes de las carpetas spam y papelera |
Obtener un correo
Devuelve los detalles de un mensaje por su ID.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| ID del correo | Sí | — | El ID único del mensaje |
| Formato | No | full | Cuánto detalle vuelve: full (con el cuerpo), metadata (solo cabeceras), minimal o raw |
Enviar un correo
Envía un mensaje desde la cuenta de Gmail conectada.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| Para | Sí | — | Las direcciones de los destinatarios principales |
| CC | No | — | Las direcciones en copia |
| CCO | No | — | Las direcciones en copia oculta |
| Asunto | Sí | — | El asunto del mensaje |
| Cuerpo | Sí | — | El contenido del mensaje |
| El cuerpo es HTML | No | false | Con true, el cuerpo se trata como HTML. Con false, se envía como texto plano |
| Responder a | No | — | La dirección a la que deben ir las respuestas |
| ID de la conversación | No | — | El ID del hilo, para enviar el mensaje como respuesta dentro de una conversación existente |
Mover un correo
Mueve un mensaje a otra carpeta añadiendo o quitando etiquetas de Gmail.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| ID del correo | Sí | — | El ID único del mensaje que mover |
| Etiquetas que añadir | No | — | Los IDs de etiqueta que añadir (p. ej. INBOX, STARRED, Label_123) |
| Etiquetas que quitar | No | — | Los IDs de etiqueta que quitar (p. ej. INBOX, UNREAD) |
Hay que indicar al menos uno de «Etiquetas que añadir» o «Etiquetas que quitar».
Eliminar un correo
Quita un mensaje, a la papelera o de forma permanente.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| ID del correo | Sí | — | El ID único del mensaje que quitar |
| Mover a la papelera | No | true | Con true, el mensaje va a la papelera (recuperable). Con false, se elimina permanentemente |