Conecta tu cuenta de Gmail a Goodweek para leer, enviar y gestionar correos electrónicos directamente desde tu espacio de trabajo de IA.
ℹ️ Nota de gobernanza
Goodweek nunca superará los niveles de acceso otorgados al usuario dentro de Gmail, lo que garantiza la alineación con las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.
📋 Requisitos previos
Antes de que cualquier usuario pueda ver y conectar la integración de Gmail, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.
Configuración del administrador
Cuentas personales de Google (@gmail.com)
No se requiere configuración por parte del administrador. Conéctate directamente siguiendo los pasos de Conexión del usuario que se indican a continuación.
Cuentas de Google Workspace (trabajo o centro educativo)
Según la política de acceso a la API de tu organización, puede aplicarse uno de los siguientes escenarios.
Escenario 1 — Predeterminado (acceso de terceros sin restricciones)
Cualquier usuario puede conectarse directamente sin intervención del administrador.
Escenario 2 — El acceso de terceros está restringido (error admin_policy_enforced)
Un superadministrador de Google Workspace debe marcar Composio como una aplicación de confianza:
Inicia sesión en admin.google.com como superadministrador.
Ve a Seguridad → Control de acceso y datos → Controles de API → Gestionar el acceso de aplicaciones de terceros.
Haz clic en Configurar nueva aplicación, busca Composio, selecciónala, establece el acceso en De confianza y haz clic en Guardar.
Escenario 3 — Todo el acceso de terceros a la API está bloqueado
Ve a admin.google.com → Seguridad → Controles de API y revisa la configuración «Acceso de aplicaciones de terceros a las API de Google». Si está bloqueado, el administrador debe crear una excepción para Composio antes de seguir el Escenario 2.
Conexión del usuario
En Goodweek, ve a Integraciones.
Busca Gmail y haz clic en Conectar.
Serás redirigido a Google, donde se te pedirá que inicies sesión.
Revisa los permisos solicitados y haz clic en Permitir para volver a Goodweek.
Notas importantes
Cada usuario debe conectar su propia cuenta de forma individual.
Goodweek solo puede acceder a los correos y los datos a los que tenga acceso tu cuenta de usuario individual.
Si tienes varias cuentas de Google, asegúrate de seleccionar la correcta durante el paso de conexión. Google puede preseleccionar automáticamente la última cuenta que usaste.
Los tokens de OAuth de Gmail pueden invalidarse si el administrador de tu Google Workspace cambia la duración de la sesión o las políticas de acceso a la API. Si la integración deja de funcionar de forma inesperada, intenta desconectarla y volver a conectarla.
Puedes revocar el acceso de Goodweek en cualquier momento desde myaccount.google.com → Seguridad → Aplicaciones de terceros con acceso a la cuenta.
Herramientas disponibles
Herramienta | Descripción | Tipo |
Send Email | Envía un correo electrónico de inmediato mediante la API de Gmail utilizando el nombre visible del usuario autenticado. | Escritura |
Reply to Email Thread | Envía una respuesta dentro de un hilo de Gmail específico, conservando el asunto original y el contexto del hilo. | Escritura |
Forward Email Message | Reenvía un mensaje de Gmail existente a los destinatarios especificados, conservando el cuerpo y los archivos adjuntos originales. | Escritura |
Create Email Draft | Crea un borrador de correo en Gmail sin enviarlo, para revisarlo antes de enviarlo. | Escritura |
Update Draft | Reemplaza el contenido de un borrador de Gmail existente in situ mediante el ID del borrador. | Escritura |
Send Draft | Envía un borrador de correo existente tal cual a sus destinatarios definidos. | Escritura |
Get Draft | Recupera un único borrador de Gmail mediante su ID. | Lectura |
List Drafts | Recupera una lista paginada de borradores de correo de la cuenta de Gmail del usuario. | Lectura |
Fetch Emails | Recupera una lista de mensajes de correo de una cuenta de Gmail con filtrado, paginación y recuperación opcional del contenido completo. | Lectura |
Fetch Message by Message ID | Recupera un mensaje de correo específico mediante su ID. | Lectura |
Fetch Message by Thread ID | Recupera todos los mensajes de un hilo de Gmail mediante el ID del hilo. | Lectura |
List Threads | Recupera una lista de hilos de correo de una cuenta de Gmail con filtrado y paginación. | Lectura |
Get Gmail Attachment | Recupera un archivo adjunto específico de un mensaje de Gmail mediante su ID de archivo adjunto. | Lectura |
Get Profile | Recupera la información del perfil de Gmail, incluida la dirección de correo y las estadísticas del buzón. | Lectura |
Get Contacts | Recupera los contactos de la cuenta de Google autenticada, con selección de campos y paginación opcionales. | Lectura |
Search People | Busca contactos comparando una consulta con nombres, correos electrónicos, números de teléfono y organizaciones. | Lectura |
Modify Email Labels | Añade o elimina etiquetas de Gmail de un mensaje específico. | Escritura |
Batch Modify Gmail Messages | Modifica etiquetas en hasta 1000 mensajes de Gmail en una sola llamada a la API. | Escritura |
Create Label | Crea una nueva etiqueta de Gmail con un nombre único en la cuenta del usuario. | Escritura |
List Gmail Labels | Recupera todas las etiquetas del sistema y creadas por el usuario de una cuenta de Gmail. | Lectura |
Create Gmail Filter | Crea un nuevo filtro de Gmail con criterios y acciones específicos para organizar el correo entrante. | Escritura |
List Gmail Filters | Muestra una lista de todos los filtros (reglas) de Gmail del buzón. | Lectura |
Get Vacation Settings | Recupera la configuración del respondedor de vacaciones para comprobar si las respuestas automáticas de ausencia están activas. | Lectura |
Update Vacation Settings | Configura las respuestas automáticas de ausencia para un usuario de Gmail. | Escritura |
Move to Trash | Mueve un mensaje de correo a la papelera (recuperable). | ⚠️ Destructivo |
Trash Thread | Mueve un hilo de correo completo y todos sus mensajes a la papelera. | ⚠️ Destructivo |
Batch Delete Gmail Messages | Elimina de forma permanente varios mensajes de Gmail en bloque, sin pasar por la papelera y sin posibilidad de recuperación. | ⚠️ Destructivo |
Delete Thread | Elimina de forma permanente e inmediata un hilo y todos sus mensajes. Esta acción no se puede deshacer. | ⚠️ Destructivo |
Casos de uso
Envía y responde correos desde Goodweek. Redacta, envía y responde mensajes de Gmail directamente desde una conversación de Goodweek, manteniendo la comunicación por correo en el contexto del trabajo que ya estás realizando.
Lee y muestra correos relevantes bajo demanda. Busca en tu bandeja de entrada por remitente, asunto o palabras clave para recuperar correos específicos y llevarlos a una conversación de Goodweek para revisarlos o consultarlos.
Redacta borradores para revisarlos antes de enviarlos. Crea borradores de correo en Gmail a través de Goodweek y luego revísalos y envíalos en el momento adecuado, algo útil cuando necesitas preparar comunicaciones con antelación.
Gestiona la organización de tu bandeja de entrada. Aplica etiquetas a los correos, crea filtros de Gmail para el correo entrante o mueve mensajes a la papelera desde Goodweek para mantener tu bandeja de entrada ordenada sin cambiar a la interfaz de Gmail.
Solución de problemas
«Error 400: admin_policy_enforced» al conectar
Este es el problema más común para los usuarios de Google Workspace. Solo un superadministrador de Google Workspace puede resolverlo siguiendo el Escenario 2 descrito anteriormente.
El administrador marcó Composio como de confianza, pero el error sigue apareciendo
Puede haber un retraso en la propagación. Espera unos minutos y vuelve a intentarlo. Si el error persiste, verifica que se seleccionó la aplicación Composio correcta y que el nivel de acceso se guardó como De confianza y no como Limitado.
Se conectó la cuenta de Google incorrecta
Desconecta la integración de Goodweek y vuelve a conectarla. Haz clic en «Usar otra cuenta» durante el paso de autenticación de Google, o abre una ventana de navegación de incógnito para evitar la selección automática de cuenta.
La integración dejó de funcionar después de conectarse correctamente
Es posible que el administrador de tu Google Workspace haya cambiado las políticas de acceso a la API. Intenta desconectar y volver a conectar la integración. Si el problema persiste, pide a tu administrador que verifique que Composio siga marcado como De confianza.
La integración no aparece en Goodweek
Asegúrate de que el administrador de tu organización haya habilitado la integración de Gmail desde el Panel de administración de Goodweek, en la pestaña Integraciones.