Połączenie usługi Azure Communications Gateway do Kontakt z operatorem lub usługi Teams Telefon Mobile

  • Artykuł

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 Teams Telefon Mobile.

W tym artykule opisano sposób konfigurowania usługi Azure Communications Gateway dla Kontakt z operatorem i aplikacji Teams Telefon Mobile. Po wykonaniu kroków opisanych w tym artykule możesz przygotować się do ruchu na żywo za pomocą Kontakt z operatorem, usługi Teams Telefon 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 usługi Kontakt z operatorem i/lub Teams Telefon Mobile. Jeśli wybrano innego partnera dołączania dla aplikacji Kontakt z operatorem lub Teams Telefon Mobile, musisz poprosić go o rozmieszczenie zmian w środowiskach Kontakt z operatorem i/lub Teams Telefon Mobile.

Wymagania wstępne

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

Musisz mieć dostęp do konta użytkownika z rolą Global Administracja istrator firmy Microsoft.

Należy przydzielić numery testowe "weryfikacja usługi". Te numery są używane przez programy Kontakt z operatorem i Teams Telefon Mobile na potrzeby 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 usługi Teams Telefon Mobile).

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 Telefon Mobile i nie wybrano jej podczas wdrażania usługi Azure Communications Gateway, wybierz:

  • Liczba używana w usłudze Teams Telefon Mobile w celu uzyskania dostępu do interakcyjnej odpowiedzi głosowej (IVR) poczty głosowej z natywnych numerów telefonicznych.

  • Metoda rozsyłania wywołań usługi Teams Telefon Mobile 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 obsługi aplikacji Kontakt z operatorem lub Teams Telefon Mobile

Uwaga

Jeśli wybrano Kontakt z operatorem lub Teams Telefon 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 Telefon Mobile (odpowiednio), aby otworzyć stronę usługi.
  4. Wybierz pozycję ustawienia Kontakt z operatorem lub ustawienia usługi Teams Telefon 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 Administracja do aplikacji Project Synergi) skonfigurowane jako operator w środowiskach Teams Telefon Mobile (TPM) i Kontakt z operatorem (OC). 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 Telefon Mobile wymagają, aby dzierżawa firmy Microsoft Entra zawierała aplikację firmy Microsoft o nazwie Project Synergi. Kontakt z operatorem i teams Telefon 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 teams Telefon 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 Administracja globalnej 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 Administracja do aplikacji Project Synergi

Użytkownik, który konfiguruje usługę Azure Communications Gateway, musi mieć rolę użytkownika Administracja 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ć im rolę Administracja.

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 teams Telefon Mobile.

Ważne

Udzielanie uprawnień ma dwie części: konfigurowanie tożsamości zarządzanej przypisanej przez system 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 Teams Telefon Mobile. Identyfikator aplikacji dodasz do środowiska Kontakt z operatorem lub Teams Telefon 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ę w witrynie Azure Portal jako globalny Administracja istrator 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-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 usługi Teams Telefon Mobile (TPM) i Kontakt z operatorem (OC). Pomiń ten krok, jeśli został już dołączony do modułu TPM lub OC.

Zanim zespół dołączania będzie mógł zakończyć dołączanie do Kontakt z operatorem i/lub teams Telefon Środowiska mobilne, 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 Teams Telefon Mobile. Ten proces wymaga skonfigurowania środowiska przy użyciu dwóch identyfikatorów aplikacji:

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 usługi Teams Telefon Mobile