Łączenie usługi Azure Communications Gateway z aplikacją Kontakt z operatorem lub aplikacją Teams Phone Mobile

Po wdrożeniu usługi Azure Communications Gateway i połączeniu jej z siecią podstawową należy połączyć ją z usługą Telefon Microsoft System. Należy również dołączyć do środowisk Kontakt z operatorem lub aplikacji Teams Phone Mobile.

W tym artykule opisano sposób konfigurowania usługi Azure Communications Gateway dla Kontakt z operatorem i aplikacji Teams Phone Mobile. Po wykonaniu kroków opisanych w tym artykule możesz przygotować się do ruchu na żywo za pomocą Kontakt z operatorem, aplikacji Teams Phone Mobile i usługi Azure Communications Gateway.

Napiwek

W tym artykule założono, że twój zespół dołączania do usługi Azure Communications Gateway od firmy Microsoft również dołącza Cię do Kontakt z operatorem i/lub aplikacji Teams Phone Mobile. Jeśli wybrano innego partnera dołączania dla Kontakt z operatorem lub aplikacji Teams Phone Mobile, musisz poprosić go o rozmieszczenie zmian w środowiskach Kontakt z operatorem i/lub aplikacji Teams Phone Mobile.

Wymagania wstępne

Musisz wdrożyć usługę Azure Communications Gateway.

Musisz mieć dostęp do konta użytkownika z rolą administratora globalnego firmy Microsoft Entra.

Należy przydzielić numery testowe "weryfikacja usługi". Te numery są używane przez programy Kontakt z operatorem i Teams Phone Mobile do ciągłego testowania połączeń. Wdrożenia produkcyjne wymagają sześciu liczb dla każdej usługi. Wdrożenia laboratorium wymagają trzech liczb dla każdej usługi.

• Jeśli wybrano usługę, którą konfigurujesz w ramach wdrażania usługi Azure Communications Gateway, masz już przydzielone numery dla usługi.
• W przeciwnym razie wybierz numery telefonów (w formacie E.164 i w tym kod kraju) i nazwy, aby je zidentyfikować. Zalecamy nazwy formularzy OC1 i OC2 (dla Kontakt z operatorem) oraz TPM1 i TPM2 (dla telefonu mobilnego usługi Teams).

Należy również przydzielić co najmniej jedną liczbę testową dla każdej usługi na potrzeby testowania integracji.

Jeśli chcesz skonfigurować aplikację Teams Phone Mobile i nie wybrano jej podczas wdrażania usługi Azure Communications Gateway, wybierz:

• Numer używany w aplikacji Teams Phone Mobile w celu uzyskania dostępu do interakcyjnej odpowiedzi głosowej (IVR) poczty głosowej z natywnych numerów.

• Metoda rozsyłania połączeń telefonicznych w usłudze Teams Phone do systemu Telefon Microsoft. Wybierz spośród następujących:

  • Zintegrowana umowa MCP (MCP w usłudze Azure Communications Gateway).
  • Lokalna umowa MCP.
  • Inna metoda kierowania wywołań.

Włączanie Kontakt z operatorem lub pomocy technicznej aplikacji Teams Phone Mobile

Uwaga

W przypadku wybrania Kontakt z operatorem lub aplikacji Teams Phone Mobile podczas wdrażania usługi Azure Communications Gateway pomiń ten krok i przejdź do sekcji Dodawanie aplikacji Synergia projektu do dzierżawy platformy Azure.

1. Zaloguj się w witrynie Azure Portal.
2. Na pasku wyszukiwania w górnej części strony wyszukaj zasób usługi Communications Gateway i wybierz go.
3. Na pasku menu bocznego w obszarze Usługi komunikacyjne wybierz pozycję Kontakt z operatorem lub Teams Phone Mobile (odpowiednio), aby otworzyć stronę usługi.
4. Wybierz pozycję ustawienia Kontakt z operatorem lub ustawienia aplikacji Teams Phone Mobile.
5. Wypełnij pola, a następnie wybierz pozycję Przejrzyj i utwórz.
6. Wybierz stronę Przegląd zasobu.
7. Wybierz pozycję Dodaj wiersze testu i dodaj wiersze weryfikacji usługi wybrane w obszarze Wymagania wstępne. Ustaw wartość Cel testowania na Wartość Zautomatyzowana.

   Ważne

   Nie dodawaj liczb na potrzeby testowania integracji. Podczas przeprowadzania testowania integracji i przygotowania do ruchu na żywo skonfigurujesz numery na potrzeby testowania integracji.

