Para administradores
← Todos los temas

Google Workspace: conectar buzones

La conexión con la cuenta del buzón (cliente de la organización) y, además, una cuenta de servicio para buzones compartidos, y qué configurar en Google Cloud y Google Admin, paso a paso.

Para que el asistente pueda leer el correo en Google Workspace y crear borradores en él, necesita acceso a través de la Gmail API. Para ello, la organización crea algo en su propio Google Cloud; draften no tiene una aplicación común a la que usted solo dé su consentimiento. Esto vale tanto para nuestro servicio como para una instalación en su propio servidor.

Todo lo que se describe aquí vale solo para cuentas de Google Workspace con dominio propio. Con una cuenta personal @gmail.com no se puede iniciar sesión en draften; un Gmail personal sí se puede conectar por IMAP con una contraseña de aplicación: consulte Proveedores compatibles y límites.

Qué quiere y qué configurar

Qué quiereQué configurar
Los miembros inician sesión con su cuenta de Google y cada uno tiene su propio buzónel cliente de la organización; con eso basta
Además, buzones en los que nadie inicia sesión (por ejemplo, info@) o un acceso a los buzones configurado de forma centralizada, sin sus propietariosademás, el registro de la organización (cuenta de servicio)
No quiere el inicio de sesión con cuenta de Googlelas personas inician sesión con la contraseña de la invitación y el correo lo conecta el registro de la organización (o IMAP)

Dos cosas distintas en Google

El cliente de la organización y el registro de la organización son dos cosas independientes en Google Cloud. Cada una hace algo distinto y una no sustituye a la otra:

Cliente de la organizaciónRegistro de la organización
Qué esun cliente OAuth con una pantalla de consentimiento de tipo Internaluna cuenta de servicio con clave y domain-wide delegation
Qué haceel inicio de sesión de los miembros con el botón Iniciar sesión con Google y el botón Conectar Gmail en el buzón propioel acceso del asistente a los buzones sin que sus propietarios inicien sesión
Dónde en draftenOrganización › Inicio de sesión y acceso al correo › tarjeta Inicio de sesión con cuenta y conexión de buzonesOrganización › Inicio de sesión y acceso al correo › tarjeta Registros para buzones compartidos y gestión central
Quién lo configura en draftenel propietario de la organizaciónel propietario o un administrador de la organización
Quién lo crea en Googleel administrador de Google Cloudel administrador de Google Cloud y un superadministrador de Google Admin
Quién inicia sesión en el buzónel propietario de cada buzón, una veznadie
A qué buzones llegasolo a los que las personas conectan ellas mismasa todos los buzones del dominio

Son dos cosas a propósito. El consentimiento para el cliente da derechos solo sobre los buzones que las personas conectan ellas mismas, nunca sobre el correo de todo el dominio. La cuenta de servicio, en cambio, llega a cualquier buzón del dominio, y por eso draften solo la usa para el acceso a los buzones, no para el inicio de sesión. No los junte.

Cada buzón usa uno de los dos accesos; puede tener ambos a la vez. draften solo pide el ámbito gmail.modify: leer y crear borradores; no envía nada.

Cliente de la organización: inicio de sesión y Conectar Gmail

El propietario del buzón inicia sesión con su cuenta de Google y permite el acceso solo a su propio correo. El mismo cliente sirve también para iniciar sesión en draften con una cuenta de Google.

En Google Cloud

