Konfigurowanie Microsoft Teams Direct Routing

Wprowadzenie

System 3CX w edycji AI dla 16 jednoczesnych połączeń i wyższych oferuje integrację bezpośredniego routingu (Direct Routing) dla Teams. Umożliwia to użytkownikom aplikacji Teams wykonywanie połączeń do użytkowników systemu 3CX oraz odbieranie połączeń od nich.

Krok 1: Sprawdź wymagania

  • Twoja centrala PBX musi być skonfigurowana z certyfikatem SSL wydanym przez urząd certyfikacji zatwierdzony przez firmę Microsoft. Certyfikaty dla FQDN dostarczane przez 3CX są kompatybilne.
  • Skonfigurowana integracja z Microsoft 365.
  • Użytkownicy Microsoft 365 muszą mieć ustawiony numer „Telefon służbowy” (Office phone) w formacie E.164.
  • Domena (FQDN), która ma być używana dla serwera SBC aplikacji Teams, musi być zarejestrowana w panelu domen najemcy MS365.
  • Domena *.onmicrosoft.com nie jest obsługiwana jako domena nadrzędna dla serwera SBC; musisz użyć własnej domeny.
  • Port 5062 (lub 5061 w niektórych przypadkach) musi być otwarty na zaporze.
  • Użytkownikom MS365 musi zostać przypisany jeden z następujących poziomów licencji Microsoft:

Uwaga: Sprawdź w firmie Microsoft aktualne zasady licencjonowania Microsoft Teams. Różnią się one w zależności od regionu i szybko ulegają zmianom.

Krok 2: Skonfiguruj nazwę FQDN dla Teams

  1. Znajdź swoją domenę Teams, przechodząc do centrum administracyjnego Microsoft 365 > „Settings” (Ustawienia) > „Domains” (Domeny). (np. domena MS365: 3cx-example.com, nazwa FQDN dla Teams może brzmieć: teams.3cx-example.com)
  2. W systemie 3CX przejdź do „Admin” > „Integrations” (Integracje) > „Teams” i zaznacz opcję „Enable Microsoft Teams Direct Routing” (Włącz bezpośredni routing dla Microsoft Teams).
  3. Określ nazwę FQDN dla Teams, która odpowiada domenie e-mail w MS365.
  4. Przejdź do swojego dostawcy DNS i utwórz nowy rekord A wskazujący na statyczny publiczny adres IP Twojej instalacji 3CX.

Krok 3: Wygeneruj klucz CSR

Aby zintegrować system 3CX z 365/Teams, Microsoft wymaga certyfikatu SSL od jednego z zatwierdzonych przez Microsoft urzędów certyfikacji. Aby uzyskać certyfikat, należy najpierw wygenerować klucz CSR, na podstawie którego zostanie utworzony certyfikat SSL. Oto typowy proces:

  1. Pobierz program OpenSSL i zainstaluj go, jeśli to konieczne.
  2. Po zainstalowaniu uruchom nasz plik wsadowy CSR i wypełnij następujące dane:
  1. Nazwa FQDN 3CX (Teams) (np. teams.3cx-example.com)
  2. Jednostka organizacyjna (Organisation Unit, np. IT lub Operations)
  3. Kod kraju (Country Code, np. PL, UK, US)
  4. Województwo/Region (Area, np. Mazowieckie)
  5. Miasto (City, np. Warszawa)
  6. Nazwa firmy (Company name, np. Example Sp. z o.o.)
  1. Narzędzie wygeneruje klucz prywatny w folderze, z którego uruchomiono plik, zarówno w formacie notatnika, jak i w postaci pliku *.pem. Zachowaj ten plik *.pem, ponieważ zostanie on przesłany w polu „Private Key” (Klucz prywatny) w konsoli administracyjnej 3CX podczas Kroku 5 tego przewodnika.

Krok 4: Uzyskaj certyfikat SSL

Przejdź do wybranego dostawcy certyfikatów, aby uzyskać certyfikat, w tym wszystkie certyfikaty pośrednie oraz klucz prywatny z głównego urzędu certyfikacji. Musi on obejmować określoną nazwę FQDN dla Teams. W tym przykładzie wykorzystano serwis SSL.com:

Weryfikacja żądania certyfikatu (CSR) serwisu SSL.com

  1. Wybierz odpowiedni poziom certyfikatu; poziom Basic SSL będzie wystarczający > „Add to cart” (Dodaj do koszyka).
  2. Gdy pojawi się okno „Show order Transaction”, kliknij link „Click here to finish processing this certificate order” u góry ekranu.
  3. Otwórz plik notatnika wygenerowany przez narzędzie CSR i skopiuj jego zawartość do pola CSR.
  4. Upewnij się, że automatycznie uzupełnione pole nazwy potocznej (CN) zgadza się prawidłowo i kliknij „Next” (Dalej).
  5. W etapie „Domain Validation” (Weryfikacja domeny) wybierz opcje z rozwijanych list i wskaż metodę weryfikacji.

