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 retirará la API de servicios web de Exchange (EWS) para Exchange Online, con deshabilitación completa el 1 de octubre de 2026. La retirada se aplica solo a Exchange Online: Exchange Server local no se ve afectado.

Debes migrar todas las integraciones de Exchange Online que actualmente utilizan EWS a la API de Microsoft Graph para asegurarte de que siguen funcionando.

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

Después de cambiar las credenciales de una integración, la integración de Graph se reanuda desde el punto más antiguo al que haya llegado cualquier carpeta del buzón a través de EWS, y vuelve a comprobar los correos electrónicos a partir de ahí, omitiendo todo lo que ya esté sincronizado. Como resultado, nada se importa dos veces.

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.
   • Caduca: selecciona un período de vencimiento. La opción recomendada es 12 o 24 meses. Anota la fecha de caducidad en algún lugar donde la veas: cuando el secreto caduca, la ingestión del correo electrónico se detiene hasta que lo rotas.

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. Busca y selecciona 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)

Para mejorar la seguridad, tu administrador de Exchange puede limitar la aplicación para acceder solo a los buzones necesarios creando una política de acceso a la aplicación. Asegúrate de seguir la guía de Microsoft: Limitar los permisos de la aplicación a buzones de correo específicos de Exchange Online.

Antes de migrar una integración de producción, verifica que la política cubra todos los buzones de correo que planeas sincronizar. Un buzón fuera de la política se deshabilita con un error ErrorAccessDenied la primera vez que la sincronización intenta leerlo. Para obtener más detalles, consulta Solución de problemas de integraciones de Exchange.

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. En Conectar con tu aplicación, selecciona Graph API.
6. Selecciona Con acceso a la aplicación.
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. Espera a que se complete la primera sincronización.

Comprueba que los correos electrónicos se sincronizan correctamente y que no aparece ningún mensaje de error en la página de estado de la integración. El buzón comienza a sincronizarse en cuestión de minutos; ponerse al día tarda más tiempo cuando una gran cantidad de correo electrónico cae después de la marca de tiempo de inicio elegida. Si no ha llegado ningún correo electrónico después de una hora, consulta Solución de problemas de integraciones de Exchange.

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

Antes de modificar tu integración de producción, registra tus detalles de conexión EWS actuales y confirma que aún tienes una copia del secreto de cliente EWS, por ejemplo, en el almacén de secretos de tu organización. La plataforma no te muestra las credenciales guardadas, por lo que solo puedes volver a EWS si mantuviste el secreto en otro lugar.

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. En Conectar con tu aplicación, selecciona Graph API.

6. Selecciona Con acceso a la aplicación.

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. Selecciona Validar y guardar credenciales para verificar tu configuración.

   Nota:

   Si la validación falla, vuelve a comprobar tu ID de tenant, ID de cliente y secreto de cliente. Asegúrese de que se haya concedido el consentimiento del administrador para los permisos de la API. Ten en cuenta que la validación correcta solo confirma la autenticación: no comprueba el acceso a ningún buzón.

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

10. Supervisa la integración durante al menos una hora para confirmar el funcionamiento estable y la sincronización correcta del correo electrónico. Si la integración o un buzón muestra un error, consulta Solución de problemas de integraciones de Exchange.

Paso 6: Actualizar las integraciones restantes

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