Azure Communications Gateway'in Sağlama API'siyle tümleştirme (önizleme)
Bu makalede, Azure Communications Gateway'in Sağlama API'siyle (önizleme) ne zaman tümleştirmeniz gerektiği açıklanır ve kullanmaya başlamaya yönelik üst düzey bir genel bakış sağlanır. Telekomünikasyon operatörleri için çalışan yazılım geliştiricilerine yöneliktir.
Sağlama API'si, Azure Communications Gateway'i müşterilerinizin ayrıntıları ve onlara atadığınız numaralarla yapılandırmanıza olanak tanır. Arka uç hizmeti eşitlemesi için Sağlama API'sini kullanıyorsanız, kurumsal müşterilerinizin ayrıntılarını ve onlara ayırdığınız numaraları içeren Operatör Bağlantısı ve Teams Telefon Mobile ortamlarını da sağlayabilirsiniz. Bu akış sağlama, hizmetinizi başlattıktan sonra müşterilerinizi ve numaralarınızı yönetmek için API'leri kullanmak için Operatör Bağlantısı ve Teams Telefon Mobile gereksinimini karşılamanızı sağlar.
Sağlama API'si bir REST API'dir.
Sağlama API'siyle tümleştirilip tümleştirilemediğiniz, seçtiğiniz iletişim hizmetine bağlıdır.
| İletişim hizmeti | SAĞLAMA API tümleştirmesi | Purpose |
|---|---|---|
| Microsoft Teams Doğrudan Yönlendirme | Desteklenir (Sayı Yönetimi Portalı'na alternatif olarak) | - Her Direct Routing müşterisiyle ilişkili alt etki alanını yapılandırma. - Her müşteriye özgü DNS kayıtları oluşturma (Microsoft 365 ortamının gerektirdiği şekilde). - Sayıların Doğrudan Yönlendirme için etkinleştirildiğini belirtir. - (İsteğe bağlı) Ağınıza gönderilen iletiler için özel üst bilgi yapılandırma. |
| Operatör Bağlantısı | Önerilir | - (Önerilen) Operatör Bağlantısı API'leri ile birlikte çalışma (arka uç hizmeti eşitlemesi kullanılarak) aracılığıyla Operatör Bağlantısı müşterilerin akışla sağlanması. - (İsteğe bağlı) Ağınıza gönderilen iletiler için özel üst bilgi yapılandırma. |
| Teams Telefon Mobile | Önerilir | - (Önerilen) Teams Telefon Mobil müşterilerinin Operatör Bağlantısı API'lerle birlikte çalışma yoluyla (arka uç hizmet eşitlemesini kullanarak) akışla sağlama. |
| Bulut Eşlemesi Telefon Yakınlaştırma | Desteklenir (Sayı Yönetimi Portalı'na alternatif olarak) | - Sayıların Yakınlaştırma için etkinleştirildiğini belirtir. - (İsteğe bağlı) Ağınıza gönderilen iletiler için özel üst bilgi yapılandırma. |
| Azure Operatör Çağrı Koruması Önizlemesi | Desteklenir (Sayı Yönetimi Portalı'na alternatif olarak) | - Numaraların Azure Operatör Çağrı Koruması için etkinleştirildiğini belirtir. - Azure Operatör Çağrı Koruması'nın otomatik olarak sağlanması. |
İpucu
Azure Communications Gateway'in Sayı Yönetimi Portalı, el ile sağlama için eşdeğer bir işlev sağlar. Ancak hizmetinizi başlattıktan sonra Operatör Bağlantısı ve Teams Telefon Mobile'ın akışla kapsamlı bir şekilde sağlanması için Sayı Yönetimi Portalı'nı kullanamazsınız.
Önkoşullar
Azure Communications Gateway'i dağıtmayı tamamlamış olmanız gerekir.
Sağlama API'sine (önizleme) erişmesine izin verilen IP adresine sahip bir makineye erişiminiz olmalıdır. Bu IP adresleri (veya aralıkları) izin verilenler listesi, Azure Communications Gateway dağıtımının bir parçası olarak yapılandırıldı.
Sağlama API'sini (önizleme) öğrenin ve BSS istemci değişikliklerinizi planlayın
API ile tümleştirmek için, Sağlama API'siyle iletişim kurabilen bir BSS istemcisi oluşturmanız (veya güncelleştirmeniz) gerekir. Sağlama API'si, makineden makineye OAuth 2.0 istemci kimlik bilgileri kimlik doğrulama akışını destekler. İstemciniz kimlik doğrulaması yapar ve kullanıcıların etkileşimi olmadan yetkili API çağrılarını kendisi olarak yapar.
API üzerinden kullanılabilen kaynaklar ve kuruluşunuzun yapması gereken istekler hakkında bilgi edinmek için API Başvurusu'ndaki Temel kavramlar ve Örnekler bilgilerini kullanın.
- Hesap kaynakları, operatör müşterilerinin (genellikle bir kuruluş) ve hizmet sağlama için müşteri başına ayarların açıklamalarıdır.
- Sayı kaynakları bir hesaba aittir. Sayıları, sayıların kullandığı hizmetleri (örneğin, Microsoft Teams Doğrudan Yönlendirme) ve numara başına ek yapılandırmaları açıklar.
- Bilgi İsteği (RFI) kaynakları, operatörden Operatör Bağlantısı ve Teams Telefon Mobile aracılığıyla hizmet almakla ilgilendiğini ifade eden operatör müşterilerinin (genellikle bir kuruluş) açıklamalarıdır.
Sağlama API'sinin tüm kaynaklara uygulanan dakikada 100 istek hız sınırı vardır. Birden çok kaynağı güncelleştirmeye yönelik toplu istek, tek bir istek olarak sayılır.
BSS istemcinizi Azure Communications Gateway'e bağlanacak şekilde yapılandırma
Sağlama API'si (önizleme), Azure Communications Gateway kaynağının provapi.<base-domain>temel etki alanı olan <base-domain> 443 numaralı bağlantı noktasında kullanılabilir.
İpucu
Temel etki alanını bulmak için:
- Azure Portal’ında oturum açın.
- Azure Communications Gateway kaynağınıza Genel Bakış'a gidin ve Özellikler'i seçin.
- Etki Alanı adlı alanı bulun.
DNS kaydının yaşam süresi (TTL) 60 saniyedir. Bölge başarısız olduğunda Azure, DNS kaydını başka bir bölgeye başvurmak üzere güncelleştirir, böylece yeni dns araması yapan istemciler yeni bölgenin ayrıntılarını alır. İstemcilerin yeni bir DNS araması yapabilmesini ve zaman aşımı veya 5xx yanıt sonrasında 60 saniye sonra isteği yeniden denemesini öneririz.
Azure'ı ve BSS istemcinizi BSS istemcisinin Sağlama API'sine erişmesine izin verecek şekilde yapılandırmak için API Başvurusu'nun Başlarken bölümünü kullanın.
Aşağıdaki adımlar, ihtiyacınız olan Azure yapılandırmasını özetler. Gerekli yapılandırma değerleri de dahil olmak üzere tüm ayrıntılar için API Başvurusu'nun Başlarken bölümüne bakın.
- BSS istemcinizi Azure Communications Gateway dağıtımınızla aynı Azure kiracısında kaydedin. Bu işlem bir uygulama kaydı oluşturur.
- Uygulama kaydı için kendinizi sahip olarak atayın.
- Uygulama kaydını API Başvurusu'nda tanımlanan kapsamlarla yapılandırın. Bu yapılandırma, Azure'a uygulamanızın Sağlama API'sine erişmesine izin verildiğini gösterir.
- Kiracının yöneticisi olarak, uygulamanın atadığınız uygulama rollerini kullanmasına izin verin.