Koneksi Azure Communications Gateway ke Koneksi Operator atau Teams Telepon Mobile

Setelah Menyebarkan Azure Communications Gateway dan menyambungkannya ke jaringan inti, Anda perlu menyambungkannya ke Microsoft Telepon System. Anda juga perlu onboarding ke lingkungan Koneksi Operator atau Teams Telepon Mobile.

Artikel ini menjelaskan cara menyiapkan Azure Communications Gateway untuk Koneksi Operator dan Teams Telepon Mobile. Setelah menyelesaikan langkah-langkah dalam artikel ini, Anda dapat mempersiapkan lalu lintas langsung dengan Koneksi Operator, Teams Telepon Mobile, dan Azure Communications Gateway.

Tip

Artikel ini mengasumsikan bahwa tim onboarding Azure Communications Gateway Anda dari Microsoft juga menyetor Anda ke Koneksi Operator dan/atau Teams Telepon Mobile. Jika Anda telah memilih mitra onboarding yang berbeda untuk Koneksi Operator atau Teams Telepon Mobile, Anda perlu meminta mereka untuk mengatur perubahan pada lingkungan Koneksi Operator dan/atau Teams Telepon Mobile.

Prasyarat

Anda harus menyebarkan Azure Communications Gateway.

Anda harus memiliki akses ke akun pengguna dengan peran Administrator Global Microsoft Entra.

Anda harus mengalokasikan nomor uji "verifikasi layanan". Nomor-nomor ini digunakan oleh program Koneksi Operator dan Teams Telepon Mobile untuk pengujian panggilan berkelanjutan. Penyebaran produksi membutuhkan enam angka untuk setiap layanan. Penyebaran lab membutuhkan tiga angka untuk setiap layanan.

• Jika Anda memilih layanan yang Anda siapkan sebagai bagian dari penyebaran Azure Communications Gateway, Anda telah mengalokasikan nomor untuk layanan tersebut.
• Jika tidak, pilih nomor telepon sekarang (dalam format E.164 dan termasuk kode negara) dan nama untuk mengidentifikasinya. Kami merekomendasikan nama formulir OC1 dan OC2 (untuk Koneksi Operator) dan TPM1 dan TPM2 (untuk Teams Telepon Mobile).

Anda juga harus mengalokasikan setidaknya satu nomor pengujian untuk setiap layanan untuk pengujian integrasi.

Jika Anda ingin menyiapkan Teams Telepon Mobile dan Anda tidak memilihnya saat menyebarkan Azure Communications Gateway, pilih:

• Nomor yang digunakan dalam Teams Telepon Mobile untuk mengakses Voicemail Interactive Voice Response (IVR) dari dialer asli.

• Metode untuk merutekan panggilan Teams Telepon Mobile ke Microsoft Telepon System. Pilih dari:

  • MCP terintegrasi (MCP di Azure Communications Gateway).
  • MCP lokal.
  • Metode lain untuk merutekan panggilan.

Mengaktifkan dukungan Koneksi Operator atau Teams Telepon Mobile

Catatan

Jika Anda memilih Koneksi Operator atau Teams Telepon Mobile saat Anda menyebarkan Azure Communications Gateway, lewati langkah ini dan buka Menambahkan aplikasi Sinergi Proyek ke penyewa Azure Anda.

1. Masuk ke portal Azure.
2. Di bilah pencarian di bagian atas halaman, cari sumber daya Gateway Komunikasi Anda dan pilih.
3. Di bilah menu samping, di bawah Layanan komunikasi, pilih Koneksi Operator atau Teams Telepon Seluler (sesuai) untuk membuka halaman layanan.
4. Pilih pengaturan Koneksi Operator atau pengaturan Teams Telepon Mobile.
5. Isi bidang, lalu pilih Tinjau + buat dan Buat.
6. Pilih halaman Gambaran Umum untuk sumber daya Anda.
7. Pilih Tambahkan baris pengujian dan tambahkan baris verifikasi layanan yang Anda pilih di Prasyarat. Atur tujuan Pengujian ke Otomatis.

   Penting

   Jangan tambahkan angka untuk pengujian integrasi. Anda akan mengonfigurasi nomor untuk pengujian integrasi saat melakukan pengujian integrasi dan mempersiapkan lalu lintas langsung.

