Sdílet prostřednictvím

Integrace s API zřizování služeb Azure Communications Gateway (náhled)

Tento článek vysvětluje, kdy potřebujete integraci s rozhraním API zřizování služby Azure Communications Gateway (Preview) a poskytuje základní přehled o tom, jak začít. Je určen vývojářům softwaru pracujícím pro telekomunikační operátory.

Rozhraní API pro zřizování umožňuje nakonfigurovat službu Azure Communications Gateway s podrobnostmi o zákaznících a číslech, která jste jim přiřadili. Pokud používáte rozhraní API zřizování pro synchronizaci back-endových služeb, můžete také zřídit prostředí Operátor Connect a Teams Phone Mobile s podrobnostmi o podnikových zákaznících a číslech, která jim přidělíte. Toto průchozí zřizování umožňuje splnit požadavek Operator Connect a Teams Phone Mobile pro používání API ke správě zákazníků a čísel po spuštění služby.

Rozhraní Provisioning API je REST API.

Na zvolené komunikační službě závisí, zda se integrujete se zřizovacím rozhraním API.

Komunikační služba Integrace rozhraní API pro zřizování Účel
Přímé směrování v Microsoft Teams Podporováno (jako alternativu k portálu pro správu čísel) – Konfigurace subdomény přidružené ke každému zákazníkovi s Direct Routing.
– Generování záznamů DNS specifických pro každého zákazníka (podle požadavků prostředí Microsoftu 365)
– Označuje, že jsou pro přímé směrování povolená čísla.
– (Volitelné) Konfigurace vlastní hlavičky pro zprávy v síti.
Připojení k operátorovi Doporučeno – (Doporučeno) Průchozí zřizování zákazníků Operator Connect prostřednictvím spolupráce s rozhraními API pro Operator Connect (pomocí synchronizace back-endové služby).
– (Volitelné) Konfigurace vlastní hlavičky pro zprávy v síti.
Mobilní aplikace Teams Phone Doporučeno – (Doporučeno) Průchozí zřizování zákazníků Teams Phone Mobile prostřednictvím interoperability s rozhraními Operator Connect API (pomocí synchronizace back-endové služby).
Zoom Phone Cloud Síťové Propojení Podporováno (jako alternativu k portálu pro správu čísel) - Označuje, že jsou pro Zoom povolená čísla.
– (Volitelné) Konfigurace vlastní hlavičky pro zprávy v síti.

Návod

Portál pro správu čísel služby Azure Communications Gateway poskytuje ekvivalentní funkci pro ruční zřizování. Portál pro správu čísel ale nemůžete použít k automatizovanému zřizování služby Operator Connect a Teams Phone Mobile po spuštění služby.

Požadavky

Musíte mít dokončené nasazení služby Azure Communications Gateway.

Musíte mít přístup k počítači s IP adresou, která má povolený přístup k rozhraní Provisioning API. Tento seznam povolených IP adres (nebo rozsahů) byl nakonfigurován jako součást nasazení služby Azure Communications Gateway.

Zjistěte více o rozhraní API pro zřizování (Preview) a naplánujte změny klienta BSS

Pokud se chcete integrovat s rozhraním API, musíte vytvořit (nebo aktualizovat) klienta BSS, který může kontaktovat zřizovací rozhraní API. Rozhraní API pro zřizování podporuje tok ověřování pomocí přihlašovacích údajů klienta OAuth 2.0 pro komunikaci strojů. Váš klient se ověřuje a provádí autorizovaná volání rozhraní API jako sama o sobě bez interakce uživatelů.

Informace o klíčových konceptech a příkladech v referenčních informacích k rozhraní API vám použijí k získání informací o prostředcích dostupných přes rozhraní API a požadavcích, které vaše organizace potřebuje provést.

  • Zdroje účtů jsou popisy zákazníků operátora (obvykle podnik) a nastavení pro zřizování služeb pro jednotlivé zákazníky.
  • Počet prostředků patří do účtu. Popisují čísla, služby, které čísla využívají (například Microsoft Teams Direct Routing) a jakákoli další konfigurace pro jednotlivá čísla.
  • Zdroje informací (RFI) jsou popisy zákazníků operátora (obvykle podniku), kteří vyjádřili zájem o příjem služeb od operátora prostřednictvím operátora Connect a Teams Phone Mobile.

Rozhraní API zřizování má limit rychlosti 100 požadavků za minutu, které se použijí ve všech prostředcích. Dávkový požadavek na aktualizaci více prostředků se počítá jako jeden požadavek.

Konfigurace klienta BSS pro připojení ke službě Azure Communications Gateway

Rozhraní Provisioning API (Preview) je k dispozici na portu 443, provapi.<base-domain> kde <base-domain> je základní doména prostředku Azure Communications Gateway.

Návod

Vyhledání základní domény:

  1. Přihlaste se k portálu Azure.
  2. Přejděte na přehled prostředku služby Azure Communications Gateway a vyberte Vlastnosti.
  3. Vyhledejte pole s názvem Doména.

Záznam DNS má hodnotu TTL (Time to Live) 60 sekund. Když dojde k selhání oblasti, Azure aktualizuje záznam DNS tak, aby odkazoval na jinou oblast, takže klienti, kteří provedou nový dotaz DNS, obdrží podrobnosti o nové oblasti. Doporučujeme zajistit, aby klienti mohli vytvořit nové vyhledávání DNS a opakovat požadavek 60 sekund po vypršení časového limitu nebo odpovědi 5xx.

V části Začínáme referenční příručky API nakonfigurujte Azure a klienta BSS, abyste umožnili klientovi BSS přístup k API pro zřizování.

Následující kroky shrnují potřebnou konfiguraci Azure. Úplné podrobnosti, včetně požadovaných hodnot konfigurace, najdete v části Začínámes referenčními informacemi k rozhraní API .

  1. Zaregistrujte klienta BSS ve stejném tenantovi Azure jako nasazení služby Azure Communications Gateway. Tento proces vytvoří registraci aplikace.
  2. Přiřaďte se jako vlastník pro registraci aplikace.
  3. Nakonfigurujte registraci aplikace s obory definovanými v referenčních informacích k rozhraní API. Tato konfigurace značí Azure, že vaše aplikace má povolený přístup k rozhraní API zřizování.
  4. Jako administrátor klienta umožněte aplikaci používat role, které jste jí přiřadili.

Další kroky

  • Last updated on