Guía de migración: servicios web de Exchange (EWS) a la API de Microsoft Graph

Migra las integraciones de Exchange de los servicios web de Exchange (EWS) a la API de Microsoft Graph antes de la fecha límite de obsolescencia de octubre de 2026.

Información general

Microsoft is retiring the Exchange Web Services (EWS) API for Exchange Online, with full disablement on October 1, 2026. The retirement applies to Exchange Online only: on-premises Exchange Server is not affected.

You must migrate all Exchange Online integrations that currently use EWS to the Microsoft Graph API to make sure that these continue to function.

Mejores prácticas

• Trata las integraciones de producción con cuidado. El cambio de credenciales afecta directamente a una integración en vivo, y un cambio de credenciales no se puede deshacer dentro de la plataforma. Planifica cada cambio de producción deliberadamente en lugar de migrar todo a la vez.
• Prueba primero con una integración independiente. Crea una integración de prueba dedicada con las nuevas credenciales de Graph API antes de tocar cualquier integración de producción (consulta Paso 3: prueba tus credenciales de Graph API). Esto confirma que el registro de su aplicación, los permisos y el consentimiento del administrador son correctos sin arriesgar un buzón de producción.
• Programa los cambios fuera de las horas punta. Planifica cada cambio de producción para un momento en el que sea aceptable un intervalo, para limitar el impacto del intervalo de ingestión temporal que se produce después de cambiar las credenciales.

Requisitos previos

Antes de iniciar la migración, asegúrate de cumplir los siguientes requisitos:

• Acceso al portal de Azure: acceso administrativo al portal de Azure de tu organización.
• Permisos: la capacidad de registrar aplicaciones y otorgar consentimiento de administrador en Azure AD.
• Acceso a la integración: acceso administrativo a tus integraciones de Communications Mining.
• Información del buzón: lista de todos los buzones conectados actualmente a través de integraciones de EWS.

Proceso de migración

After you switch an integration's credentials, the Graph integration resumes from the earliest point that any folder in the mailbox had reached over EWS, and re-checks emails from there onward, skipping anything already synced. Nothing is imported twice as a result.

ADVERTENCIA:

Al cambiar las credenciales de una integración de producción a Graph, espera un intervalo temporal en la ingestión de correo electrónico antes de que la nueva integración se ponga al día. Este es un efecto secundario esperado de las diferencias entre las integraciones de EWS y Graph, no un error. Programa el cambio para fuera de las horas punta, cuando sea aceptable un intervalo en la ingestión.

Paso 1: Identifica tus integraciones de EWS actuales

1. Inicia sesión en Communications Mining a través de Extracción y Procesamiento Inteligentes (IXP) en Automation Cloud.
2. Ve a Configuración y luego a la pestaña Integraciones .
3. Documenta todas las integraciones de Exchange existentes, incluyendo:
   • Nombres de integración
   • Buzones conectados
   • Proyectos asociados

Paso 2: registrar una aplicación de Azure

Si aún no has creado una aplicación de Azure para acceder a Graph API, aplica los siguientes pasos:

2.1 Crear el registro de la aplicación

1. Inicia sesión en tu portal de Azure.

2. Ve a Registros de aplicaciones y selecciona Nuevo registro.

   

3. Configura la aplicación de la siguiente manera:

   • Nombre: utiliza un nombre descriptivo, por ejemplo, uipath-exchange-graph-integration.
   • Tipos de cuenta admitidos: selecciona Cuentas solo en este directorio organizativo (Tenant único).

4. Selecciona Registrar.

5. Anota los siguientes valores de la página de información general de la aplicación:

   • ID de la aplicación (cliente)
   • ID (de tenant) del Directorio

2.2 Crear un secreto de cliente

1. En tu aplicación, selecciona Certificados y secretos en el menú de la izquierda.

2. En Secretos de cliente, selecciona Nuevo secreto de cliente.

   

3. Esto abre el panel lateral Añadir un secreto de cliente . Configura el secreto:

   • Descripción: introduce una descripción significativa, por ejemplo, Exchange Graph Integration Secret.
   • Expires: Select an expiration period. The recommended option is 12 or 24 months. Note the expiry date somewhere you will see it: when the secret expires, email ingestion stops until you rotate it.

4. Selecciona Añadir.

5. Copia inmediatamente el valor secreto y guárdalo de forma segura.

   

Nota:

Azure muestra el valor del secreto solo una vez. Si lo pierde, debe crear un nuevo secreto.

2.3 Establecer permisos de API para Microsoft Graph

1. Selecciona Permisos de API en el menú de la izquierda.

2. Selecciona Añadir un permiso.

   

