Integración de 3CX con Office 365 a través de la API de Azure

La edición PBX 3CX v16 de Pro y Enterprise ofrece una integración completa con las aplicaciones de Office 365. En particular, implementado:

• Sincronice usuarios de Office 365 y extensiones 3CX (usuarios).
  
• Sincronice contactos personales entre usuarios de Office y su libreta personal de direcciones 3CX.
  
• Sincronice el estado del calendario del usuario de Office 365 (ocupado) y el estado de la extensión 3CX.
  

Para realizar llamadas salientes desde la interfaz web de la aplicación Office, 3CX utiliza la extensión 3CX Click to Call para los navegadores Chrome y Firefox . También puede usar métodos abreviados de teclado en la aplicación 3CX de Windows .

Para comenzar, necesitará una suscripción a Office 3CX y credenciales de administrador del portal de Office con privilegios de administrador global.

Algunas suscripciones de Office 365 tienen una integración limitada o nula de 3CX:

• Suscripciones sin gestión de usuarios, es decir Todas las suscripciones a domicilio.
  
• Las suscripciones sin Exchange no pueden sincronizar contactos y calendario (Office 365 Business y Office 365 Pro Plus).
  

Los servidores de Office 365 deben tener una conexión directa a su servidor 3CX para informes de estado en tiempo real. Si no es posible proporcionar una conexión permanente, 3CX seguirá realizando una sincronización diaria.

Tenga en cuenta que la sincronización es solo unidireccional: de Office 365 a 3CX. Para una sincronización exitosa, los usuarios de Office 365 deben tener el atributo "Tipo de usuario" establecido en "Miembro" (establecido en Active Directory). Si un usuario sincronizado desde Office 365 se elimina o modifica a través de la interfaz 3CX, volverá al estado anterior durante la siguiente sincronización manual o automática.

Aplicación de autenticación de Microsoft Azure

El primer paso para conectar la integración de Office 365 es crear una aplicación personalizada en su cuenta para autorizar la integración.

1. En la interfaz de administración de 3CX, vaya a Configuración - Office 365 - pestaña Configuración - sección Paso 3 y copie la URL de redireccionamiento.
   
2. Inicie sesión en el portal de Office 365 con credenciales de administrador global y vaya a la página de registro de aplicaciones de Microsoft Azure .
   
3. Haga clic en Nuevo registro e ingrese el nombre de la aplicación, por ejemplo, 3CX PBX Office 365 Sync App.
   
4. En la sección Tipos de cuenta admitidos, deje la opción predeterminada Cuentas solo en este directorio de la organización
   
5. En la sección URI de redireccionamiento (opcional), especifique el tipo de Web e inserte el URI de redireccionamiento desde la sección de la interfaz 3CX: Configuración> Integración de Office 365> pestaña Configuración> Paso sección 3. Plataforma y permisos, por ejemplo, company.3cx.eu : 5001 / oauth2office2
   
6. Haga clic en Registrarse y se creará la aplicación.
   
7. Se abre la página de configuración de la aplicación creada. Copie el valor del Identificador de aplicación (cliente) y péguelo en el campo correspondiente en la interfaz de administración de 3CX, Configuración> Integración con Office 365> pestaña Configuración> Paso 1. Configure la ID de la aplicación.
   

Claves de autenticación

Ahora debe establecer una relación de confianza de clave pública entre su sistema 3CX v16 y la aplicación que creó en el portal de Office 365.

1. En la interfaz 3CX (Configuración> Integración con Office 365> pestaña Configuración), haga clic en Generar un nuevo par de claves y guarde la clave public_key.pem.
   
2. Vaya a la página de configuración de la aplicación en la sección Certificados y secretos. Haga clic en Enviar certificado y cargue la clave generada.
   

Permisos de solicitud

El paso final de configuración es establecer los permisos de API en la sección Permisos de API. Estos permisos determinan cómo su sistema 3CX accede a su cuenta de Office 365.

1. Vaya a la sección Permisos API, haga clic en Agregar permiso y seleccione Microsoft Graph.
   
2. Agregue permisos de API en la sección Permisos de aplicación: Calendarios> Calendarios.Read, Contactos> Contactos.Read, Directorio> Directory.Read.All, y haga clic en Agregar permisos.
   
3. En la sección Otorgar consentimiento, haga clic en Otorgar consentimiento del administrador para ... para activar los permisos.
   
4. Espere unos 10 minutos para que los cambios surtan efecto correctamente.
   
5. Cambie a la interfaz 3CX y en la sección Integración con Office 365, haga clic en Iniciar sesión en Office 365. Confirme los permisos para la aplicación creada y se establecerá la conexión entre los sistemas.
   

Funciones de sincronización

La sincronización entre 3CX y Office 365 se configura en tres pestañas:

• Sincronización de usuarios: los usuarios de Office 365 se sincronizan con los usuarios de 3CX (números de extensión). En la interfaz de administración de 3CX, los usuarios sincronizados se alojan en un grupo organizativo de Azure AD.
  
• Sincronización de contactos: los contactos personales de Office 365 se sincronizan con su libreta de direcciones 3CX. El usuario ve estos contactos en aplicaciones 3CX para todas las plataformas.
  
• Sincronización de calendario: cambie automáticamente el estado de la extensión 3CX según su carga de trabajo en el calendario de Office 365:
  

Una vez que el evento se completa en el calendario de Office 365, el estado del usuario de 3CX también se sincroniza y vuelve a su estado anterior.

Todos los elementos de sincronización se pueden configurar para todos los usuarios de Office 365, así como para los usuarios seleccionados.



Esto completa la integración.