Para que el asistente pueda leer el correo en Microsoft 365 y crear borradores en él, necesita acceso a través de Microsoft Graph. Para ello, la organización registra una aplicación en su propio Microsoft Entra ID; 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 profesionales y educativas de Microsoft 365. Las cuentas personales outlook.com, hotmail.com y live.com no se pueden conectar de ninguna forma: consulte Proveedores compatibles y límites.
Qué quiere y qué configurar
| Qué quiere | Qué configurar |
|---|---|
| Los miembros inician sesión con su cuenta de Microsoft y cada uno tiene su propio buzón | el cliente de la organización; con eso basta |
| Además, buzones compartidos (info@, ventas@) o un acceso a los buzones configurado de forma centralizada, sin sus propietarios | además, el registro de la organización |
| No quiere el inicio de sesión con cuenta de Microsoft | las 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 aplicaciones distintas
El cliente de la organización y el registro de la organización son dos aplicaciones independientes en Entra. Cada una hace algo distinto y una no sustituye a la otra:
| Cliente de la organización | Registro de la organización | |
|---|---|---|
| Qué hace | el inicio de sesión de los miembros con el botón Iniciar sesión con Microsoft y el botón Conectar Outlook en el buzón propio | el acceso del asistente a los buzones sin que sus propietarios inicien sesión |
| Dónde en draften | Organización › Inicio de sesión y acceso al correo › tarjeta Inicio de sesión con cuenta y conexión de buzones | Organización › Inicio de sesión y acceso al correo › tarjeta Registros para buzones compartidos y gestión central |
| Quién lo configura en draften | el propietario de la organización | el propietario o un administrador de la organización |
| Permisos en Entra | delegados (Delegated) | de aplicación (Application) |
| Quién inicia sesión en el buzón | el propietario de cada buzón, una vez | nadie |
| A qué buzones llega | solo a los que las personas conectan ellas mismas | a los buzones del directorio (se puede restringir) |
| Buzones compartidos | no: no tienen inicio de sesión propio | sí |
| Cuando alguien deja la empresa | al bloquearse su cuenta, el buzón se desconecta | no cambia nada |
Son dos aplicaciones 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 toda la organización. El registro de la organización, en cambio, llega a todos los buzones, y por eso draften solo lo usa para el acceso a los buzones, no para el inicio de sesión. No los junte en una sola aplicación.
Cada buzón usa uno de los dos accesos. Puede tener ambas aplicaciones a la vez: por ejemplo, el cliente para el inicio de sesión y los buzones propios, y el registro para el buzón compartido info@.
Nunca dé a ninguna de las dos aplicaciones el permiso Mail.Send. draften no envía nada y sin ese permiso ni siquiera podría hacerlo: de eso se trata.
Cliente de la organización: inicio de sesión y Conectar Outlook
El cliente tiene permisos delegados: la aplicación solo puede hacer lo que puede hacer la persona que ha iniciado sesión, y solo en su propio buzón. Se crea una vez; después, los propietarios de los buzones se conectan por sí mismos y ya no necesitan al administrador de Entra.
En Microsoft Entra
Trabaja en el Microsoft Entra admin center, https://entra.microsoft.com, con la sesión iniciada con una cuenta de administrador de su directorio de Microsoft 365.
- 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/callbacky/mailboxes/connect/callback. Cópielos de allí; deben coincidir carácter por carácter. - Abra la lista de registros de aplicaciones: en el menú de la izquierda, Entra ID → App registrations (en la versión anterior del menú, Identity → Applications → App registrations). Directamente: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
- Arriba, haga clic en + New registration y rellene:
- Name: por ejemplo
draften – inicio de sesión, - Supported account types: Accounts in this organizational directory only (… only - Single tenant),
- Redirect URI: en la lista desplegable Select a platform elija Web y, al lado, pegue la primera dirección de la tarjeta (termina en
/auth/callback).
Haga clic en Register. Se abre la página de la nueva aplicación.
- Name: por ejemplo
- En la página Overview, copie el Application (client) ID y el Directory (tenant) ID (icono de copiar junto al valor).
- En el menú de la aplicación, a la izquierda, abra Authentication. En la plataforma Web, en la parte Redirect URIs, haga clic en Add URI, pegue la segunda dirección de la tarjeta (termina en
/mailboxes/connect/callback) y, abajo, haga clic en Save. - Certificates & secrets → pestaña Client secrets → + New client secret. Description, por ejemplo
draften; en Expires elija la validez (24 meses como máximo) y haga clic en Add. En la tabla, copie enseguida el valor de la columna Value: solo se muestra ahora; el Secret ID no lo necesita draften. Anote también la fecha de la columna Expires. - API permissions → + Add a permission → Microsoft Graph → Delegated permissions. Escriba en la búsqueda y marque uno por uno
openid,profile,email,offline_access,User.Read,Mail.ReadWriteyMailboxSettings.ReadWritey, abajo, haga clic en Add permissions.User.Readsuele estar en la lista desde la creación. Sinoffline_accessla conexión no se mantiene: draften no recibiría un token de actualización. - En la misma página, haga clic en Grant admin consent for … y confirme con Yes. Todas las filas deben tener una marca verde en la columna Status. Si su organización no permite a los usuarios dar su consentimiento a aplicaciones, sin este paso la conexión terminaría con un mensaje de que se rechazó el consentimiento.
En draften
- 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 Registro de Entra para «Iniciar sesión con Microsoft» y «Conectar Outlook» los valores Application (client) ID (paso 4) y Client secret (paso 6) y hace clic en Guardar.
- El inicio de sesión con cuenta de Microsoft lo activa en la misma página, en la tarjeta Cómo inician sesión los miembros: en ID del directorio de Microsoft (Entra) pega el Directory (tenant) ID. En cuanto la organización tiene el cliente y el ID del directorio, los miembros inician sesión con su cuenta de Microsoft y sus contraseñas dejan de funcionar: consulte Cómo inician sesión los miembros.
- 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 Outlook. 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.
- Después, Probar la conexión.
Cuando un buzón se desconecta
- Caducó el secreto del cliente: en Entra, abra App registrations → el registro del cliente (por ejemplo,
draften – inicio de sesión) → Certificates & secrets → + New client secret y copie el Value. Guárdelo en la tarjeta Inicio de sesión con cuenta y conexión de buzones y haga clic en Volver a conectar Outlook en los buzones. - La persona se fue o su cuenta se bloqueó: Microsoft deja de emitir tokens y draften desconecta el buzón. Un buzón sin inicio de sesión propio conéctelo con el registro de la organización (más abajo).
- «El proveedor no emitió ningún token de actualización»: al cliente le falta el permiso
offline_access(paso 7). - «Inició sesión una cuenta distinta de la dirección del buzón»: al conectar, inicie sesión con la cuenta de ese mismo buzón; quien tenga varias cuentas de Microsoft en el navegador, que elija la correcta.
Registro de la organización: acceso sin inicio de sesión
El registro tiene permisos de aplicación: el asistente entra en el buzón sin que nadie inicie sesión. Sirve para buzones compartidos y para organizaciones que quieren administrar el acceso a los buzones de forma centralizada. No tiene nada que ver con el inicio de sesión en draften.
Necesita una cuenta con el rol administrador global o administrador de roles con privilegios: solo ellos conceden el consentimiento para los permisos de aplicación de Microsoft Graph. El registro en sí también lo puede crear un administrador de aplicaciones.
En Microsoft Entra
Trabaja en el Microsoft Entra admin center, https://entra.microsoft.com.
- Abra la lista de registros de aplicaciones: en el menú de la izquierda, Entra ID → App registrations (en la versión anterior del menú, Identity → Applications → App registrations). Directamente: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
- Arriba, haga clic en + New registration y rellene:
- Name: por ejemplo
draften – correo, - Supported account types: Accounts in this organizational directory only (… only - Single tenant),
- Redirect URI: déjelo vacío.
Haga clic en Register. Se abre la página de la nueva aplicación.
- Name: por ejemplo
- En la página Overview, copie el Application (client) ID y el Directory (tenant) ID (icono de copiar junto al valor).
- En el menú de la aplicación, a la izquierda, Certificates & secrets → pestaña Client secrets → + New client secret. Description, por ejemplo
draften; en Expires elija la validez (24 meses como máximo) y haga clic en Add. En la tabla, copie enseguida el valor de la columna Value: solo se muestra ahora; el Secret ID no lo necesita draften. Anote también la fecha de la columna Expires. - API permissions → + Add a permission → Microsoft Graph → Application permissions (no Delegated). Escriba en la búsqueda y marque
Mail.ReadWriteyMailboxSettings.ReadWritey, abajo, haga clic en Add permissions.MailboxSettings.ReadWritesolo sirve para el color de la categoría en Outlook; sin él, la categoría se añade sin color. Si quiere, añadaUser.Read.All: con él draften comprueba los alias del buzón; sin él, la prueba de la conexión indica en los alias que no puede comprobarlos. - En la misma página, haga clic en Grant admin consent for … y confirme con Yes. Todas las filas deben tener una marca verde en la columna Status.
En draften
- 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.
- Sistema: Microsoft 365 (Entra). Rellene Nombre, Directory (tenant) ID, Application (client) ID, Client secret (el valor del paso 4, no su ID) y El secreto caduca. Haga clic en Añadir registro. El secreto se guarda cifrado y no se vuelve a mostrar.
- Un registro no conecta nada por sí solo. 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. La selección solo la ve quien es a la vez propietario del buzón y propietario o administrador de la organización (el propietario de la organización es propietario de todos los buzones). El procedimiento completo con capturas lo muestra la guía «Añadir y conectar un buzón».
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 Microsoft 365.
Restringir a determinados buzones (opcional)
Un permiso de aplicación llega a todos los buzones del directorio; draften es quien vigila (un miembro no puede añadir un buzón; el asistente no envía ni elimina nada). Quien quiera además una barrera técnica restringe la aplicación a un grupo de seguridad con la política ApplicationAccessPolicy de Exchange Online. Necesita PowerShell y el rol de administrador de Exchange (o de administrador global).
Paso 1 — módulo de Exchange Online. Instálelo una sola vez: inicie PowerShell como administrador del equipo y escriba:
Install-Module ExchangeOnlineManagement
Paso 2 — grupo y política. Inicie sesión en Exchange Online, cree un grupo de seguridad con los buzones a los que draften puede acceder y una política que restrinja la aplicación solo a ese grupo. Sustituya <Application (client) ID> por el ID del registro del paso 3 de arriba y las direcciones, por las de sus buzones:
Connect-ExchangeOnline -UserPrincipalName admin@<tenant>.onmicrosoft.com
New-DistributionGroup -Name "draften - buzones permitidos" -Alias draften-buzones -Type Security -Members buzon@firma.cz
New-ApplicationAccessPolicy -AppId <Application (client) ID> -PolicyScopeGroupId draften-buzones@firma.cz -AccessRight RestrictAccess -Description "draften: solo buzones permitidos"
Paso 3 — comprobación. Para un buzón del grupo, el comando debe mostrar AccessCheckResult : Granted; para un buzón fuera del grupo, Denied:
Test-ApplicationAccessPolicy -Identity buzon@firma.cz -AppId <Application (client) ID>
Después, añada cada buzón nuevo al grupo en el Exchange admin center (https://admin.exchange.microsoft.com → Recipients → Groups) o con el comando Add-DistributionGroupMember -Identity draften-buzones@firma.cz -Member otro@firma.cz. Un buzón fuera del grupo falla en la prueba de la conexión con el error 403 (AppOnly AccessPolicy). La política suele aplicarse en menos de una hora; también hemos visto cuatro horas. Como alternativa más reciente, Microsoft ofrece RBAC for Applications en Exchange Online; por ahora no lo describimos.
Sustituir el secreto
El secreto tiene una validez limitada y draften no envía ningún aviso de su caducidad: la fecha de la tarjeta se vuelve amarilla 30 días antes y roja después. Póngase un recordatorio en el calendario. Antes de que caduque:
- En Entra, abra App registrations → su registro (por ejemplo,
draften – correo) → Certificates & secrets → + New client secret y copie el nuevo Value (como en el paso 4 de arriba). - En draften, en Organización › Inicio de sesión y acceso al correo, elija Nuevo secreto en el registro, pegue el nuevo valor y la nueva fecha.
- Elimine el secreto antiguo en Entra con el icono de la papelera de su fila.
Si el secreto caduca antes, los buzones se desconectan (invalid_client) y los asistentes los omiten. Después de sustituir el secreto, ejecute Probar la conexión en los buzones: una prueba superada vuelve a activar el buzón.
Errores de la prueba de la conexión
La prueba comprueba tres pasos: Acceso, Token y permiso y Lectura de la Bandeja de entrada. Cada uno muestra una marca o una cruz con el motivo:
| En el mensaje | Qué significa | Qué hacer |
|---|---|---|
AADSTS7000215, AADSTS7000222, invalid_client | client secret incorrecto o caducado | crear un secreto nuevo y guardarlo en draften |
AADSTS700016, AADSTS90002, unauthorized_client | Application ID o Directory ID incorrectos | volver a copiar ambos ID desde Overview |
AADSTS65001, AADSTS650057, consent_required | falta el consentimiento del administrador | Grant admin consent en la aplicación |
token sin Mail.ReadWrite | el permiso falta o no tiene consentimiento | añadir el permiso y conceder el consentimiento |
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008 | la conexión con la cuenta caducó o se revocó | Volver a conectar Outlook |
HTTP 403 AppOnly AccessPolicy | el buzón no está en el grupo de la política de acceso | añadirlo al grupo y esperar |
| HTTP 404 | ese buzón no existe | comprobar la dirección; el buzón debe tener Exchange Online |
| HTTP 401 | otro directorio, o falta un permiso | comprobar el Directory ID y los permisos |
Otros errores se describen en Solución de problemas.