Integrácia 3CX s Office 365 cez Azure API

Edície PBX 3CX v16 Pro a Enterprise ponúkajú plnú integráciu s aplikáciami Office 365. Implementované je najmä:

• Synchronizácia používateľov Office 365 a rozšírení 3CX (používateľov).
• Synchronizácia osobných kontaktov používateľov Office a osobného adresára 3CX.
• Synchronizácia stavov kalendára používateľov Office 365 (zaneprázdnený) a stavu čísla rozšírenia 3CX.   

Na uskutočňovanie odchádzajúcich hovorov z webového rozhrania aplikácií Office využíva 3CX rozšírenie 3CX Click to Call pre prehliadače chróm и Firefox. Môžete tiež použiť klávesové skratky v Aplikácia 3CX pre Windows.

Ak chcete začať, budete potrebovať predplatné Office 3CX a poverenia správcu portálu Office s oprávneniami „globálneho správcu“.

Niektoré predplatné Office 365 majú obmedzenú alebo žiadnu integráciu s 3CX:

• Predplatné bez správy používateľov, t.j. všetky „domáce“ odbery.
• Predplatné bez výmeny nemôže synchronizovať kontakty a kalendár (Office 365 Business a Office 365 Pro Plus).

Servery Office 365 musia mať priame pripojenie k vášmu serveru 3CX, aby mohli odosielať stavy v reálnom čase. Ak trvalé pripojenie nie je možné, 3CX bude stále vykonávať dennú synchronizáciu.

Upozorňujeme, že synchronizácia sa vykonáva iba jedným smerom - z Office 365 na 3CX. Pre úspešnú synchronizáciu musia mať používatelia Office 365 atribút „UserType“ nastavený na „Member“ (nastavený v Active Directory). Ak sa používateľ synchronizovaný z Office 365 vymaže alebo upraví cez rozhranie 3CX, pri ďalšej manuálnej alebo automatickej synchronizácii sa vráti do predchádzajúceho stavu.

Aplikácia Microsoft Azure Authentication

Prvý krok pripojenia Integrácia Office 365 — vytvorenie individuálnej aplikácie vo vašom účte na autorizáciu integrácie.

1. V rozhraní správy 3CX prejdite do časti Nastavenia - Office 365 - karta Nastavenia - časť Krok 3 a skopírujte adresu URL presmerovania.
2. Prihláste sa na portál Office 365 pomocou svojich poverení globálneho správcu a prejdite na Registrácia aplikácií Microsoft Azure.
3. Kliknite na položku Nová registrácia a zadajte názov aplikácie, napríklad 3CX PBX Office 365 Sync App.
4. V časti Podporované typy účtov ponechajte predvolenú možnosť Účty iba v tomto adresári organizácie
5. V časti Redirect URI (voliteľné) vyberte typ Web a vložte URI presmerovania zo sekcie rozhrania 3CX: Nastavenia > Integrácia Office 365 > karta Nastavenia > Krok 3. Časť Platforma a povolenia, napr. spoločnosť.3cx.eu:5001/oauth2office2
6. Kliknite na Registrovať a aplikácia sa vytvorí.
7. Otvorí sa stránka nastavení vytvorenej aplikácie. Skopírujte hodnotu App ID (Client) a vložte ju z príslušného poľa v rozhraní správy 3CX, Nastavenia > Integrácia Office 365 > karta Možnosti > Krok 1. Nakonfigurujte ID aplikácie.

Autentifikačné kľúče

Teraz musíte vytvoriť dôveru verejného kľúča medzi vaším systémom 3CX v16 a vytvorenou aplikáciou na portáli Office 365.

1. V rozhraní 3CX (Nastavenia > Integrácia Office 365 > karta Možnosti) kliknite na položku Vygenerovať nový pár kľúčov a uložte kľúč public_key.pem.
2. Prejdite na stránku nastavení aplikácie v časti Certifikáty a tajomstvá. Kliknite na Nahrať certifikát a nahrajte vygenerovaný kľúč.

Povolenia aplikácie

Posledným krokom nastavenia je nastavenie povolení API v sekcii API Permissions. Tieto povolenia určujú, ako môže váš systém 3CX pristupovať k vášmu kontu Office 365.

1. Prejdite na položku Povolenia rozhrania API, kliknite na položku Pridať povolenie a vyberte položku Microsoft Graph.
2. Pridajte povolenia API v časti Povolenia aplikácie: Kalendáre > Kalendáre. Čítanie, Kontakty > Kontakty. Čítanie, Adresár > Adresár.Čítanie.Všetko a kliknite na Pridať povolenia.
3. V časti Udeliť súhlas kliknutím na Udeliť súhlas správcu pre... povoľte povolenia.
4. Počkajte asi 10 minút, kým sa zmeny správne prejavia.
5. Prepnite sa do rozhrania 3CX a v časti Integrácia s Office 365 kliknite na Prihlásiť sa do Office 365. Potvrďte oprávnenia pre vytvorenú aplikáciu a nadviaže sa spojenie medzi systémami.

Možnosti synchronizácie

Synchronizácia medzi 3CX a Office 365 sa konfiguruje na troch kartách:

• Synchronizácia používateľov – Používatelia Office 365 sú synchronizovaní s používateľmi 3CX (rozšíreniami). V rozhraní správy 3CX sú synchronizovaní používatelia umiestnení do organizačnej skupiny Azure AD.
• Synchronizácia kontaktov – Osobné kontakty Office 365 sú synchronizované s adresárom 3CX. Používateľ vidí tieto kontakty v aplikáciách 3CX pre všetky platformy.
• Synchronizácia kalendára – automaticky zmení stav rozšírenia 3CX podľa toho, či je v kalendári Office 365 zaneprázdnený:

Po dokončení udalosti v kalendári Office 365 sa zosynchronizuje aj stav používateľa 3CX a vráti sa do predchádzajúceho stavu.

Všetky prvky synchronizácie je možné nakonfigurovať pre všetkých používateľov Office 365 aj pre vybraných používateľov.

Tým je integrácia dokončená.

Zdroj: hab.com