8. Tunggu hingga sumber daya Anda diperbarui. Saat sumber daya Anda siap, bidang Status Provisi pada gambaran umum sumber daya berubah menjadi "Selesai." Kami menyarankan agar Anda melakukan check-in secara berkala untuk melihat apakah bidang Status Provisi adalah "Selesai." Langkah ini mungkin memakan waktu hingga dua minggu.

Menambahkan aplikasi Project Synergy ke penyewa Azure Anda

Sebelum memulai langkah ini, periksa apakah bidang Status Provisi untuk sumber daya Anda adalah "Selesai".

Catatan

Langkah ini dan langkah berikutnya (Tetapkan pengguna Admin ke aplikasi Sinergi Proyek) menyiapkan Anda sebagai Operator di lingkungan Teams Telepon Mobile (TPM) dan Koneksi Operator (OC). Jika Anda sudah melalui onboarding, buka Menemukan ID Aplikasi untuk sumber daya Azure Communication Gateway Anda.

Program Koneksi Operator dan Teams Telepon Mobile mengharuskan penyewa Microsoft Entra Anda berisi aplikasi Microsoft yang disebut Sinergi Proyek. Koneksi Operator dan Teams Telepon Mobile mewarisi izin dan identitas dari penyewa Microsoft Entra Anda melalui aplikasi Sinergi Proyek. Aplikasi Sinergi Proyek juga memungkinkan konfigurasi Koneksi Operator atau Teams Telepon Mobile dan menetapkan pengguna dan grup ke peran tertentu.

Untuk menambahkan aplikasi Project Synergy:

1. Periksa apakah modul MICROSOFT Entra ID (AzureAD) diinstal di PowerShell. Instal jika perlu.
   1. Buka PowerShell.
   2. Jalankan perintah berikut dan periksa apakah AzureAD muncul dalam output.

      Get-Module -ListAvailable
      

   3. Jika AzureAD tidak muncul di output, instal modul.
      1. Tutup jendela PowerShell Anda saat ini.
      2. Buka PowerShell sebagai admin.
      3. Jalankan perintah berikut.

         Install-Module AzureAD
         

      4. Tutup jendela admin PowerShell Anda.
2. Masuk ke portal Azure sebagai Admin Global Microsoft Entra.
3. Pilih Microsoft Entra ID.
4. Pilih Properti.
5. Gulir ke bawah ke bidang ID Penyewa. ID penyewa Anda ada di dalam kotak. Catat ID penyewa Anda.
6. Buka PowerShell.
7. Jalankan cmdlet berikut, ganti <TenantID> dengan ID penyewa yang Anda catat di langkah 5.

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

Menetapkan pengguna Admin ke aplikasi Sinergi Proyek

Pengguna yang menyiapkan Azure Communications Gateway harus memiliki peran pengguna Admin dalam aplikasi Sinergi Proyek. Tetapkan peran ini kepada mereka di portal Azure.

1. Di portal Azure, buka MICROSOFT Entra ID lalu aplikasi Enterprise menggunakan menu sisi kiri. Atau, Anda dapat mencari aplikasi Enterprise di bilah pencarian; aplikasi tersebut berada di bawah subjudul Layanan .
2. Atur filter Jenis aplikasi ke Semua aplikasi menggunakan menu drop-down.
3. Pilih Terapkan.
4. Cari Sinergi Proyek menggunakan bilah pencarian. Aplikasi akan muncul.
5. Pilih aplikasi Sinergi Proyek Anda.
6. Pilih Pengguna dan grup dari menu sisi kiri.
7. Pilih Tambahkan pengguna/grup.
8. Tentukan pengguna yang harus menyiapkan Azure Communications Gateway dan memberi mereka peran Admin .

Perhatian

Jangan mengubah salah satu konfigurasi Koneksi Operator berikut di penyewa Anda (baik melalui portal konfigurasi Koneksi Operator atau melalui API Koneksi Operator).

• Profil Panggilan dengan CommsGwAkhiran di portal konfigurasi atau NameSuffix pada API Koneksi Operator
• Batang dengan FQDN berakhir dengan .commsgw.azure.com

Kami mengelola konfigurasi ini untuk Anda. Mengedit konfigurasi ini kemungkinan akan menyebabkan masalah dengan layanan Azure Communications Gateway Anda.

