Configura tu canal de correo electrónico para OAuth con Microsoft Office 365

En este documento, se muestra cómo configurar un canal de correo electrónico de Contact Center AI Platform (CCAI Platform) para admitir Microsoft OAuth.

Requisitos previos

  1. Una cuenta de Azure con una suscripción activa. La cuenta debe tener acceso de administración de Microsoft Entra, por lo que debe configurarse como uno de los siguientes roles:

    • Administrador de aplicaciones
    • Desarrollador de aplicaciones
    • Administrador de aplicaciones de Cloud

  2. Un usuario de Microsoft Entra. Consulta la guía de inicio rápido de Microsoft para obtener instrucciones sobre cómo crear un usuario.

Asegúrate de que la cuenta de correo electrónico permita IMAP y SMTP

CCAI Platform usa IMAP y SMTP para enviar y recibir correos electrónicos de Microsoft. Debido a que una cuenta de Microsoft se puede conectar a diferentes programas, es importante asegurarse de que IMAP o SMTP no estén bloqueados por ningún otro programa secundario. En los siguientes pasos, se explican algunos lugares comunes para verificar en Microsoft.

  1. En el panel de navegación de la izquierda, ve a Usuarios > Usuarios activos.

  2. Selecciona un usuario para verificar.

  3. Haz clic en Correo. Si ves el mensaje "Este usuario no tiene una licencia de Exchange Online", debes otorgarle una licencia adecuada para usar Exchange. Sin una licencia adecuada, CCAI Platform no podrá enviar ni recibir correos electrónicos para esta cuenta de usuario.

  4. Después de agregar una licencia adecuada, selecciona Administrar apps de correo electrónico en la pestaña Correo. Asegúrate de que IMAP y SMTP autenticado estén marcados.

  5. Haz clic en Guardar.

  6. En el panel de navegación de la izquierda, ve a Casillas de correo.

  7. Selecciona la cuenta de usuario que deseas verificar.

  8. En la pestaña General, selecciona Administrar la configuración de las apps de correo electrónico. Asegúrate de que el botón de activación de IMAP esté habilitado.

Registrar una aplicación

  1. Accede al centro de administración de Microsoft Entra. Si tienes varios usuarios, usa el filtro Directorios + suscripciones para cambiar al usuario correcto.

  2. Ve a Identidad > Aplicaciones > Registros de apps > Nuevo registro.

  3. Ingresa un nombre visible identificable. Varios registros de apps pueden compartir el mismo nombre. El ID de cliente es lo que usa el programa para identificar la app. Sin embargo, debido a que los usuarios del programa pueden ver el nombre que creaste, podría acelerar el registro si le asignas un nombre único.

  4. Especifica el tipo de cuenta que puede usar la aplicación o el público de acceso. Se admiten varios tipos de cuentas:

    1. Solo cuentas en este directorio de la organización: Selecciona esta opción si compilas una aplicación para que la usen solo los usuarios (o invitados) en un solo usuario. A veces, se denomina aplicación de línea de negocios (LOB).

    2. Cuentas en cualquier directorio de la organización: Selecciona esta opción si quieres que los usuarios de cualquier usuario puedan usar esta aplicación. Esta opción es preferible para las configuraciones de varios usuarios.

    3. Cuentas en cualquier directorio de la organización y cuentas personales de Microsoft accounts: Selecciona esta opción si quieres que los usuarios de cualquier usuario puedan usar esta aplicación, así como los usuarios que tienen cuentas personales de Microsoft accounts.

    4. Cuentas personales de Microsoft: Selecciona esta opción si solo quieres crear una aplicación para los usuarios que tienen cuentas personales de Microsoft. Incluye cuentas de Microsoft, Skype, Xbox, Live y Hotmail.

  5. En URI de redireccionamiento, selecciona Web y, luego, ingresa https://{tenant}.ccaiplatform.com/v1/email_accounts/oauth_callback. Reemplaza {tenant}` por el nombre de tu usuario de CCAI Platform.

  6. Haz clic en Registrar para completar el registro inicial de la app.

  7. Una vez que se complete el registro, verás la pantalla Descripción general. Ten en cuenta la siguiente información, que necesitarás cuando completes el proceso en CCAI Platform:

    • ID de app (cliente)
    • ID de directorio (usuario)

Habilitar la aplicación

  1. Accede al centro de administración de Microsoft Entra.

  2. Ve a Identidad > Aplicaciones > Aplicaciones empresariales y selecciona la app.

  3. Ve a Propiedades.

  4. Activa ¿Visible para los usuarios? a Sí.

Agrega credenciales de la aplicación

Crea un secreto del cliente para usarlo en la plataforma CCAI Platform.

  1. Accede al centro de administración de Microsoft Entra.

  2. Ve a Identidad > Aplicaciones > Registros de apps y selecciona la app.

  3. Ve a Certificados y secretos > Secretos de cliente > Nuevo secreto de cliente. Se abrirá un panel para que le asignes un nombre al secreto.

  4. Agrega una descripción para el secreto del cliente.

  5. Selecciona una fecha de vencimiento para el secreto o especifica una duración personalizada. La duración del secreto de cliente se limita a dos años (24 meses) o menos. Sin embargo, Microsoft recomienda establecer un valor de vencimiento de menos de 12 meses.

  6. Haz clic en Agregar. Toma nota del valor del secreto. Lo necesitarás para completar el proceso en CCAI Platform.

Agrega permisos de API

La API de Graph permite que los tokens de acceso funcionen con IMAP, que es necesario para el funcionamiento del canal de correo electrónico de CCAI Platform.

  1. Accede al centro de administración de Microsoft Entra.

  2. Ve a Identidad > Aplicaciones > Registros de apps y selecciona la app.

  3. Selecciona Permisos de API > Agregar un permiso.

  4. Selecciona Microsoft Graph.

  5. Selecciona Permisos delegados. Usa la barra de búsqueda Seleccionar permisos para realizar las siguientes búsquedas y marcar las casillas junto a los resultados adecuados:

    • IMAP: Marca IMAP.AccessAsUser.All
    • offline: Marca offline_access
    • openid: Marca openid
    • smtp: SMTP.Send

  6. Haz clic en Add permissions.

Agrega credenciales a CCAI Platform

Una vez que se complete la configuración de Microsoft, usa la información del proceso de configuración para completar la conexión entre los dos programas en CCAI Platform. Ve a Configuración > Administración de cuentas de correo electrónico > SO de correo electrónico y, luego, ingresa la siguiente información:

Tipo de acceso: Déjalo en blanco.

URL de autorización: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize. {tenant_id} es el ID de directorio (usuario) de la app de Microsoft.

URL del token: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token. {tenant_id} es el ID de directorio (usuario) de la app de Microsoft.

ID de cliente: Es el ID de aplicación (cliente) de la app de Microsoft.

Secreto de cliente: Es el valor del secreto de cliente de la app de Microsoft.

Alcance: Ingresa los siguientes valores. No es necesario que estén separados por comas, pero deben estar presentes.

  • openid email offline_access
  • https://outlook.office.com/IMAP.AccessAsUser.All
  • https://outlook.office.com/SMTP.Send

Estado: Déjalo en blanco.

Tipo de acceso: Déjalo en blanco.

Tipo de otorgamiento: Código de autorización

Borra "Incluir el tipo de otorgamiento como parte de la URL de autorización y la URL del token".

Marca "Incluir la URL de redireccionamiento como parte de la URL de autorización y la URL del token".

Haz clic en Guardar.