Integracija 3CX s Office 365 preko Azure API

3CX v16 Pro a Enterprise ponuja popolno integracijo z aplikacijami Office 365. Konkretno je bila implementirana:

• Sinhronizacija uporabnikov Office 365 in notranjih številk (uporabnikov) 3CX.
• Sinhronizacija osebnih stikov uporabnikov Office in osebnega imenika 3CX.
• Sinhronizacija statusov (zasedenosti) koledarja uporabnika Office 365 in statusa notranje številke 3CX.   

Za izvajanje odhodnih klicev iz spletnega vmesnika aplikacij Office, 3CX uporablja razširitev 3CX Click to Call za brskalnike Chrome in Firefox. Uporabite lahko tudi kombinacije tipk v aplikaciji 3CX za Windows..

Za začetek dela boste potrebovali naročnino na Office 3CX in skrbniške podatke portala Office s privilegiji „Global Administrator“.

Nekatere naročnine Office 365 imajo omejene možnosti integracije s 3CX ali jih sploh nimajo:

• Naročnine brez upravljanja uporabnikov, torej vse „domače“ naročnine.
• Naročnine brez Exchange ne morejo sinhronizirati stikov in koledarja (Office 365 Business in Office 365 Pro Plus).

Strežniki Office 365 morajo imeti neposredno povezavo z vašim strežnikom 3CX za prenos statusov v realnem času. Če trajna povezava ni mogoča, bo 3CX vseeno izvajal dnevno sinhronizacijo.

Upoštevajte, da se sinhronizacija izvaja le v eno smer — od Office 365 do 3CX. Za uspešno sinhronizacijo morajo imeti uporabniki Office 365 atribut „UserType“ nastavljen na vrednost „Member“ (nastavi se v Active Directory). Če se uporabnik, sinhroniziran iz Office 365, izbriše ali spremeni preko vmesnika 3CX, se pri naslednji ročni ali avtomatski sinhronizaciji vrne v prejšnje stanje.

Aplikacija za avtentikacijo Microsoft Azure

Prvi korak pri povezovanju integracije Office 365 je ustvarjanje individualne aplikacije v vašem računu za avtorizacijo integracije.

1. V upravljalskem vmesniku 3CX pojdite na razdelek Nastavitve — Office 365 — zavihek Nastavitve — razdelek Korak 3 in kopirajte Redirect URL.
2. Prijavite se v portal Office 365 s podatki Global Administrator in pojdite na stran Registracija aplikacij Microsoft Azure..
3. Kliknite Nova registracija in vnesite ime aplikacije, na primer, 3CX PBX Office 365 Sync App.
4. V razdelku Podprti tipi računov pustite privzeto možnost Računi samo v tem katalogu organizacije.
5. V razdelu za URI preusmeritve (neobvezno) navedite vrsto spleta in prilepite URI preusmeritve iz razdelka vmesnika 3CX: Možnosti > Integracija z Office 365 > zavihek Možnosti > razdelek Korak 3. Platforma in dovoljenja, na primer, company.3cx.eu:5001/oauth2office2
6. Kliknite Registriraj, in aplikacija bo ustvarjena.
7. Odprla se bo stran z možnostmi ustvarjene aplikacije. Kopirajte vrednost ID aplikacije (client) in jo prilepite v ustrezno polje v vmesniku za upravljanje 3CX, Možnosti > Integracija z Office 365 > zavihek Možnosti > Korak 1. Nastavite App ID.

Ključi za overjanje

Zdaj je treba vzpostaviti zaupanja vredne odnose z javnim ključem med vašim sistemom 3CX v16 in ustvarjeno aplikacijo v portalu Office 365.

1. V vmesniku 3CX (razdelek Možnosti > Integracija z Office 365 > zavihek Možnosti) kliknite Ustvari nov par ključev in shranite ključ public_key.pem.
2. Pojdite na stran z možnostmi aplikacije v razdelek Certifikati in skrivnosti. Kliknite Pošlji certifikat in naložite ustvarjeni ključ.

Dovoljenja za aplikacijo

Zadnja faza nastavitve je nastavitev dovoljenj API v razdelku Dovoljenja API. Ta dovoljenja določajo pravila dostopa vašega sistema 3CX do računa Office 365.

1. Pojdite v razdelek Dovoljenja API, kliknite Dodaj dovoljenje in izberite Microsoft Graph.
2. Dodajte dovoljenja API v razdelku Dovoljenja aplikacije: Koledarji > Calendars.Read, Kontakti > Contacts.Read, Skupina > Directory.Read.All in kliknite Dodaj Dovoljenja.
3. V razdelku Dodeljevanje soglasja kliknite Dodeli soglasje administratorja za ..., da omogočite dovoljenja.
4. Počakajte približno 10 minut, da se spremembe ustrezno uveljavijo.
5. Preklopite v vmesnik 3CX in v razdelku Integracija z Office 365 kliknite Vpiši se v Office 365. Potrdite dovoljenja za ustvarjeno aplikacijo in povezava med sistemi bo vzpostavljena.

Možnosti sinhronizacije

Sinhronizacija med 3CX in Office 365 se nastavlja v treh zavihkih:

• Sinhronizacija uporabnikov - uporabniki Office 365 se sinhronizirajo z uporabniki (dodatnimi številkami) 3CX. V vmesniku za upravljanje 3CX so sinhronizirani uporabniki nameščeni v organizacijski skupini Azure AD.
• Sinhronizacija stikov — osebni stiki Office 365 se sinhronizirajo s adresarjem 3CX. Uporabnik te stike vidi v aplikacijah 3CX za vse platforme.
• Sinhronizacija koledarja — samodejna sprememba statusa interne številke 3CX glede na zasedenost v koledarju Office 365:

Po končanem dogodku v koledarju Office 365 se status uporabnika 3CX prav tako sinhronizira in vrne v prejšnje stanje.

Vsi elementi sinhronizacije so lahko nastavljeni tako za vse uporabnike Office 365 kot za izbrane uporabnike.

Na tem je integracija zaključena.

Izvor: habr.com