8. Poczekaj na zaktualizowanie zasobu. Gdy zasób jest gotowy, pole Stan aprowizacji w przeglądzie zasobu zmieni się na "Complete". Zalecamy okresowe zaewidencjonowanie, aby sprawdzić, czy pole Stan aprowizacji ma wartość "Ukończono". Ten krok może potrwać do dwóch tygodni.

Dodawanie aplikacji Project Synergi do dzierżawy platformy Azure

Przed rozpoczęciem tego kroku sprawdź, czy pole Stan aprowizacji zasobu to "Complete" (Ukończono).

Uwaga

Ten krok i następny krok (Przypisz użytkownika administracyjnego do aplikacji Project Synergi) skonfigurowany jako operator w środowiskach aplikacji Teams Phone Mobile i Kontakt z operatorem. Jeśli już wykonano proces dołączania, przejdź do pozycji Znajdź identyfikator aplikacji dla zasobu usługi Azure Communication Gateway.

Programy Kontakt z operatorem i Teams Phone Mobile wymagają, aby dzierżawa firmy Microsoft Entra zawierała aplikację firmy Microsoft o nazwie Project Synergi. Kontakt z operatorem i Teams Phone Mobile dziedziczą uprawnienia i tożsamości z dzierżawy firmy Microsoft Entra za pośrednictwem aplikacji Project Synergi. Aplikacja Project Synergi umożliwia również konfigurację Kontakt z operatorem lub aplikacji Teams Phone Mobile oraz przypisywanie użytkowników i grup do określonych ról.

Aby dodać aplikację Project Synergi:

1. Sprawdź, czy moduł Microsoft Entra ID (AzureAD) jest zainstalowany w programie PowerShell. Zainstaluj go w razie potrzeby.
   1. Otwórz program PowerShell.
   2. Uruchom następujące polecenie i sprawdź, czy AzureAD dane wyjściowe są wyświetlane.

      Get-Module -ListAvailable
      

   3. Jeśli AzureAD dane wyjściowe nie są wyświetlane, zainstaluj moduł.
      1. Zamknij bieżące okno programu PowerShell.
      2. Otwórz program PowerShell jako administrator.
      3. Uruchom następujące polecenie.

         Install-Module AzureAD
         

      4. Zamknij okno administratora programu PowerShell.
2. Zaloguj się do witryny Azure Portal jako administrator globalny firmy Microsoft.
3. Wybierz Microsoft Entra ID.
4. Wybierz Właściwości.
5. Przewiń w dół do pola Identyfikator dzierżawy. Identyfikator dzierżawy znajduje się w polu . Zanotuj identyfikator dzierżawy.
6. Otwórz program PowerShell.
7. Uruchom następujące polecenie cmdlet, zastępując <TenantID> element identyfikatorem dzierżawy zanotowany w kroku 5.

   Connect-AzureAD -TenantId "<TenantID>"
   New-AzureADServicePrincipal -AppId eb63d611-525e-4a31-abd7-0cb33f679599 -DisplayName "Operator Connect"
   

Przypisywanie użytkownika administratora do aplikacji Project Synergi

Użytkownik, który konfiguruje usługę Azure Communications Gateway, musi mieć rolę użytkownika Administrator w aplikacji Project Synergi. Przypisz im tę rolę w witrynie Azure Portal.