Weryfikacja certyfikatu SSL.com

  1. Przejdź do wiadomości e-mail z weryfikacją i kliknij zawarty w niej link.
  2. Wprowadź 20-znakowy kod weryfikacyjny i upewnij się, że pojawi się zielony pasek weryfikacji.

Potwierdzenie weryfikacji SSL.com

  1. Przejdź z powrotem do pulpitu nawigacyjnego SSL.com i wybierz zakładkę „Order” (Zamówienie) na górnym pasku nawigacyjnym.
  2. Znajdź swój certyfikat SSL i kliknij ikonę lupy, aby rozwinąć szczegóły.

Pobierz plik Nginx

  1. Kliknij „Download” (Pobierz) dla pliku Nginx. Możesz otrzymać powiadomienie na pasku zadań z pytaniem, czy chcesz kontynuować – kliknij „Keep” (Zachowaj). Znajdź plik i zmień jego rozszerzenie z .chained na .pem.

Uwaga: Niektórzy dostawcy nie dostarczają pojedynczego pliku zawierającego certyfikat wraz z certyfikatami pośrednimi. W takim przypadku opisaliśmy wymagane kroki w sekcji często zadawanych pytań (Teams FAQ).

Krok 5: Prześlij certyfikat SSL do systemu 3CX

Po utworzeniu i pobraniu certyfikatu SSL:

  1. Jeśli jeszcze tego nie zrobiono, kliknij prawym przyciskiem myszy plik certyfikatu i zmień jego rozszerzenie na typ *.pem.
  2. W sekcji „Step 2” w konsoli administracyjnej 3CX prześlij swój certyfikat oraz klucz prywatny wygenerowany za pomocą narzędzia do generowania CSR w Kroku 3 tego przewodnika.

Krok 6: Otwórz port 5062 na swojej zaporze

W przypadku, gdy Twoja nazwa FQDN dla Microsoft Teams nie jest taka sama jak nazwa FQDN systemu 3CX, musisz upewnić się, że port 5062 jest otwarty. Na przykład, jeśli posiadasz nazwę FQDN 3CX mojafirma.3cx.us oraz nazwę FQDN dla Teams teams.3cx-example.com, musisz otworzyć port 5062. Zapoznaj się z tą sekcją w sekcji często zadawanych pytań (Teams FAQ), jeśli posiadasz bardzo rygorystyczną politykę zapory sieciowej.

Krok 7: Skonfiguruj plan numeracji i uruchom skrypt

  1. Wygeneruj skrypt z poziomu konsoli administracyjnej 3CX.
  2. Wybierz swój kraj i kod kierunkowy w przypadkach, które mają zastosowanie. Wygenerowany skrypt zostanie dostosowany tak, aby formatować wybierane numery w scenariuszach takich jak połączenia wewnętrzne, krajowe i międzynarodowe.
  3. Kliknij „Generate Dial Plan” (Wygeneruj plan numeracji) i zapisz plik PowerShell w swoim systemie.
  4. Uruchom program Windows PowerShell jako Administrator i upewnij się, że zasady wykonywania są ustawione na Bypass, wprowadzając komendę:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

  1. Przejdź do folderu, w którym zapisano skrypt „teams_dial_plan.ps1”, i uruchom go.
  2. Możesz sprawdzić, czy konfiguracja została zastosowana i czy nie występują błędy, otwierając portal administracyjny Microsoft Teams.

Krok 8: Uruchom skrypty dla użytkowników

Ten krok należy wykonać za każdym razem, gdy tworzeni są nowi użytkownicy i przypisywana jest im licencja Systemu telefonicznego Teams (Teams Phone System).

  1. Użytkownicy wybrani w sekcji „User Sync” (Synchronizacja użytkowników), którzy spełniają wymagania (licencja, format numeru telefonu) oraz mają włączoną opcję w „Admin” > „Users” (Użytkownicy) > Twój użytkownik > „Options” (Opcje) > sekcja „M365” > „Enable MS Teams Integration” (Włącz integrację z MS Teams), zostaną uwzględnieni w wygenerowanym skrypcie.
  2. Kliknij „Generate Users Script” (Wygeneruj skrypt użytkowników) i zapisz plik PowerShell w swoim systemie.
  3. Przejrzyj skrypt pod kątem nieprawidłowych użytkowników, którzy mogli zostać zakomentowani. Dostosuj dane odpowiednio i powtórz powyższe kroki. W synchronizacji może wystąpić opóźnienie wynoszące do 24 godzin.
  4. Uruchom program Windows PowerShell jako Administrator i upewnij się, że zasady wykonywania są ustawione na Bypass, wprowadzając komendę:
    Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
  5. Przejdź do folderu, w którym zapisano skrypt „map_users.ps1”, i uruchom go.

Zobacz również


Ostatnia aktualizacja
Ten dokument był ostatnio aktualizowany 16 września 2026 r.
https://www.3cx.pl/docs/microsoft-teams/