Integracja 3CX z Office 365 poprzez Azure API

Wersje PBX 3CX v16 Pro i Enterprise oferują pełną integrację z aplikacjami Office 365. W szczególności zaimplementowano:

• Synchronizacja użytkowników Office 365 i rozszerzeń 3CX (użytkowników).
• Synchronizacja kontaktów osobistych użytkowników Office i osobistej książki adresowej 3CX.
• Synchronizacja statusów kalendarza użytkowników Office 365 (zajęty) i statusu numeru wewnętrznego 3CX.   

Aby wykonywać połączenia wychodzące z interfejsu internetowego aplikacji Office, 3CX korzysta z rozszerzenia 3CX Kliknij, aby zadzwonić dla przeglądarek Chrom и Firefox. Można także używać skrótów klawiaturowych w Aplikacja 3CX dla Windows.

Aby rozpocząć, będziesz potrzebować subskrypcji Office 3CX i poświadczeń administratora portalu Office z uprawnieniami „Administratora globalnego”.

Niektóre subskrypcje Office 365 mają ograniczoną integrację z 3CX lub nie mają jej wcale:

• Subskrypcje bez zarządzania użytkownikami, tj. wszystkie subskrypcje „domowe”.
• Subskrypcje bez Exchange nie umożliwiają synchronizacji kontaktów i kalendarza (Office 365 Business i Office 365 Pro Plus).

Serwery Office 365 muszą mieć bezpośrednie połączenie z Twoim serwerem 3CX, aby przesyłać statusy w czasie rzeczywistym. Jeśli trwałe połączenie nie jest możliwe, 3CX będzie nadal przeprowadzać codzienną synchronizację.

Należy pamiętać, że synchronizacja odbywa się tylko w jednym kierunku – z Office 365 do 3CX. Aby synchronizacja przebiegła pomyślnie, użytkownicy Office 365 muszą mieć atrybut „UserType” ustawiony na „Member” (ustawiony w Active Directory). Jeżeli użytkownik synchronizowany z Office 365 zostanie usunięty lub zmodyfikowany poprzez interfejs 3CX, przy kolejnej ręcznej lub automatycznej synchronizacji powróci do poprzedniego stanu.

Aplikacja uwierzytelniająca Microsoft Azure

Pierwszy krok połączenia Integracja z Office 365 — utworzenie na koncie indywidualnej aplikacji umożliwiającej autoryzację integracji.

1. W interfejsie zarządzania 3CX przejdź do Ustawienia - Office 365 - zakładka Ustawienia - sekcja Krok 3 i skopiuj adres URL przekierowania.
2. Zaloguj się do portalu Office 365 przy użyciu poświadczeń administratora globalnego i przejdź do Rejestracje aplikacji Microsoft Azure.
3. Kliknij opcję Nowa rejestracja i podaj nazwę aplikacji, na przykład 3CX PBX Office 365 Sync App.
4. W sekcji Obsługiwane typy kont pozostaw domyślną opcję Konta tylko w tym katalogu organizacji
5. W sekcji URI przekierowania (opcjonalnie) wybierz typ Web i wklej URI przekierowania z sekcji interfejsu 3CX: Ustawienia > Integracja z Office 365 > zakładka Ustawienia > Krok 3. Sekcja Platforma i uprawnienia, np.: firma.3cx.eu:5001/oauth2office2
6. Kliknij Zarejestruj, a aplikacja zostanie utworzona.
7. Zostanie otwarta strona ustawień utworzonej aplikacji. Skopiuj wartość Identyfikator aplikacji (klient) i wklej ją z odpowiedniego pola w interfejsie zarządzania 3CX, Ustawienia > Integracja z Office 365 > zakładka Opcje > Krok 1. Skonfiguruj identyfikator aplikacji.

Klucze uwierzytelniające

Teraz musisz ustanowić zaufanie klucza publicznego pomiędzy systemem 3CX v16 a utworzoną aplikacją w portalu Office 365.

1. W interfejsie 3CX (Ustawienia > Integracja z Office 365 > zakładka Opcje) kliknij Wygeneruj nową parę kluczy i zapisz klucz public_key.pem.
2. Przejdź do strony ustawień aplikacji w sekcji Certyfikaty i sekrety. Kliknij opcję Prześlij certyfikat i prześlij wygenerowany klucz.

Uprawnienia do aplikacji

Ostatnim krokiem konfiguracji jest ustawienie uprawnień API w sekcji Uprawnienia API. Te uprawnienia określają, w jaki sposób Twój system 3CX może uzyskać dostęp do Twojego konta Office 365.

1. Przejdź do Uprawnień API, kliknij Dodaj uprawnienia i wybierz Microsoft Graph.
2. Dodaj uprawnienia API w obszarze Uprawnienia aplikacji: Kalendarze > Kalendarze. Odczyt, Kontakty > Kontakty. Odczyt, Katalog > Katalog. Odczyt. Wszystko i kliknij Dodaj uprawnienia.
3. W sekcji Udziel zgody kliknij opcję Udziel zgody administratora dla..., aby włączyć uprawnienia.
4. Poczekaj około 10 minut, aż zmiany zaczną obowiązywać.
5. Przejdź do interfejsu 3CX i w sekcji Integracja z Office 365 kliknij Zaloguj się do Office 365. Potwierdź uprawnienia dla utworzonej aplikacji, a połączenie pomiędzy systemami zostanie nawiązane.

Możliwości synchronizacji

Synchronizację pomiędzy 3CX i Office 365 konfiguruje się w trzech zakładkach:

• Synchronizacja użytkowników - Użytkownicy Office 365 są synchronizowani z użytkownikami 3CX (rozszerzeniami). W interfejsie zarządzania 3CX zsynchronizowani użytkownicy są umieszczani w grupie organizacyjnej Azure AD.
• Synchronizacja kontaktów - kontakty osobiste Office 365 są synchronizowane z książką adresową 3CX. Użytkownik widzi te kontakty w aplikacjach 3CX na wszystkich platformach.
• Synchronizacja kalendarza - automatycznie zmienia status numeru wewnętrznego 3CX w zależności od tego czy jest on zajęty w kalendarzu Office 365:

Po zakończeniu wydarzenia w kalendarzu Office 365 synchronizowany jest także status użytkownika 3CX i przywracany do poprzedniego stanu.

Wszystkie elementy synchronizacji można skonfigurować zarówno dla wszystkich użytkowników Office 365, jak i wybranych użytkowników.

To kończy integrację.

Źródło: www.habr.com