Integrarea 3CX cu Office 365 prin Azure API

Edițiile PBX 3CX v16 Pro și Enterprise oferă o integrare completă cu aplicațiile Office 365. În special, sunt implementate următoarele:

• Sincronizarea utilizatorilor Office 365 și a extensiilor 3CX (utilizatori).
• Sincronizarea contactelor personale ale utilizatorilor Office și agenda personală 3CX.
• Sincronizarea stărilor din calendarul utilizatorului Office 365 (ocupat) și starea numărului de extensie 3CX.   

Pentru a efectua apeluri de pe interfața web a aplicațiilor Office, 3CX folosește extensia 3CX Click pentru a apela pentru browsere Chrome и Firefox. De asemenea, puteți utiliza comenzi rapide de la tastatură Aplicația 3CX pentru Windows.

Pentru a începe, veți avea nevoie de un abonament Office 3CX și acreditări de administrator al portalului Office cu privilegii „Administrator global”.

Unele abonamente Office 365 au o integrare limitată sau deloc cu 3CX:

• Abonamente fără gestionarea utilizatorilor, de ex. toate abonamentele „acasă”.
• Abonamentele fără Exchange nu pot sincroniza contactele și calendarul (Office 365 Business și Office 365 Pro Plus).

Serverele Office 365 trebuie să aibă o conexiune directă la serverul dumneavoastră 3CX pentru a transmite stări în timp real. Dacă o conexiune persistentă nu este posibilă, 3CX va efectua în continuare sincronizarea zilnică.

Vă rugăm să rețineți că sincronizarea se realizează într-o singură direcție - de la Office 365 la 3CX. Pentru o sincronizare reușită, utilizatorii Office 365 trebuie să aibă atributul „UserType” setat la „Member” (setat în Active Directory). Dacă un utilizator sincronizat din Office 365 este șters sau modificat prin interfața 3CX, acesta revine la starea anterioară în timpul următoarei sincronizări manuale sau automate.

Aplicație de autentificare Microsoft Azure

Primul pas de conectare Integrare Office 365 — crearea unei aplicații individuale în contul dvs. pentru a autoriza integrarea.

1. În interfața de management 3CX, accesați Setări - Office 365 - fila Setări - secțiunea Pasul 3 și copiați URL-ul de redirecționare.
2. Conectați-vă la portalul Office 365 cu acreditările de administrator global și accesați Înregistrări de aplicații Microsoft Azure.
3. Faceți clic pe Înregistrare nouă și specificați numele aplicației, de exemplu, 3CX PBX Office 365 Sync App.
4. În secțiunea Tipuri de conturi acceptate, lăsați opțiunea implicită Conturi numai în directorul acestei organizații
5. În secțiunea URI de redirecționare (opțional), selectați tipul Web și inserați URI-ul de redirecționare din secțiunea interfeței 3CX: Setări > Integrare Office 365 > fila Setări > Pasul 3. Secțiunea Platformă și permisiuni, de ex. firma.3cx.eu:5001/oauth2office2
6. Faceți clic pe Înregistrare și aplicația va fi creată.
7. Se deschide pagina de setări pentru aplicația creată. Copiați valoarea App ID (Client) și inserați-o din câmpul corespunzător din interfața de management 3CX, Setări > Integrare Office 365 > fila Opțiuni > Pasul 1. Configurați ID-ul aplicației.

Chei de autentificare

Acum trebuie să stabiliți o cheie publică de încredere între sistemul dumneavoastră 3CX v16 și aplicația creată în portalul Office 365.

1. În interfața 3CX (Setări > Integrare Office 365 > fila Opțiuni), faceți clic pe Generare o nouă pereche de chei și salvați cheia public_key.pem.
2. Accesați pagina de setări a aplicației din secțiunea Certificate și secrete. Faceți clic pe Încărcați certificat și încărcați cheia generată.

Permisiunile aplicației

Pasul final de configurare este să setați permisiunile API în secțiunea Permisiuni API. Aceste permisiuni determină modul în care sistemul dumneavoastră 3CX vă poate accesa contul Office 365.

1. Accesați Permisiuni API, faceți clic pe Adăugați permisiunea și selectați Microsoft Graph.
2. Adăugați permisiuni API sub Permisiuni aplicație: Calendare > Calendare.Citiți, Contacte > Contacte.Citiți, Director > Director.Citiți.Toate și faceți clic pe Adăugați permisiuni.
3. În secțiunea Acordați consimțământ, faceți clic pe Acordați consimțământul administratorului pentru... pentru a activa permisiunile.
4. Așteptați aproximativ 10 minute pentru ca modificările să intre în vigoare corect.
5. Comutați la interfața 3CX și în secțiunea Integrare cu Office 365, faceți clic pe Conectare la Office 365. Confirmați permisiunile pentru aplicația creată și se va stabili conexiunea între sisteme.

Capabilitati de sincronizare

Sincronizarea între 3CX și Office 365 este configurată în trei file:

• Sincronizarea utilizatorilor - utilizatorii Office 365 sunt sincronizați cu utilizatorii 3CX (extensii). În interfața de management 3CX, utilizatorii sincronizați sunt plasați în grupul de organizare Azure AD.
• Sincronizarea contactelor - Contactele personale Office 365 sunt sincronizate cu agenda 3CX. Utilizatorul vede aceste contacte în aplicațiile 3CX pentru toate platformele.
• Sincronizare calendar - schimbă automat starea unei extensii 3CX în funcție de ocuparea acesteia în calendarul Office 365:

După finalizarea unui eveniment din calendarul Office 365, starea utilizatorului 3CX este, de asemenea, sincronizată și revenită la starea anterioară.

Toate elementele de sincronizare pot fi configurate atât pentru toți utilizatorii Office 365, cât și pentru utilizatorii selectați.

Aceasta completează integrarea.

Sursa: www.habr.com