Integrerea 3CX cu Office 365 prin Azure API

Sistemul 3CX v16 în edițiile Pro și Enterprise oferă o integrare completă cu aplicațiile Office 365. În special, sunt implementate:

• Sincronizarea utilizatorilor Office 365 și a numerelor de extensie (utilizatori) 3CX.
• Sincronizarea contactelor personale ale utilizatorilor Office și a agendei personale 3CX.
• Sincronizarea statutelor (ocupării) din calendarul utilizatorului Office 365 și a statutului numărului de extensie 3CX.   

Pentru a efectua apeluri externe din interfața web a aplicațiilor Office, 3CX utilizează extensia 3CX Click to Call pentru browsere Chrome și Firefox. De asemenea, pot fi folosite combinații de taste în aplicația 3CX pentru Windows.

Pentru a începe, aveți nevoie de un abonament Office 3CX și de acreditivele administratorului portalului Office cu privilegii de „Administrator Global”.

Unele abonamente Office 365 au capacități limitate de integrare cu 3CX sau nu au deloc:

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

Serverele Office 365 trebuie să aibă o conexiune directă la serverul dumneavoastră 3CX pentru a transmite statusuri în timp real. Dacă nu este posibil să asigurați o conexiune permanentă, 3CX va continua să efectueze sincronizări zilnice.

Rețineți că sincronizarea se realizează doar î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 valoarea „Member” (se stabilește în Active Directory). Dacă un utilizator sincronizat din Office 365 este șters sau modificat prin interfața 3CX, acesta revine la starea anterioară la următoarea sincronizare manuală sau automată.

Aplicația de autentificare Microsoft Azure

Primul pas pentru conectarea integrării Office 365 — este crearea unei aplicații personalizate în contul dumneavoastră pentru autorizarea integrării.

1. În interfața de gestionare 3CX, accesați secțiunea Opțiuni — Office 365 — fila Opțiuni — secțiunea Pasul 3 și copiați URL-ul de redirecționare.
2. Accesați portalul Office 365 cu acreditivele Global Administrator și mergeți la pagina Înregistrării aplicațiilor 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 doar în acest catalog al organizației
5. În secțiunea URI de redirecționare (opțional), specificați tipul Web și inserați URI-ul de redirecționare din secțiunea interfeței 3CX: Setări > Integrare cu Office 365 > fila Setări > secțiunea Pasul 3. Platformă și permisiuni, de exemplu, company.3cx.eu:5001/oauth2office2
6. Faceți clic pe Înregistrare, iar aplicația va fi creată.
7. Se va deschide pagina de setări a aplicației create. Copiați valoarea Identificator aplicație (client) și lipiți-o în câmpul corespunzător din interfața de gestionare 3CX, Setări > Integrare cu Office 365 > fila Setări > Pasul 1. Configurați App ID.

Chei de autentificare

Acum este necesar să stabiliți relații de încredere cu cheia publică între sistemul dvs. 3CX v16 și aplicația creată în portalul Office 365.

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

Permisiuni pentru aplicație

Ultimul pas de configurare este să stabiliți permisiunile API în secțiunea Permisiuni API. Aceste permisiuni definesc regulile de acces ale sistemului dvs. 3CX la contul Office 365.

1. Accesați secțiunea Permisiuni API, faceți clic pe Adăugați permisiune și selectați Microsoft Graph.
2. Adăugați permisiuni API în secțiunea Permisiuni aplicației: Calendar > Calendars.Read, Contacts > Contacts.Read, Directory > Directory.Read.All și faceți clic pe Adăugați Permisiuni.
3. În secțiunea Oferirea consimțământului, faceți clic pe Oferiți consimțământul administratorului pentru …, pentru a activa permisiunile.
4. Așteptați aproximativ 10 minute pentru ca modificările să se aplice 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 conexiunea între sisteme va fi stabilită.

Capabilități de sincronizare

Sincronizarea între 3CX și Office 365 se configurează în trei file:

• Sincronizarea utilizatorilor — utilizatorii Office 365 sunt sincronizați cu utilizatorii (numeri adiționali) 3CX. În interfața de gestionare 3CX, utilizatorii sincronizați sunt plasați în grupul organizațional Azure AD.
• Sincronizarea contactelor - contactele personale din Office 365 sunt sincronizate cu agenda 3CX. Utilizatorul vede aceste contacte în aplicațiile 3CX pentru toate platformele.
• Sincronizarea calendarului - modificarea automată a stării extensiei 3CX în funcție de disponibilitatea din calendarul Office 365:

După finalizarea evenimentului în calendarul Office 365, starea utilizatorului 3CX este de asemenea sincronizată și revine 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 încheie integrarea.

Sursa: habr.com