Mengintegrasikan dengan API Provisi Azure Communications Gateway (pratinjau)
Artikel ini menjelaskan kapan Anda perlu berintegrasi dengan API Provisi Azure Communications Gateway (pratinjau) dan memberikan gambaran umum tingkat tinggi tentang memulai. Ini untuk pengembang perangkat lunak yang bekerja untuk operator telekomunikasi.
API Provisi memungkinkan Anda mengonfigurasi Azure Communications Gateway dengan detail pelanggan Anda dan nomor yang telah Anda tetapkan kepada mereka. Jika Anda menggunakan API Provisi untuk sinkronisasi layanan backend, Anda juga dapat menyediakan lingkungan Koneksi Operator dan Teams Telepon Mobile dengan detail pelanggan perusahaan Anda dan nomor yang Anda alokasikan kepada mereka. Provisi flow-through ini memungkinkan Anda memenuhi persyaratan Koneksi Operator dan Teams Telepon Mobile untuk menggunakan API untuk mengelola pelanggan dan nomor Anda setelah Anda meluncurkan layanan Anda.
API Provisi adalah REST API.
Apakah Anda berintegrasi dengan API Provisi bergantung pada layanan komunikasi yang Anda pilih.
| Layanan komunikasi | Integrasi API provisi | Tujuan |
|---|---|---|
| Perutean Langsung Microsoft Teams | Didukung (sebagai alternatif untuk Portal Manajemen Nomor) | - Mengonfigurasi subdomain yang terkait dengan setiap pelanggan Perutean Langsung. - Membuat catatan DNS khusus untuk setiap pelanggan (sebagaimana diperlukan oleh lingkungan Microsoft 365). - Menunjukkan bahwa angka diaktifkan untuk Perutean Langsung. - (Opsional) Mengonfigurasi header kustom untuk pesan ke jaringan Anda. |
| Sambungan Operator | Disarankan | - (Disarankan) Penyediaan flow-through Koneksi Operator pelanggan melalui interoperaksi dengan API Koneksi Operator (menggunakan sinkronisasi layanan backend). - (Opsional) Mengonfigurasi header kustom untuk pesan ke jaringan Anda. |
| Teams Telepon Mobile | Disarankan | - (Disarankan) Penyediaan alur teams Telepon pelanggan Seluler melalui interoperamen dengan API Koneksi Operator (menggunakan sinkronisasi layanan backend). |
| Zoom Telepon Cloud Peering | Didukung (sebagai alternatif untuk Portal Manajemen Nomor) | - Menunjukkan bahwa angka diaktifkan untuk Zoom. - (Opsional) Mengonfigurasi header kustom untuk pesan ke jaringan Anda. |
| Pratinjau Perlindungan Panggilan Operator Azure | Didukung (sebagai alternatif untuk Portal Manajemen Nomor) | - Menunjukkan bahwa nomor diaktifkan untuk Perlindungan Panggilan Operator Azure. - Provisi otomatis Perlindungan Panggilan Operator Azure. |
Tip
Portal Manajemen Nomor Azure Communications Gateway menyediakan fungsi yang setara untuk provisi manual. Namun, Anda tidak dapat menggunakan Portal Manajemen Nomor untuk provisi Koneksi Operator dan Teams Telepon Mobile secara menyeluruh setelah meluncurkan layanan Anda.
Prasyarat
Anda harus telah menyelesaikan Penyebaran Azure Communications Gateway.
Anda harus memiliki akses ke komputer dengan alamat IP yang diizinkan untuk mengakses API Provisi (pratinjau). Daftar izin alamat IP (atau rentang) ini dikonfigurasi sebagai bagian dari penyebaran Azure Communications Gateway.
Pelajari tentang API Provisi (pratinjau) dan rencanakan perubahan klien BSS Anda
Untuk berintegrasi dengan API, Anda perlu membuat (atau memperbarui) klien BSS yang dapat menghubungi API Provisi. API Provisi mendukung alur autentikasi kredensial klien OAuth 2.0 komputer ke mesin. Klien Anda mengautentikasi dan melakukan panggilan API resmi sebagai dirinya sendiri, tanpa interaksi pengguna.
Gunakan informasi Konsep utama dan Contoh dalam Referensi API untuk mempelajari tentang sumber daya yang tersedia melalui API dan permintaan yang perlu dibuat organisasi Anda.
- Sumber daya akun adalah deskripsi pelanggan operator (biasanya, perusahaan), dan pengaturan per pelanggan untuk provisi layanan.
- Sumber daya angka milik akun. Mereka menjelaskan angka, layanan yang digunakan angka (misalnya, Perutean Langsung Microsoft Teams), dan konfigurasi tambahan per angka.
- Sumber daya Request for Information (RFI) adalah deskripsi pelanggan operator (biasanya perusahaan) yang telah menyatakan minatnya untuk menerima layanan dari operator melalui Koneksi Operator dan Teams Telepon Mobile.
API Provisi memiliki batas tarif 100 permintaan per menit, diterapkan di semua sumber daya. Permintaan batch untuk memperbarui beberapa sumber daya dihitung sebagai satu permintaan.
Mengonfigurasi klien BSS Anda untuk menyambungkan ke Azure Communications Gateway
API Provisi (pratinjau) tersedia di port 443 dari provapi.<base-domain>, di mana <base-domain> merupakan domain dasar sumber daya Azure Communications Gateway.
Tip
Untuk menemukan domain dasar:
- Masuk ke portal Azure.
- Navigasi ke Gambaran Umum sumber daya Azure Communications Gateway Anda dan pilih Properti.
- Temukan bidang bernama Domain.
Catatan DNS memiliki time-to-live (TTL) 60 detik. Saat wilayah gagal, Azure memperbarui catatan DNS untuk merujuk ke wilayah lain, sehingga klien yang membuat pencarian DNS baru menerima detail wilayah baru. Sebaiknya pastikan bahwa klien dapat melakukan pencarian DNS baru dan mencoba kembali permintaan 60 detik setelah waktu habis atau respons 5xx.
Gunakan bagian Memulai dari Referensi API untuk mengonfigurasi Azure dan klien BSS Anda untuk memungkinkan klien BSS mengakses API Provisi.
Langkah-langkah berikut meringkas konfigurasi Azure yang Anda butuhkan. Lihat bagian Memulai dari Referensi API untuk detail selengkapnya, termasuk nilai konfigurasi yang diperlukan.
- Daftarkan klien BSS Anda di penyewa Azure yang sama dengan penyebaran Azure Communications Gateway Anda. Proses ini membuat pendaftaran aplikasi.
- Tetapkan diri Anda sebagai pemilik untuk pendaftaran aplikasi.
- Konfigurasikan pendaftaran aplikasi dengan cakupan yang ditentukan dalam Referensi API. Konfigurasi ini menunjukkan kepada Azure bahwa aplikasi Anda diizinkan untuk mengakses API Provisi.
- Sebagai administrator untuk penyewa, izinkan aplikasi untuk menggunakan peran aplikasi yang Anda tetapkan.