Menemukan ID Aplikasi untuk sumber daya Azure Communication Gateway Anda

Setiap sumber daya Azure Communications Gateway secara otomatis menerima identitas terkelola yang ditetapkan sistem, yang digunakan Azure Communications Gateway untuk menyambungkan ke API Koneksi Operator. Anda perlu menemukan ID Aplikasi identitas terkelola, sehingga Anda dapat menyambungkan Azure Communications Gateway ke API Koneksi Operator dalam Menyiapkan peran aplikasi untuk Azure Communications Gateway dan Menambahkan ID Aplikasi untuk Azure Communications Gateway ke Koneksi Operator.

1. Masuk ke portal Azure.
2. Jika Anda belum mengetahui nama sumber daya Gateway Komunikasi Anda, cari Gateway Komunikasi dan catat nama sumber daya.
3. Cari nama Sumber Daya Komunikasi Anda. Anda akan melihat aplikasi perusahaan dengan nilai tersebut di bawah subjudul ID Microsoft Entra. Anda mungkin perlu memilih Lanjutkan pencarian di MICROSOFT Entra ID untuk menemukannya.
4. Pilih aplikasi perusahaan.
5. Periksa apakah Nama cocok dengan nama sumber daya Gateway Komunikasi Anda.
6. Catat ID Aplikasi.

Menyiapkan peran aplikasi untuk Azure Communications Gateway

Azure Communications Gateway berisi layanan yang perlu mengakses API Koneksi Operator atas nama Anda. Untuk mengaktifkan akses ini, Anda harus memberikan peran aplikasi tertentu ke identitas terkelola yang ditetapkan sistem untuk Azure Communications Gateway di bawah Aplikasi Project Synergy Enterprise. Anda membuat Aplikasi Project Synergy Enterprise di Menambahkan aplikasi Sinergi Proyek ke penyewa Azure Anda.

Anda harus melakukan langkah ini sekali untuk setiap sumber daya Azure Communications Gateway yang ingin Anda gunakan untuk Koneksi Operator atau Teams Telepon Mobile.

Penting

Memberikan izin memiliki dua bagian: mengonfigurasi identitas terkelola yang ditetapkan sistem untuk Azure Communications Gateway dengan peran yang sesuai (langkah ini) dan menambahkan ID aplikasi identitas terkelola ke lingkungan Koneksi Operator atau Teams Telepon Mobile. Anda akan menambahkan ID aplikasi ke lingkungan Koneksi Operator atau Teams Telepon Mobile nanti, di Menambahkan ID Aplikasi untuk Azure Communications Gateway ke Koneksi Operator.

Lakukan langkah-langkah berikut di penyewa yang berisi aplikasi Sinergi Proyek Anda.

1. Periksa apakah modul Microsoft Graph (Microsoft.Graph) diinstal di PowerShell. Instal jika perlu.
   1. Buka PowerShell.
   2. Jalankan perintah berikut dan periksa apakah Microsoft.Graph muncul dalam output.

      Get-Module -ListAvailable
      

   3. Jika Microsoft.Graph tidak muncul di output, instal modul.
      1. Tutup jendela PowerShell Anda saat ini.
      2. Buka PowerShell sebagai admin.
      3. Jalankan perintah berikut.

         Install-Module -Name Microsoft.Graph -Scope CurrentUser
         

      4. Tutup jendela admin PowerShell Anda.
2. Masuk ke portal Azure sebagai Administrator Global Microsoft Entra.
3. Pilih Microsoft Entra ID.
4. Pilih Properti.
5. Gulir ke bawah ke bidang ID Penyewa. ID penyewa Anda ada di dalam kotak. Catat ID penyewa Anda.
6. Buka PowerShell.
7. Jalankan cmdlet berikut, ganti <TenantID> dengan ID penyewa yang Anda catat di langkah 5.

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

   Jika Anda diminta untuk memberikan izin untuk Alat Baris Perintah Microsoft Graph, pilih Terima untuk memberikan izin.
8. Jalankan cmdlet berikut, ganti <CommunicationsGatewayName> dengan nama sumber daya Azure Communications Gateway Anda.

   $acgName = "<CommunicationsGatewayName>"
   

