Integrace s rozhraním API zřizování služby Azure Communications Gateway (Preview)
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í Připojení operátora a Teams Phone Mobile s podrobnostmi o podnikových zákaznících a číslech, která jim přidělíte. Toto zřizování toku umožňuje splnit požadavky na Připojení operátora a Teams Phone Mobile ke správě zákazníků a čísel po spuštění služby.
Rozhraní API pro zřizování je rozhraní REST API.
To, jestli se integrujete s rozhraním API zřizování, závisí na zvolené komunikační službě.
| 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 přímým směrováním. – 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í operátora | Doporučené | – (doporučeno) Zřizování Připojení operátora zákazníků prostřednictvím spolupráce s rozhraními API Připojení operátora (pomocí synchronizace back-endové služby). – (Volitelné) Konfigurace vlastní hlavičky pro zprávy v síti. |
| Mobilní aplikace Teams Phone | Doporučené | – (Doporučeno) Zřizování mobilních zařízení Teams Phone prostřednictvím spolupráce s rozhraními API Připojení operátora (pomocí synchronizace back-endové služby). |
| Zoom Phone Cloud Peering | Podporováno (jako alternativu k portálu pro správu čísel) | - Označuje, že jsou pro lupu povolená čísla. – (Volitelné) Konfigurace vlastní hlavičky pro zprávy v síti. |
Tip
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 důkladnému zřizování Připojení operátora a aplikace 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í API zřizování (Preview). Tento seznam povolených IP adres (nebo rozsahů) byl nakonfigurován jako součást nasazení služby Azure Communications Gateway.
Informace o rozhraní API pro zřizování (Preview) a plánování změn 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í přihlašovacích údajů klienta OAuth 2.0 počítače. 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 přímé směrování Microsoft Teams) a jakoukoli další konfiguraci podle čísla.
- Žádosti o informace (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 Připojení operátora a Aplikace 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í API zřizování (Preview) je k dispozici na portu 443 , provapi.<base-domain>kde <base-domain> je základní doména prostředku služby Azure Communications Gateway.
Tip
Vyhledání základní domény:
- Přihlaste se k portálu Azure.
- Přejděte na přehled prostředku služby Azure Communications Gateway a vyberte Vlastnosti.
- Vyhledejte pole s názvem Doména.
Záznam DNS má hodnotu TTL (Time to Live) 60 sekund. Když se oblast nezdaří, Azure aktualizuje záznam DNS tak, aby odkazovat na jinou oblast, takže klienti, kteří vytvoří nové vyhledávání 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 s referenčními informacemi k rozhraní API nakonfigurujte Azure a klienta BSS, abyste klientovi BSS umožnili přístup k rozhraní API 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áme s referenčními informacemi k rozhraní API.
- Zaregistrujte klienta BSS ve stejném tenantovi Azure jako nasazení služby Azure Communications Gateway. Tento proces vytvoří registraci aplikace.
- Přiřaďte sami sebe jako vlastníka registrace aplikace.
- 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í.
- Jako správce tenanta povolte aplikaci používat role aplikace, které jste přiřadili.