3CX integreerimine Office 365-ga Azure API kaudu

3CX versioon 16 Pro ja Enterprise pakub täielikku integreerimist Office 365 rakendustega. Eelkõige on teostatud:

• Office 365 kasutajate ja 3CX lisanumbrite (kasutajate) sünkroniseerimine.
• Kasutajate personaalkontaktide sünkroniseerimine Office'is ja 3CX isikliku aadressiraamatu sünkroniseerimine.
• Office 365 kasutaja kalendri hõivatusseisundi ja 3CX lisanumbri staatuse sünkroniseerimine.   

Väljakutseteks webi liidese kaudu Office'i rakendustest helistamiseks kasutab 3CX laiendust 3CX Click to Call brauserite jaoks Chrome ja Firefox. Samuti on võimalik kasutada klaviatuurikombinatsioone 3CX Windowsi rakenduses..

Alustamiseks vajate 3CX Office'i tellimust ja Office'i portaali administraatori mandaati, mille privileegid on 'Global Administrator'.

Mõned Office 365 tellimused on 3CX integreerimiseks piiratud võimekusega või ei paku üldse võimalust:

• Tellimused, kus ei ole kasutajate haldust, st kõik 'kodu' tellimused.
• Tellimused, millel puudub Exchange, ei saa kontakte ja kalendrit sünkroniseerida (Office 365 Business ja Office 365 Pro Plus).

Office 365 serverid peavad olema otseühenduses teie 3CX serveriga reaalajas staatuste edastamiseks. Kui püsiv ühendus ei ole võimalik, teeb 3CX siiski igapäeva sünkroniseerimist.

Pange tähele, et sünkroniseerimine toimub ainult ühes suunas — Office 365-st 3CX-ile. Edukaks sünkroniseerimiseks peavad Office 365 kasutajad omama atribuudiks 'UserType', mis on määratud väärtusele 'Member' (määratakse Active Directory-s). Kui Office 365-st sünkroniseeritud kasutaja kustutatakse või muudetakse 3CX liidese kaudu, taastatakse see eelnevale olekule järgmise käsitsi või automaatse sünkroniseerimise käigus.

Microsoft Azure autentimise rakendus

Esimene samm ühenduse loomisel Office 365 integreerimine — individuaalse rakenduse loomine teie kontol integreerimise autoriseerimiseks.

1. 3CX haldustarkvaras minge sektsiooni Seaded — Office 365 — vahekaart Seaded — jaotis Samm 3 ning kopeerige Redirect URL.
2. Logige sisse Office 365 portaali Global Administrator'i mandaadiga ja minge lehele Microsoft Azure rakenduste registreerimine.
3. Klõpsake Uus registreerimine ja sisestage rakenduse nimi, näiteks 3CX PBX Office 365 Sync App.
4. Kategooria Toetatud konto tüübid all jätke vaikevalikuks Ainult selle organisatsiooni katalooge.
5. Redirekti URI jaotises (valikuline) valige tüüp Veeb ja sisestage redirekti URI, mis on saadud 3CX liidese jaotisest: Seaded > Integreerimine Office 365 > Vahekaart Seaded > jaotis 3. Etapp. Platvorm ja õigused, näiteks, company.3cx.eu:5001/oauth2office2
6. Klõpsake Registreeri ja rakendus luuakse.
7. Avaneb loodud rakenduse seadete leht. Kopeerige rakenduse ID (kliendi) väärtus ja kleepige see vastavasse välja 3CX halduses, Seaded > Integreerimine Office 365 > Vahekaart Seaded > 1. etapp. Seadistage rakenduse ID.

Autentimise võtmed

Nüüd on vajalik luua usaldusühing avatud võtmega teie 3CX v16 süsteemi ja loodud rakenduse vahel Office 365 portaalis.

1. 3CX liideses (jaotis Seaded > Integreerimine Office 365 > Vahekaart Seaded) klõpsake Uue võtmepaari genereerimist ja salvestage võtme public_key.pem.
2. Minge rakenduse seadete lehele ja mine jaotisse Sertifikaadid ja salajased. Klõpsake Sertifikaadi saatmine ja laadige üles loodud võti.

Rakenduse õigused

Viimane seadistusetapp on API õiguste seadmine jaotises API õigused. Need õigused määravad, kuidas teie 3CX süsteem pääseb Office 365 kontole.

1. Mine jaotisse API õigused, klõpsake Lisa õigus ja valige Microsoft Graph.
2. Lisage rakenduse õigustes järgmised API õigused: Kalendrid > Kalendrid.Lugemine, Kontaktid > Kontaktid.Lugemine, Directory > Directory.Lugemine.Kõik ja klõpsake Lisa õigused.
3. Jaotises Üksuse nõusolek klõpsake Anna nõusolek administraatorile, et aktiveerida õigused.
4. Oodake umbes 10 minutit, et muudatused oleksid korralikult jõustunud.
5. Lülitage 3CX liidesesse ja jaotises Integreerimine Office 365 klõpsake Logi sisse Office 365. Kinnitage loodud rakenduse õigused ja süsteemide vaheline ühendus luuakse.

Sünkroonimisvõimalused

Sünkroonimine 3CX ja Office 365 vahel seadistatakse kolmes vaates:

• Kasutajate sünkroniseerimine — Office 365 kasutajad sünkroniseeritakse 3CX-kasutajatega (lisandnumbritega). 3CX halduses on sünkroniseeritavad kasutajad paigutatud Azure AD organisatsioonigruppi.
• Kontaktide sünkroniseerimine — Office 365 isiklikud kontaktid sünkroniseeritakse 3CX aadressiraamatusse. Kasutaja näeb neid kontaktid 3CX rakendustes kõikidel platvormidel.
• Kalendri sünkroniseerimine — 3CX lisandnumbrite staatuse automaatne muutmine sõltuvalt Office 365 kalendri hõivatusest:

Pärast Office 365 kalendris sündmuse lõppu sünkroniseeritakse ka 3CX kasutaja staatust ja naastes eelmisse olekusse.

Kõiki sünkroniseerimise elemente saab seadistada nii kõigi Office 365 kasutajate kui ka valitud kasutajate jaoks.

Sellel on integreerimise lõpp.

Allikas: habr.com