Trabaja en https://console.cloud.google.com, con la sesión iniciada con una cuenta de administrador de su dominio de Workspace. Todo ocurre en un solo proyecto: el proyecto seleccionado se ve arriba a la izquierda, junto al logotipo de Google Cloud; allí también puede cambiarlo o crear uno nuevo. El menú principal se abre con el icono ☰ arriba a la izquierda.

  1. Primero abra en draften Organización › Inicio de sesión y acceso al correo, la tarjeta Inicio de sesión con cuenta y conexión de buzones. Muestra dos redirect URI exactos para la dirección de su draften: terminan en /auth/google/callback y /mailboxes/connect/google/callback. Cópielos de allí; deben coincidir carácter por carácter.
  2. Elija un proyecto o cree uno nuevo (por ejemplo, draften) y habilite en él la Gmail API: ☰ → APIs & Services → Library, busque Gmail API, ábrala y haga clic en Enable. Directamente: https://console.cloud.google.com/apis/library/gmail.googleapis.com
  3. Configure cómo se presenta la aplicación a los usuarios (consent screen): ☰ → APIs & Services → OAuth consent screen. Se abre la página Google Auth Platform; directamente: https://console.cloud.google.com/auth/overview (compruebe que arriba está seleccionado el proyecto correcto). Haga clic en Get started y recorra el asistente:
    • App Information: App name draften y User support email (su correo electrónico o un grupo de administradores). Next.
    • Audience: elija Internal. Así solo puede iniciar sesión una cuenta de su dominio de Workspace y Google no tiene que verificar la aplicación. Next.
    • Contact Information: el correo electrónico al que Google le enviará avisos sobre la aplicación. Next.
    • Finish: marque la casilla de aceptación de las políticas de Google (I agree to the Google API Services: User Data Policy), haga clic en Continue y después en Create.
  4. Permita los ámbitos a la aplicación. En Google Auth Platform, en el menú de la izquierda, abra Data Access (directamente: https://console.cloud.google.com/auth/scopes) → Add or remove scopes. En la lista, marque openid, .../auth/userinfo.email y .../auth/userinfo.profile. El ámbito de Gmail péguelo en el campo Manually add scopes: https://www.googleapis.com/auth/gmail.modify → Add to table. Haga clic en Update y, abajo, en Save.
  5. Cree el cliente. En Google Auth Platform, en el menú de la izquierda, abra Clients (directamente: https://console.cloud.google.com/auth/clients) → Create client. Application type: Web application, con un nombre, por ejemplo draften. En Authorized redirect URIs, haga clic en Add URI y pegue la primera dirección de la tarjeta; después, otra vez Add URI y la segunda. Haga clic en Create.
  6. Se muestran el Client ID y el Client secret: copie ambos enseguida. Google no vuelve a mostrar el Client secret; si lo pierde, cree uno nuevo en el cliente.

En draften

  1. El propietario de la organización abre Organización › Inicio de sesión y acceso al correo y, en la tarjeta Inicio de sesión con cuenta y conexión de buzones, rellena en Cliente OAuth de Google los valores Client ID y Client secret del paso 6 y hace clic en Guardar.
  2. El inicio de sesión con cuenta de Google lo activa en la misma página, en la tarjeta Cómo inician sesión los miembros: en Dominios de correo de la organización escribe su dominio de Workspace, el principal, no un alias (Google no lo envía al iniciar sesión). En cuanto la organización tiene el cliente y el dominio, los miembros inician sesión con su cuenta de Google y sus contraseñas dejan de funcionar: consulte Cómo inician sesión los miembros.
  3. El propietario del buzón abre la página del buzón y, en la tarjeta Acceso al correo, en la fila Conectar con la cuenta del buzón:, hace clic en Conectar Gmail. Inicia sesión con la cuenta de ese buzón (draften rechaza cualquier otra cuenta) y permite el acceso. El botón solo lo ve el propietario del buzón, y solo si la organización tiene el cliente; sin él, la tarjeta indica en lugar del botón que la conexión con la cuenta será posible cuando el propietario de la organización añada el cliente.
  4. Después, Probar la conexión.

Cuando un buzón se desconecta

Registro de la organización: acceso sin inicio de sesión

Una cuenta de servicio con domain-wide delegation da al asistente acceso a los buzones del dominio sin que nadie inicie sesión. Sirve para buzones en los que nadie inicia sesión (por ejemplo, info@) y para organizaciones que quieren administrar el acceso de forma centralizada. No tiene nada que ver con el inicio de sesión en draften.

En Google Cloud

Trabaja en https://console.cloud.google.com, en el mismo proyecto en el que está habilitada la Gmail API (paso 2 del cliente de la organización; sin cliente, habilítela igualmente). Compruebe el proyecto arriba a la izquierda, junto al logotipo de Google Cloud.

  1. Abra la lista de cuentas de servicio: ☰ → IAM & Admin → Service accounts. Directamente: https://console.cloud.google.com/iam-admin/serviceaccounts
  2. Arriba, haga clic en + Create service account y recorra los tres pasos:
    • Service account details: Service account name, por ejemplo draften-correo (el ID se completa solo). Haga clic en Create and continue.
    • Permissions (optional): no elija nada; no necesita ningún rol en el proyecto, el acceso al correo se lo da la delegación en Google Admin. Haga clic en Continue.
    • Principals with access (optional): no rellene nada y haga clic en Done.
  3. En la lista, haga clic en la nueva cuenta de servicio. En la pestaña Details, copie el Unique ID, un número largo: es el Client ID para Google Admin.
  4. Pestaña Keys → Add key → Create new key → Key type: JSON → Create. El navegador descarga un archivo con la clave (….json).

Si Google rechaza crear la clave, su organización tiene activada la política Disable service account key creation (iam.disableServiceAccountKeyCreation; las organizaciones nuevas la tienen activada de forma predeterminada). El administrador de la organización la desactiva para este proyecto: ☰ → IAM & Admin → Organization policies (https://console.cloud.google.com/iam-admin/orgpolicies), busca iam.disableServiceAccountKeyCreation → Manage policy → Override parent's policy → Enforcement: Off → Set policy. Después, repita el paso 4.

En Google Admin

Necesita una cuenta de superadministrador de Google Workspace.

  1. Abra https://admin.google.com → en el menú de la izquierda, Security → Access and data control → API controls → abajo, Domain wide delegation → Manage domain wide delegation. Directamente: https://admin.google.com/ac/owl/domainwidedelegation
  2. Haga clic en Add new y rellene:
    • Client ID: el Unique ID numérico del paso 3,
    • OAuth scopes (comma-delimited): https://www.googleapis.com/auth/gmail.modify.

    Haga clic en Authorize. La delegación aparece en la lista. Suele aplicarse en pocos minutos y, en casos excepcionales, tarda varias horas.

En draften

  1. Abra Organización › Inicio de sesión y acceso al correo, la tarjeta Registros para buzones compartidos y gestión central. Los registros los administran el propietario o los administradores de la organización.
  2. Sistema: Google Workspace. Rellene Nombre, elija el archivo descargado en Clave de la cuenta de servicio (JSON) y haga clic en Añadir registro. La clave se guarda cifrada; en la tarjeta solo se ven después el correo electrónico de la cuenta de servicio y su Client ID.
  3. En la página de cada buzón, en la tarjeta Acceso al correo, elija este registro en Registro de la organización, haga clic en Aplicar y después en Probar la conexión. El procedimiento con capturas lo muestra la guía «Añadir y conectar un buzón».

Después, elimine el archivo descargado con la clave. Quien lo tenga entra en cualquier buzón del dominio. Una clave nueva de la misma cuenta de servicio (paso 4 de arriba) se sube en el registro con la opción nueva clave (JSON); la clave de otra cuenta de servicio añádala como un registro nuevo. Después, elimine la clave antigua en Google Cloud: cuenta de servicio → pestaña Keys → icono de la papelera junto a la clave antigua.

Con el buzón automático activado (Cómo inician sesión los miembros), un buzón nuevo se vincula solo al registro cuando hay exactamente uno activo para Google Workspace.

Errores de la prueba de la conexión

La prueba comprueba tres pasos: Acceso, Token y permiso y Lectura de la Bandeja de entrada.

En el mensajeQué significaQué hacer
la delegación para el ámbito no está autorizada (unauthorized_client)en Google Admin falta la domain-wide delegation, o tiene otro Client ID u otro ámbitorevisar la delegación en Google Admin: el ID numérico y el ámbito exacto gmail.modify
invalid_grant con la cuenta de servicioese buzón no existe en el dominio de Workspacecomprobar la dirección del buzón
«Gmail API has not been used…»la Gmail API no está habilitada en el proyectohabilitar la Gmail API
token sin gmail.modifyla delegación o la pantalla de consentimiento no tiene el ámbito gmail.modifyañadir el ámbito
invalid_grant, deleted_client con una cuenta conectadala conexión se revocó o se eliminó el clienteVolver a conectar Gmail

Otros errores se describen en Solución de problemas.

Versión en texto