1. W witrynie Azure Portal przejdź do pozycji Microsoft Entra ID , a następnie pozycję Aplikacje dla przedsiębiorstw przy użyciu menu po lewej stronie. Alternatywnie możesz wyszukać aplikacje dla przedsiębiorstw na pasku wyszukiwania. Znajduje się ona w podpozycji Usługi .
2. Ustaw filtr Typ aplikacji na Wszystkie aplikacje przy użyciu menu rozwijanego.
3. Wybierz Zastosuj.
4. Wyszukaj projekt Synergia przy użyciu paska wyszukiwania. Powinna zostać wyświetlona aplikacja.
5. Wybierz aplikację Project Synergi .
6. Wybierz pozycję Użytkownicy i grupy z menu po lewej stronie.
7. Wybierz pozycję Dodaj użytkownika/grupę.
8. Określ użytkownika, który powinien skonfigurować usługę Azure Communications Gateway i przyznać mu rolę administratora .

Uwaga

Nie należy zmieniać żadnej z następujących konfiguracji Kontakt z operatorem w dzierżawie (za pośrednictwem portalu konfiguracji Kontakt z operatorem lub za pośrednictwem interfejsów API Kontakt z operatorem).

• Wywoływanie profilów z sufiksem CommsGw w portalu konfiguracji lub NameSuffix w interfejsach API Kontakt z operatorem
• Magistrale z nazwami FQDN kończące się na .commsgw.azure.com

Zarządzamy tą konfiguracją. Edytowanie tej konfiguracji może spowodować problemy z usługą Azure Communications Gateway.

Znajdowanie identyfikatora aplikacji dla zasobu usługi Azure Communication Gateway

Każdy zasób usługi Azure Communications Gateway automatycznie odbiera tożsamość zarządzaną przypisaną przez system, której usługa Azure Communications Gateway używa do łączenia się z interfejsem API Kontakt z operatorem. Musisz znaleźć identyfikator aplikacji tożsamości zarządzanej, aby można było połączyć usługę Azure Communications Gateway z interfejsem API Kontakt z operatorem w temacie Konfigurowanie ról aplikacji dla usługi Azure Communications Gateway i Dodawanie identyfikatorów aplikacji dla usługi Azure Communications Gateway do Kontakt z operatorem.

1. Zaloguj się w witrynie Azure Portal.
2. Jeśli nie znasz jeszcze nazwy zasobu usługi Communications Gateway, wyszukaj pozycję Bramy komunikacji i zanotuj nazwę zasobu.
3. Wyszukaj nazwę zasobu komunikacji. Powinna zostać wyświetlona aplikacja dla przedsiębiorstw z tej wartości w podpozycji Microsoft Entra ID . Aby go znaleźć, może być konieczne wybranie pozycji Kontynuuj wyszukiwanie w identyfikatorze Entra firmy Microsoft.
4. Wybierz aplikację dla przedsiębiorstw.
5. Sprawdź, czy nazwa jest zgodna z nazwą zasobu usługi Communications Gateway.
6. Zanotuj identyfikator aplikacji.

Konfigurowanie ról aplikacji dla usługi Azure Communications Gateway

Usługa Azure Communications Gateway zawiera usługi, które muszą uzyskiwać dostęp do interfejsu API Kontakt z operatorem w Twoim imieniu. Aby włączyć ten dostęp, należy przyznać określone role aplikacji tożsamości zarządzanej przypisanej przez system dla usługi Azure Communications Gateway w ramach aplikacji Project Synergi Enterprise Application. Utworzono aplikację Project Synergi Enterprise w sekcji Dodawanie aplikacji Project Synergia do dzierżawy platformy Azure.

Ten krok należy wykonać raz dla każdego zasobu usługi Azure Communications Gateway, którego chcesz użyć do Kontakt z operatorem lub aplikacji Teams Phone Mobile.

Ważne

Przyznawanie uprawnień ma dwie części: konfigurowanie przypisanej przez system tożsamości zarządzanej dla usługi Azure Communications Gateway z odpowiednimi rolami (w tym kroku) i dodawanie identyfikatora aplikacji tożsamości zarządzanej do środowiska Kontakt z operatorem lub aplikacji Teams Phone Mobile. Identyfikator aplikacji zostanie dodany do środowiska Kontakt z operatorem lub aplikacji Teams Phone Mobile później w temacie Dodawanie identyfikatorów aplikacji dla usługi Azure Communications Gateway do Kontakt z operatorem.

Wykonaj następujące kroki w dzierżawie zawierającej aplikację Project Synergi.

