Integrace 3CX s Office 365 přes Azure API

Edice PBX 3CX v16 Pro a Enterprise nabízí plnou integraci s aplikacemi Office 365. Konkrétně je implementováno následující:

• Synchronizace uživatelů Office 365 a rozšíření 3CX (uživatelů).
• Synchronizace osobních kontaktů uživatelů Office a osobního adresáře 3CX.
• Synchronizace stavů kalendáře uživatele Office 365 (zaneprázdněn) a stavu čísla pobočky 3CX.   

Pro odchozí hovory z webového rozhraní aplikací Office využívá 3CX rozšíření 3CX Click to Call pro prohlížeče chróm и Firefox. Můžete také použít klávesové zkratky v Aplikace 3CX pro Windows.

Chcete-li začít, budete potřebovat předplatné Office 3CX a přihlašovací údaje správce portálu Office s oprávněními „Globální správce“.

Některá předplatná Office 365 mají omezenou nebo žádnou integraci s 3CX:

• Předplatné bez správy uživatelů, tzn. všechna „domácí“ předplatná.
• Předplatná bez Exchange nemohou synchronizovat kontakty a kalendář (Office 365 Business a Office 365 Pro Plus).

Servery Office 365 musí mít přímé připojení k vašemu serveru 3CX, aby mohly přenášet stavy v reálném čase. Pokud trvalé připojení není možné, 3CX bude stále provádět denní synchronizaci.

Upozorňujeme, že synchronizace se provádí pouze jedním směrem - z Office 365 do 3CX. Pro úspěšnou synchronizaci musí mít uživatelé Office 365 atribut "UserType" nastaven na "Member" (nastavený ve službě Active Directory). Pokud je uživatel synchronizovaný z Office 365 odstraněn nebo upraven prostřednictvím rozhraní 3CX, vrátí se při další ruční nebo automatické synchronizaci do předchozího stavu.

Aplikace Microsoft Azure Authentication

První krok připojení Integrace Office 365 — vytvoření individuální aplikace ve vašem účtu pro autorizaci integrace.

1. V rozhraní pro správu 3CX přejděte do Nastavení - Office 365 - karta Nastavení - část Krok 3 a zkopírujte adresu URL přesměrování.
2. Přihlaste se k portálu Office 365 pomocí svých přihlašovacích údajů globálního správce a přejděte na Registrace aplikací Microsoft Azure.
3. Klikněte na Nová registrace a zadejte název aplikace, například 3CX PBX Office 365 Sync App.
4. V části Podporované typy účtů ponechte výchozí možnost Účty pouze v tomto adresáři organizace
5. V části Redirect URI (volitelné) vyberte typ Web a vložte URI přesměrování ze sekce rozhraní 3CX: Nastavení > Integrace Office 365 > karta Nastavení > Krok 3. Sekce Platforma a oprávnění, např. společnost.3cx.eu:5001/oauth2office2
6. Klikněte na Registrovat a aplikace se vytvoří.
7. Otevře se stránka nastavení vytvořené aplikace. Zkopírujte hodnotu App ID (Client) a vložte ji z příslušného pole v rozhraní pro správu 3CX, Nastavení > Integrace Office 365 > karta Možnosti > Krok 1. Nakonfigurujte ID aplikace.

Autentizační klíče

Nyní musíte vytvořit důvěryhodnost veřejného klíče mezi vaším systémem 3CX v16 a vytvořenou aplikací na portálu Office 365.

1. V rozhraní 3CX (Nastavení > Integrace Office 365 > karta Možnosti) klikněte na Generovat nový pár klíčů a uložte klíč public_key.pem.
2. Přejděte na stránku nastavení aplikace v části Certifikáty a tajemství. Klikněte na Nahrát certifikát a nahrajte vygenerovaný klíč.

Oprávnění aplikace

Posledním krokem nastavení je nastavení oprávnění API v sekci API Permissions. Tato oprávnění určují, jak může váš systém 3CX přistupovat k vašemu účtu Office 365.

1. Přejděte na API Permissions, klikněte na Add Permission a vyberte Microsoft Graph.
2. Přidejte oprávnění API v části Oprávnění aplikace: Kalendáře > Calendars.Read, Kontakty > Contacts.Read, Directory > Directory.Read.All a klikněte na Přidat oprávnění.
3. V části Udělit souhlas kliknutím na Udělit souhlas správce pro... povolte oprávnění.
4. Počkejte asi 10 minut, než se změny správně projeví.
5. Přepněte se do rozhraní 3CX a v sekci Integrace s Office 365 klikněte na Přihlásit se do Office 365. Potvrďte oprávnění pro vytvořenou aplikaci a dojde k navázání spojení mezi systémy.

Možnosti synchronizace

Synchronizace mezi 3CX a Office 365 se konfiguruje na třech kartách:

• Synchronizace uživatelů – uživatelé Office 365 jsou synchronizováni s uživateli 3CX (rozšířeními). V rozhraní pro správu 3CX jsou synchronizovaní uživatelé umístěni do organizační skupiny Azure AD.
• Synchronizace kontaktů – Osobní kontakty Office 365 jsou synchronizovány s adresářem 3CX. Tyto kontakty uživatel vidí v aplikacích 3CX pro všechny platformy.
• Synchronizace kalendáře – automaticky změní stav rozšíření 3CX podle toho, zda je zaneprázdněno v kalendáři Office 365:

Po dokončení události v kalendáři Office 365 se také synchronizuje stav uživatele 3CX a vrátí se do předchozího stavu.

Všechny prvky synchronizace lze nakonfigurovat jak pro všechny uživatele Office 365, tak pro vybrané uživatele.

Tím je integrace dokončena.

Zdroj: www.habr.com