與 Azure 通訊閘道的佈建 API (預覽) 整合
本文說明何時需要與 Azure 通訊閘道的佈建 API (預覽) 整合，並提供使用者入門的高階概觀。 它適用於為電信運營商工作的軟體開發人員。
佈建 API 可讓您設定 Azure 通訊閘道，使其具有客戶的詳細資料，以及您為其指派的號碼。 如果您使用佈建 API 進行後端服務同步，您也可以使用企業客戶的詳細資料和您為其配置的號碼，來佈建 Operator Connect 和 Teams 電話行動環境。 此流程式佈建可讓您符合 Operator Connect 和 Teams 電話行動的需求，以在啟動服務之後使用 API 來管理您的客戶和號碼。
佈建 API 是 REST API。
您是否要與布建 API 整合，取決於您選擇的通訊服務。
| 通訊服務 | 佈建 API 整合 | 目的 |
|---|---|---|
| Microsoft Teams 直接路由 | 支援 （作為號碼管理入口網站的替代方案） | - 設定與每個直接路由客戶相關聯的子網域。 - 產生每位客戶專屬的 DNS 記錄 (Microsoft 365 環境需要)。 - 表示號碼已啟用直接路由。 - (選用) 設定通往您的網路的訊息的自訂標頭。 |
| 操作員連線 | 建議需求 | - (建議) Operator Connect 客戶的流程式佈建會透過與 Operator Connect API 的互通進行 (使用後端服務同步)。 - (選用) 設定通往您的網路的訊息的自訂標頭。 |
| Teams 電話行動版 | 建議需求 | - (建議) Teams 電話行動客戶的流程式佈建會透過與 Operator Connect API 的互通進行 (使用後端服務同步)。 |
| Zoom Phone 雲端對等互連 | 支援 （作為號碼管理入口網站的替代方案） | - 表示號碼已啟用 Zoom。 - (選用) 設定通往您的網路的訊息的自訂標頭。 |
提示
Azure 通訊閘道的號碼管理入口網站提供手動布建的對等功能。 不過，在啟動服務之後，您無法使用號碼管理入口網站來徹底布建 電信業者連線 和 Teams 電話行動裝置版。
必要條件
您必須已完成部署 Azure 通訊閘道。
您必須具有允許存取布建 API 之 IP 位址的電腦存取權（預覽版）。 此 IP 位址 (或範圍) 的允許清單是隨著部署 Azure 通訊閘道的一部分設定。
瞭解布建 API （預覽） 並規劃 BSS 用戶端變更
若要與 API 整合，您必須建立 (或更新) 可連絡佈建 API 的 BSS 用戶端。 佈建 API 支援電腦對電腦的 OAuth 2.0 用戶端認證驗證流程。 您的用戶端會自行驗證並進行授權的 API 呼叫，而不需要使用者的互動。
使用 API 參考中的重要概念和範例資訊，以了解 API 上可用的資源，以及您的組織需要提出的要求。
- 帳戶資源是操作員客戶的描述 (通常是企業)，以及用於佈建服務的每一客戶設定。
- 號碼資源屬於帳戶。 它們會描述號碼、號碼所使用的服務 (例如 Microsoft Teams 直接路由)，以及任何額外的每一號碼設定。
- 要求資訊 (RFI) 資源是操作員客戶 (通常是企業) 的描述，其對於透過 Operator Connect 和 Teams 電話行動從操作員接收服務表示有興趣。
佈建 API 的速率限制為每分鐘 100 個要求，套用至所有資源。 更新多個資源的批次要求會計為一個要求。
設定 BSS 用戶端以連線到 Azure 通訊閘道
布建 API （預覽） 可在 的 provapi.<base-domain>埠 443 上使用，其中 <base-domain> 是 Azure 通訊網關資源的基域。
提示
若要尋找基礎網域：
- 登入 Azure 入口網站。
- 瀏覽至 Azure 通訊閘道資源的 [概觀]，然後選取 [屬性]。
- 尋找名為網域的欄位。
DNS 記錄的存留時間為 60 秒。 當一個區域失敗時，Azure 會更新 DNS 記錄以參考另一個區域，因此進行新 DNS 查閱的用戶端會收到新區域的詳細資料。 建議確保用戶端可以在逾時或 5xx 回應之後，於 60 秒後進行新的 DNS 查閱，並重試要求。
使用 [API 參考] 的 [開始使用] 區段來設定 Azure 和 BSS 用戶端，以允許 BSS 用戶端存取佈建 API。
下列步驟摘要說明您需要的 Azure 設定。 如需完整詳細資料 (包括必要的設定值)，請參閱 API 參考的快速入門一節。
- 在與 Azure 通訊閘道部署相同的 Azure 租用戶中註冊 BSS 用戶端。 此程序會建立應用程式註冊。
- 將自己指派為應用程式註冊的擁有者。
- 使用 API 參考中定義的範圍來設定應用程式註冊。 此設定會向 Azure 指出允許您的應用程式存取佈建 API。
- 身為租用戶的系統管理員，允許應用程式使用您指派的應用程式角色。