1. Sprawdź, czy moduł Microsoft Graph (Microsoft.Graph) jest zainstalowany w programie PowerShell. Zainstaluj go w razie potrzeby.
   1. Otwórz program PowerShell.
   2. Uruchom następujące polecenie i sprawdź, czy Microsoft.Graph dane wyjściowe są wyświetlane.

      Get-Module -ListAvailable
      

   3. Jeśli Microsoft.Graph dane wyjściowe nie są wyświetlane, zainstaluj moduł.
      1. Zamknij bieżące okno programu PowerShell.
      2. Otwórz program PowerShell jako administrator.
      3. Uruchom następujące polecenie.

         Install-Module -Name Microsoft.Graph -Scope CurrentUser
         

      4. Zamknij okno administratora programu PowerShell.
2. Zaloguj się do witryny Azure Portal jako administrator globalny firmy Microsoft Entra.
3. Wybierz Microsoft Entra ID.
4. Wybierz Właściwości.
5. Przewiń w dół do pola Identyfikator dzierżawy. Identyfikator dzierżawy znajduje się w polu . Zanotuj identyfikator dzierżawy.
6. Otwórz program PowerShell.
7. Uruchom następujące polecenie cmdlet, zastępując <TenantID> element identyfikatorem dzierżawy zanotowany w kroku 5.

   Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All" -TenantId "<TenantID>"
   

   Jeśli zostanie wyświetlony monit o przyznanie uprawnień narzędzi wiersza polecenia programu Microsoft Graph, wybierz pozycję Akceptuj , aby udzielić uprawnień.
8. Uruchom następujące polecenie cmdlet, zastępując <CommunicationsGatewayName> ciąg nazwą zasobu usługi Azure Communications Gateway.

   $acgName = "<CommunicationsGatewayName>"
   

9. Uruchom następujące polecenia programu PowerShell. Te polecenia dodają następujące role dla usługi Azure Communications Gateway: TrunkManagement.Read, , partnerSettings.ReadTrunkManagement.Write, NumberManagement.ReadNumberManagement.Write, , , Data.Read. Data.Write

   # Get the Service Principal ID for Project Synergy (Operator Connect)
   $projectSynergyApplicationId = "eb63d611-525e-4a31-abd7-0cb33f679599"
   $projectSynergyEnterpriseApplication = Get-MgServicePrincipal -Filter "AppId eq '$projectSynergyApplicationId'" # "Application.Read.All"
   
   # Required Operator Connect - Project Synergy Roles
   $trunkManagementRead = "72129ccd-8886-42db-a63c-2647b61635c1"
   $trunkManagementWrite = "e907ba07-8ad0-40be-8d72-c18a0b3c156b"
   $partnerSettingsRead = "d6b0de4a-aab5-4261-be1b-0e1800746fb2"
   $numberManagementRead = "130ecbe2-d1e6-4bbd-9a8d-9a7a909b876e"
   $numberManagementWrite = "752b4e79-4b85-4e33-a6ef-5949f0d7d553"
   $dataRead = "eb63d611-525e-4a31-abd7-0cb33f679599"
   $dataWrite = "98d32f93-eaa7-4657-b443-090c23e69f27"
   $requiredRoles = $trunkManagementRead, $trunkManagementWrite, $partnerSettingsRead, $numberManagementRead, $numberManagementWrite, $dataRead, $dataWrite
   
   # Locate the Azure Communications Gateway resource by name
   $acgServicePrincipal = Get-MgServicePrincipal -Filter ("displayName eq '$acgName'")
   
   # Assign the required roles to the managed identity of the Azure Communications Gateway resource
   $currentAssignments = Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id
   foreach ($appRoleId in $requiredRoles) {
       $assigned = $currentAssignments | Where-Object { $_.AppRoleId -eq $AppRoleId }
       if (-not $assigned) {
           $params = @{
               principalId = $acgServicePrincipal.Id
               resourceId = $projectSynergyEnterpriseApplication.Id
               appRoleId = $appRoleId
           }
           New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id -BodyParameter $params
       }
   }
   
   # Check the assigned roles
   Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id
   

10. Aby zakończyć bieżącą sesję, odłącz się od programu Microsoft Graph.

    Disconnect-MgGraph
    