9. Jalankan perintah PowerShell berikut ini. Perintah ini menambahkan peran berikut untuk Azure Communications Gateway: TrunkManagement.Read, , TrunkManagement.Write, partnerSettings.ReadNumberManagement.Read, NumberManagement.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. Untuk mengakhiri sesi Anda saat ini, putuskan sambungan dari Microsoft Graph.

    Disconnect-MgGraph
    

Berikan informasi tambahan kepada tim orientasi Anda

Catatan

Langkah ini diperlukan untuk menyiapkan Anda sebagai Operator di lingkungan Teams Telepon Mobile (TPM) dan Koneksi Operator (OC). Lewati langkah ini jika Anda telah melakukan onboarding ke TPM atau OC.

Sebelum tim onboarding Anda dapat menyelesaikan onboarding Anda ke lingkungan Koneksi Operator dan/atau Teams Telepon Mobile, Anda perlu memberi mereka beberapa informasi tambahan.

1. Tunggu tim orientasi Anda memberi Anda formulir untuk mengumpulkan informasi tambahan.
2. Lengkapi formulir dan berikan kepada tim orientasi Anda.
3. Tunggu tim orientasi Anda mengonfirmasi bahwa proses onboarding selesai.

Jika Anda belum memiliki tim orientasi, hubungi azcog-enablement@microsoft.com, berikan ID langganan Azure dan detail kontak Anda.

Menguji akses portal Koneksi Operator Anda

Penting

Sebelum menguji akses portal Koneksi Operator Anda, tunggu tim orientasi Anda untuk mengonfirmasi bahwa proses onboarding selesai.

Buka beranda Koneksi Operator dan periksa apakah Anda dapat masuk.

Menambahkan ID Aplikasi untuk Azure Communications Gateway ke Koneksi Operator

Anda harus mengaktifkan Azure Communications Gateway dalam lingkungan Koneksi Operator atau Teams Telepon Mobile. Proses ini memerlukan konfigurasi lingkungan Anda dengan dua ID Aplikasi:

• ID Aplikasi dari identitas terkelola yang ditetapkan sistem yang Anda temukan di Temukan ID Aplikasi untuk sumber daya Azure Communication Gateway Anda. ID Aplikasi ini memungkinkan Azure Communications Gateway menggunakan peran yang Anda siapkan di Menyiapkan peran aplikasi untuk Azure Communications Gateway.
• ID Aplikasi standar untuk aplikasi perusahaan AzureCommunicationsGateway yang dibuat secara otomatis. ID ini selalu 8502a0ec-c76d-412f-836c-398018e2312b.

Untuk menambahkan ID Aplikasi:

1. Masuk ke portal Koneksi Operator.
2. Tambahkan Id Aplikasi baru untuk ID Aplikasi yang Anda temukan untuk identitas terkelola.
3. Tambahkan Id Aplikasi kedua untuk nilai 8502a0ec-c76d-412f-836c-398018e2312b.

Mendaftarkan nama domain penyebaran Anda di Microsoft Entra

Microsoft Teams hanya mengirim lalu lintas ke domain yang Anda konfirmasikan milik Anda. Penyebaran Azure Communications Gateway Anda secara otomatis menerima nama domain yang sepenuhnya memenuhi syarat (FQDN) yang dihasilkan secara otomatis. Anda perlu menambahkan nama domain ini ke penyewa Microsoft Entra Anda sebagai nama domain kustom, bagikan detailnya dengan tim orientasi Anda lalu verifikasi nama domain. Proses ini mengonfirmasi bahwa Anda adalah pemilik domain.

1. Navigasi ke Gambaran Umum sumber daya Azure Communications Gateway Anda dan pilih Properti. Temukan bidang bernama Domain. Nama ini adalah nama domain penyebaran Anda.
2. Selesaikan prosedur berikut: Tambahkan nama domain kustom Anda ke ID Microsoft Entra.
3. Bagikan informasi catatan DNS TXT Anda dengan tim onboarding Anda. Tunggu tim orientasi Anda mengonfirmasi bahwa catatan DNS TXT telah dikonfigurasi dengan benar.
4. Selesaikan prosedur berikut: Verifikasi nama domain kustom Anda.

Langkah selanjutnya

Bersiaplah untuk lalu lintas langsung dengan Koneksi Operator dan Teams Telepon Mobile