Integració de 3CX amb Office 365 mitjançant l'API d'Azure

Les edicions PBX 3CX v16 Pro i Enterprise ofereixen una integració completa amb les aplicacions d'Office 365. En particular, s'implementa el següent:

• Sincronització d'usuaris d'Office 365 i extensions 3CX (usuaris).
• Sincronització de contactes personals dels usuaris d'Office i llibreta d'adreces personals de 3CX.
• Sincronització dels estats del calendari d'usuaris d'Office 365 (ocupat) i l'estat del número d'extensió 3CX.   

Per fer trucades sortints des de la interfície web de les aplicacions d'Office, 3CX utilitza l'extensió 3CX Feu clic per trucar per a navegadors Chrome и Firefox. També podeu utilitzar les dreceres del teclat Aplicació 3CX per a Windows.

Per començar, necessitareu una subscripció a Office 3CX i credencials d'administrador del portal d'Office amb privilegis d'"Administrador global".

Algunes subscripcions d'Office 365 tenen una integració limitada o nul·la amb 3CX:

• Subscripcions sense gestió d'usuaris, és a dir. totes les subscripcions "a casa".
• Les subscripcions sense Exchange no poden sincronitzar els contactes i el calendari (Office 365 Business i Office 365 Pro Plus).

Els servidors d'Office 365 han de tenir una connexió directa amb el vostre servidor 3CX per transmetre estats en temps real. Si no és possible una connexió persistent, 3CX encara realitzarà la sincronització diària.

Tingueu en compte que la sincronització només es realitza en una direcció: des de l'Office 365 fins al 3CX. Per a una sincronització correcta, els usuaris d'Office 365 han de tenir l'atribut "UserType" establert a "Membre" (establert a Active Directory). Si un usuari sincronitzat des de l'Office 365 s'elimina o es modifica mitjançant la interfície 3CX, torna a l'estat anterior durant la següent sincronització manual o automàtica.

Aplicació d'autenticació de Microsoft Azure

Primer pas de connexió Integració d'Office 365 — creació d'una aplicació individual al vostre compte per autoritzar la integració.

1. A la interfície de gestió del 3CX, aneu a Configuració - Office 365 - pestanya Configuració - secció Pas 3 i copieu l'URL de redirecció.
2. Inicieu la sessió al portal d'Office 365 amb les vostres credencials d'administrador global i aneu a Registres d'aplicacions de Microsoft Azure.
3. Feu clic a Registre nou i especifiqueu el nom de l'aplicació, per exemple, 3CX PBX Office 365 Sync App.
4. A la secció Tipus de compte compatibles, deixeu l'opció per defecte Comptes només al directori d'aquesta organització
5. A la secció URI de redirecció (opcional), seleccioneu el tipus Web i enganxeu l'URI de redirecció des de la secció de la interfície 3CX: Configuració > Integració d'Office 365 > pestanya Configuració > Pas 3. Secció de plataforma i permisos, p. company.3cx.eu:5001/oauth2office2
6. Feu clic a Registre i es crearà l'aplicació.
7. S'obre la pàgina de configuració de l'aplicació creada. Copieu el valor de l'identificador de l'aplicació (client) i enganxeu-lo des del camp adequat a la interfície de gestió del 3CX, Configuració > Integració d'Office 365 > pestanya Opcions > Pas 1. Configureu l'ID de l'aplicació.

Claus d'autenticació

Ara heu d'establir una confiança de clau pública entre el vostre sistema 3CX v16 i l'aplicació creada al portal de l'Office 365.

1. A la interfície 3CX (Configuració > Integració d'Office 365 > pestanya Opcions), feu clic a Genera un nou parell de claus i deseu la clau public_key.pem.
2. Aneu a la pàgina de configuració de l'aplicació a la secció Certificats i secrets. Feu clic a Carrega el certificat i carregueu la clau generada.

Permisos d'aplicació

El pas final de configuració és establir els permisos de l'API a la secció Permisos de l'API. Aquests permisos determinen com el vostre sistema 3CX pot accedir al vostre compte d'Office 365.

1. Aneu a Permisos de l'API, feu clic a Afegeix permís i seleccioneu Microsoft Graph.
2. Afegiu permisos de l'API a Permisos d'aplicació: Calendaris > Calendaris.Llegir, Contactes > Contactes.Llegir, Directori > Directori.Llegir.Tot i feu clic a Afegeix permisos.
3. A la secció Concediu el consentiment, feu clic a Concediu el consentiment de l'administrador per a... per activar els permisos.
4. Espereu uns 10 minuts perquè els canvis tinguin efecte correctament.
5. Canvieu a la interfície 3CX i, a la secció Integració amb Office 365, feu clic a Inicia sessió a Office 365. Confirmeu els permisos de l'aplicació creada i s'establirà la connexió entre els sistemes.

Capacitats de sincronització

La sincronització entre 3CX i Office 365 es configura en tres pestanyes:

• Sincronització d'usuaris: els usuaris d'Office 365 es sincronitzen amb els usuaris de 3CX (extensions). A la interfície de gestió de 3CX, els usuaris sincronitzats es col·loquen al grup d'organització d'Azure AD.
• Sincronització de contactes: els contactes personals de l'Office 365 es sincronitzen amb la llibreta d'adreces 3CX. L'usuari veu aquests contactes a les aplicacions 3CX per a totes les plataformes.
• Sincronització del calendari: canvia automàticament l'estat d'una extensió 3CX en funció de si està ocupada al calendari d'Office 365:

Després de completar un esdeveniment al calendari d'Office 365, l'estat d'usuari del 3CX també es sincronitza i es torna al seu estat anterior.

Tots els elements de sincronització es poden configurar tant per a tots els usuaris d'Office 365 com per als usuaris seleccionats.

Això completa la integració.

Font: www.habr.com