Podaj dodatkowe informacje zespołowi dołączania

Uwaga

Ten krok jest wymagany do skonfigurowania Cię jako operatora w środowiskach telefon komórkowy i Kontakt z operatorem aplikacji Teams. Pomiń ten krok, jeśli zakończono dołączanie.

Zanim zespół dołączania będzie mógł zakończyć dołączanie do środowisk Kontakt z operatorem i/lub Teams Phone Mobile, należy podać im dodatkowe informacje.

1. Poczekaj, aż zespół dołączania przekaże Ci formularz, aby zebrać dodatkowe informacje.
2. Wypełnij formularz i nadaj go zespołowi dołączania.
3. Poczekaj, aż zespół dołączania potwierdzi, że proces dołączania został ukończony.

Jeśli nie masz jeszcze zespołu dołączania, skontaktuj się z usługą azcog-enablement@microsoft.com, podając identyfikator subskrypcji platformy Azure i dane kontaktowe.

Testowanie dostępu do portalu Kontakt z operatorem

Ważne

Przed przetestowaniem dostępu do portalu Kontakt z operatorem zaczekaj na ukończenie procesu dołączania, aby upewnić się, że proces dołączania został ukończony.

Przejdź do strony głównej Kontakt z operatorem i sprawdź, czy możesz się zalogować.

Dodawanie identyfikatorów aplikacji dla usługi Azure Communications Gateway do Kontakt z operatorem

Musisz włączyć usługę Azure Communications Gateway w środowisku Kontakt z operatorem lub aplikacji Teams Phone Mobile. Ten proces wymaga skonfigurowania środowiska przy użyciu dwóch identyfikatorów aplikacji:

• Identyfikator aplikacji przypisanej przez system tożsamości zarządzanej znalezionej w polu Znajdź identyfikator aplikacji dla zasobu usługi Azure Communication Gateway. Ten identyfikator aplikacji umożliwia usłudze Azure Communications Gateway używanie ról skonfigurowanych w temacie Konfigurowanie ról aplikacji dla usługi Azure Communications Gateway.
• Standardowy identyfikator aplikacji dla automatycznie utworzonej aplikacji przedsiębiorstwa AzureCommunicationsGateway. Ten identyfikator jest zawsze 8502a0ec-c76d-412f-836c-398018e2312b.

Aby dodać identyfikatory aplikacji:

1. Zaloguj się do portalu Kontakt z operatorem.
2. Dodaj nowy identyfikator aplikacji dla identyfikatora aplikacji znalezionego dla tożsamości zarządzanej.
3. Dodaj drugi identyfikator aplikacji dla wartości 8502a0ec-c76d-412f-836c-398018e2312b.

Rejestrowanie nazwy domeny wdrożenia w usłudze Microsoft Entra

Usługa Microsoft Teams wysyła tylko ruch do domen, które potwierdzisz, że jesteś właścicielem. Wdrożenie usługi Azure Communications Gateway automatycznie odbiera automatycznie wygenerowaną w pełni kwalifikowaną nazwę domeny (FQDN). Musisz dodać tę nazwę domeny do dzierżawy firmy Microsoft Entra jako niestandardową nazwę domeny, udostępnić szczegóły zespołowi dołączania, a następnie zweryfikować nazwę domeny. Ten proces potwierdza, że jesteś właścicielem domeny.

1. Przejdź do obszaru Przegląd zasobu usługi Azure Communications Gateway i wybierz pozycję Właściwości. Znajdź pole o nazwie Domena. Ta nazwa to nazwa domeny wdrożenia.
2. Wykonaj następującą procedurę: Dodaj niestandardową nazwę domeny do identyfikatora Entra firmy Microsoft.
3. Udostępnij swoje informacje o rekordzie TXT DNS zespołowi dołączania. Poczekaj, aż zespół dołączania potwierdzi, że rekord TXT DNS został poprawnie skonfigurowany.
4. Wykonaj następującą procedurę: Zweryfikuj niestandardową nazwę domeny.

Następny krok

Przygotowanie do ruchu na żywo za pomocą Kontakt z operatorem i aplikacji Teams Phone Mobile