Integraciones de Gmail
Conecta cuentas de Gmail con Google OAuth para que tus agentes de IA envíen correo desde tu propia dirección.
Objetivo
Conecta una o varias cuentas de Gmail mediante Google OAuth para que tus agentes de IA envíen correo desde tu propia dirección. Esta página lista las cuentas conectadas, permite conectar más, desconectarlas y reconectar cuando se requiere un permiso nuevo.
La lectura de correo entrante se gestiona por separado (ver Gmail Inbox más abajo); esta página administra la conexión de envío saliente.
Acceso
Sidebar -> Integrations -> tarjeta Gmail -> Connect Gmail / Manage.
Ruta: /app/{tenant}/integrations/gmail
La ruta antigua /app/{tenant}/settings/email redirige aquí.
Roles
- owner, admin, agent (la sección Integrations está disponible para estos roles).
Requisitos previos
- Un correo de cuenta verificado. Si tu cuenta no está verificada, aparece un modal de verificación que bloquea la conexión.
- Al menos un agente de IA con el canal Email habilitado, para poder elegirlo en Assign Agent. Sin uno, el diálogo de conexión muestra Go to Agents en su lugar.
- Cupo disponible de cuentas de correo en tu plan. Al alcanzar el límite se abre un diálogo de límite de plan en vez de conectar.
Conectar una cuenta de Gmail
- Abre Integrations -> Gmail y pulsa Connect Gmail (o Connect Another Account si ya hay una conectada).
- En el diálogo Connect Gmail Account, elige el agente en Assign Agent (se selecciona solo cuando hay un único agente elegible).
- Pulsa Continue y completa la pantalla de consentimiento de Google.
- Al completarse, vuelves a esta página con la cuenta en la lista.
Campos:
| Campo | Obligatorio | Formato | Ejemplo | Nota |
|---|---|---|---|---|
| Assign Agent | Sí | selección | Support Agent | Lista los agentes con el canal Email habilitado. La credencial se guarda para todo el tenant; el agente queda vinculado para enviar desde esta dirección. |
Permisos solicitados durante el consentimiento:
| Permiso | Propósito |
|---|---|
| Send emails on your behalf | Permite a los agentes enviar correo saliente desde la cuenta. |
| Manage labels and categories | Aplica etiquetas para sincronización y organización. |
Las credenciales se cifran y se almacenan de forma segura.
Cuentas conectadas
Cada cuenta conectada se muestra como una tarjeta con estos controles:
| Control | Comportamiento |
|---|---|
| Badge de estado | Active o Disconnected, según la conexión almacenada. Los tokens de acceso se renuevan de forma automática, por lo que una cuenta activa sigue funcionando sin acción manual. |
| Go to Inbox | Abre la bandeja de entrada de correo unificada. |
| Disconnect (icono de papelera) | Abre un diálogo de confirmación. Yes, Disconnect revoca el acceso en Google y elimina las credenciales almacenadas. |
Desconectar también desvincula la cuenta de las herramientas de envío del agente; se vuelven a vincular automáticamente si reconectas la misma dirección más adelante.
Reconectar para sincronizar etiquetas
Las cuentas conectadas antes de añadirse el permiso de etiquetas deben reconectarse una vez. En la vista general de Integrations, la tarjeta Gmail muestra un aviso Reconnect required ("Gmail needs the new permission to sync labels and sent mail.") con una acción Reconnect Gmail o Review accounts. Reconectar vuelve a ejecutar el flujo de consentimiento y otorga el permiso nuevo.
Gmail Inbox (integración separada)
La lectura de correo entrante usa una integración Gmail Inbox aparte que requiere aprobación de Google y se está habilitando de forma gradual. Si necesitas lectura de Gmail entrante, contacta con soporte.
Buenas prácticas
- Reconecta pronto cuando veas el aviso Reconnect required, para que las etiquetas y el correo enviado sigan sincronizados.
- Prefiere OAuth frente a app passwords: es más seguro y el acceso se puede revocar en cualquier momento desde tu Cuenta de Google.
- Desconecta una cuenta que ya no uses para revocar el acceso y eliminar las credenciales almacenadas.
Notas comunes
- Cancelar la pantalla de consentimiento de Google te devuelve a esta página sin conectar.
- Alcanzar el límite de cuentas de correo de tu plan abre un diálogo de límite de plan con opciones de mejora en vez de conectar.
- Si el correo de tu cuenta no está verificado, verifícalo primero; hasta entonces el botón de conexión abre un modal de verificación.
- Si una conexión se completa sin un token de larga duración, puede expirar en aproximadamente una hora y se crea una notificación. Desconecta y reconecta la cuenta para restaurar el acceso.
Captura