3. Selecciona Microsoft Graph en la pestaña API de Microsoft .

   

4. Selecciona Permisos de aplicación.

   

5. Expande Correo y selecciona Mail.Read.

   

6. Selecciona Añadir permisos.

7. Selecciona Añadir un permiso de nuevo y luego selecciona Microsoft Graph → Permisos de aplicación.

8. Search for and select MailboxFolder.Read.All.

   

9. Selecciona Añadir permisos.

10. Volviendo al menú de permisos de la API , selecciona Conceder consentimiento de administrador para [Your Organization].

11. Selecciona Sí en el cuadro de diálogo de confirmación.

    

Tus permisos configurados deben mostrar:

• Mail.Read (Aplicación): marca de verificación verde en Estado.
• MailboxFolder.Read.All (Aplicación): marca de verificación verde en Estado.

2.4 Restringir el acceso al buzón (recomendado)

For enhanced security, your Exchange administrator can limit the application to access only the required mailboxes by creating an application access policy. Make sure you follow the Microsoft guide: Limiting application permissions to specific Exchange Online mailboxes.

Before you migrate a production integration, verify that the policy covers every mailbox you plan to sync. A mailbox outside the policy is disabled with an ErrorAccessDenied error the first time the sync attempts to read it. For details, check Troubleshooting Exchange integrations.

Paso 3: prueba tus credenciales de Graph API

Antes de actualizar tus integraciones de producción, prueba primero las nuevas credenciales de Graph API en una integración de prueba independiente.

1. Ve a Communications Mining en Extracción y Procesamiento Inteligentes (IXP) en Automation Cloud.
2. Dirígete a la pestaña Configuración → Integraciones .
3. Selecciona Nueva integración.
4. Configura la integración de prueba:
   • Selecciona un proyecto de prueba.
   • Introduce un nombre de prueba claro, por ejemplo, Exchange Graph Test o [Production Name] - Test.
5. Under Connect with your application, select Graph API.
6. Select With application access.
7. Rellena las credenciales del paso 2:
   • Autoridad OAuth: https://login.microsoftonline.com/{tenant_id}
   • ID de cliente OAuth: tu ID de aplicación (cliente).
   • Secreto de cliente: tu valor de secreto de cliente.
8. Selecciona Validar y guardar credenciales.
9. Añade los buzones utilizados en tu integración de producción. Utilice una marca de tiempo de inicio reciente para limitar la cantidad de datos sincronizados inicialmente.
10. Selecciona Crear integración.
11. Wait for the first sync to complete.

Verify that emails are syncing successfully and that no error messages appear on the integration status page. The mailbox starts syncing within minutes; catching up takes longer when a large amount of email falls after the chosen start timestamp. If no emails have arrived after an hour, check Troubleshooting Exchange integrations.

Una vez confirmado, procede a actualizar tus integraciones de producción.

Paso 4: Haz una copia de seguridad de tu configuración actual de EWS

Before modifying your production integration, record your current EWS connection details, and confirm that you still hold a copy of the EWS client secret, for example in your organization's secret store. The platform does not display saved credentials back to you, so you can only revert to EWS if you kept the secret elsewhere.

Paso 5: actualiza tu integración de producción

Nota:

Si necesitas revertir, edita la integración y cambia las credenciales a tus detalles de EWS.

1. Ve a Communications Mining en Extracción y Procesamiento Inteligentes (IXP) en Automation Cloud.

2. Ve a Configuración y luego a la pestaña Integraciones .

3. Localiza la integración de producción que deseas migrar y abre su configuración.

4. Selecciona la pestaña Credenciales y luego selecciona Cambiar credenciales.

5. Under Connect with your application, select Graph API.

6. Select With application access.

7. Actualiza los siguientes campos:

   • Autoridad OAuth: https://login.microsoftonline.com/{tenant_id} : sustituye {tenant_id} por tu ID de Azure Directory (tenant).
   • ID de cliente OAuth: tu ID de aplicación (cliente).
   • Secreto de cliente: tu valor de secreto de cliente.

8. Select Validate & save credentials to verify your configuration.

   Nota:

   If validation fails, double-check your tenant ID, client ID, and client secret. Ensure admin consent was granted for the API permissions. Note that successful validation confirms authentication only: it does not check access to any mailbox.

9. Selecciona Guardar o Continuar para aplicar la configuración actualizada.

10. Monitor the integration for at least one hour to confirm stable operation and successful email sync. If the integration or a mailbox shows an error, check Troubleshooting Exchange integrations.

Paso 6: Actualizar las integraciones restantes

Repite los pasos 3 a 5 para cada integración de EWS restante en tu organización.