Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel wird erläutert, wann Sie die Bereitstellungs-API des Azure Communications Gateways (Vorschau) integrieren müssen, und bietet eine allgemeine Übersicht über die ersten Schritte. Es ist für Softwareentwickler gedacht, die für Telekommunikationsbetreiber arbeiten.
Mit der Bereitstellungs-API können Sie das Azure Communications-Gateway mit den Details Ihrer Kunden und den Nummern konfigurieren, die Sie ihnen zugewiesen haben. Wenn Sie die Bereitstellungs-API für die Back-End-Dienstsynchronisierung verwenden, können Sie auch die Umgebungen "Operator Connect" und "Teams Phone Mobile" mit den Details Ihrer Unternehmenskunden und den Nummern bereitstellen, die Sie ihnen zuweisen. Diese Flow-Through-Bereitstellung ermöglicht es Ihnen, die Anforderungen von Operator Connect und Teams Phone Mobile zu erfüllen, um APIs zur Verwaltung Ihrer Kunden und Nummern nach dem Start Ihres Dienstes zu nutzen.
Die Bereitstellungs-API ist eine REST-API.
Ob Sie in die Bereitstellungs-API integriert werden, hängt von Ihrem ausgewählten Kommunikationsdienst ab.
| Kommunikationsdienst | Bereitstellungs-API-Integration | Zweck |
|---|---|---|
| Microsoft Teams Direct Routing | Unterstützt (als Alternative zum Nummernverwaltungsportal) | – Konfigurieren der Subdomäne, die den einzelnen Direct Routing-Kunden zugeordnet ist. – Generieren von DNS-Einträgen, die für jeden Kunden spezifisch sind (wie in der Microsoft 365-Umgebung erforderlich). – Gibt an, dass Nummern für Direct Routing aktiviert sind. – (Optional) Konfigurieren eines benutzerdefinierten Headers für Nachrichten in Ihrem Netzwerk. |
| Telefonieanbieter | Recommended | - (Empfohlen) Flow-Through-Bereitstellung von Operator Connect-Kunden über die Interoperabilität mit Operator Connect-APIs (mithilfe der Back-End-Dienstsynchronisierung). – (Optional) Konfigurieren eines benutzerdefinierten Headers für Nachrichten in Ihrem Netzwerk. |
| Teams Telefon für Mobilgeräte | Recommended | - (Empfohlen) Durchlaufende Bereitstellung von Microsoft Teams Phone Mobile-Kunden durch Interoperabilität mit Operator Connect-APIs (unter Verwendung der Synchronisation von Back-End-Diensten). |
| Zoom Phone Cloud Peering | Unterstützt (als Alternative zum Nummernverwaltungsportal) | – Gibt an, dass Zahlen für Zoom aktiviert sind. – (Optional) Konfigurieren eines benutzerdefinierten Headers für Nachrichten in Ihrem Netzwerk. |
Tipp
Das Nummernverwaltungsportal des Azure Communications Gateways bietet eine gleichwertige Funktion für die manuelle Bereitstellung. Sie können das Nummernverwaltungsportal jedoch nicht für die durchgängige Bereitstellung von Operator Connect und Teams Phone Mobile verwenden, sobald Sie Ihren Dienst gestartet haben.
Voraussetzungen
Sie müssen das Bereitstellen des Azure Communications Gateways abgeschlossen haben.
Sie benötigen Zugriff auf einen Computer mit einer IP-Adresse, die für den Zugriff auf die Bereitstellungs-API (Vorschau) zulässig ist. Diese Zulassungsliste von IP-Adressen (oder Bereichen) wurde als Teil der Bereitstellung des Azure Communications Gateway konfiguriert.
Erfahren Sie mehr über die Bereitstellungs-API (Vorschau) und planen Sie Ihre BSS-Clientänderungen.
Um in die API zu integrieren, müssen Sie einen BSS-Client erstellen (oder aktualisieren), der sich an die Bereitstellungs-API wenden kann. Die Bereitstellungs-API unterstützt den von Maschine zu Maschine Authentifizierungsfluss für OAuth 2.0-Client-Anmeldeinformationen. Ihr Client authentifiziert sich und führt autorisierte API-Aufrufe als sich selbst aus, ohne die Interaktion von Benutzern.
Verwenden Sie die wichtigsten Konzepte und Beispiele in der API-Referenz , um mehr über die ressourcen zu erfahren, die über die API verfügbar sind, und die Anforderungen, die Ihre Organisation vornehmen muss.
- Kontoressourcen sind Beschreibungen von Betreiberkunden (in der Regel ein Unternehmen) und einstellungen pro Kunde für die Dienstbereitstellung.
- Nummern von Ressourcen gehören zu einem Konto. Sie beschreiben Rufnummern, die Dienste, die von den Rufnummern genutzt werden (z. B. Microsoft Teams Direct Routing), und alle zusätzlichen Konfigurationen pro Nummer.
- "Informationsressourcen (RFI) beschreiben Kunden des Betreibers (in der Regel ein Unternehmen), die ihr Interesse daran bekundet haben, Dienste über Operator Connect und Teams Phone Mobile vom Betreiber zu erhalten."
Die Bereitstellungs-API hat einen Grenzwert von 100 Anforderungen pro Minute, der für alle Ressourcen gilt. Eine Batch-Anforderung zur Aktualisierung mehrerer Ressourcen zählt als eine Anforderung.
Konfigurieren Ihres BSS-Clients für die Verbindung mit dem Azure Communications Gateway
Die Bereitstellungs-API (Vorschau) steht am Port 443 von provapi.<base-domain>, wobei <base-domain> die Basisdomäne der Azure Communications Gateway-Ressource ist.
Tipp
So suchen Sie die Basisdomäne:
- Melden Sie sich beim Azure-Portal an.
- Navigieren Sie zur Übersicht Ihrer Azure Communications Gateway-Ressource, und wählen Sie "Eigenschaften" aus.
- Suchen Sie das Feld namens "Domäne".
Der DNS-Eintrag hat eine TTL (Time-to-Live) von 60 Sekunden. Wenn eine Region fehlschlägt, aktualisiert Azure den DNS-Eintrag so, dass er auf eine andere Region verweist, sodass Clients, die eine neue DNS-Suche erstellen, die Details der neuen Region erhalten. Es wird empfohlen, sicherzustellen, dass Clients eine neue DNS-Suche durchführen und eine Anforderung 60 Sekunden nach einem Timeout oder einer 5xx-Antwort wiederholen können.
Verwenden Sie den Abschnitt " Erste Schritte " der API-Referenz , um Azure und Ihren BSS-Client zu konfigurieren, damit der BSS-Client auf die Bereitstellungs-API zugreifen kann.
Die folgenden Schritte fassen die azure-Konfiguration zusammen, die Sie benötigen. Ausführliche Informationen, einschließlich der erforderlichen Konfigurationswerte, finden Sie im Abschnitt " Erste Schritte " der API-Referenz .
- Registrieren Sie Ihren BSS-Client im selben Azure-Mandanten wie Ihr Azure Kommunikations-Gateway-Deployment. Dieser Prozess erstellt eine App-Registrierung.
- Weisen Sie sich selbst als Besitzer für die App-Registrierung zu.
- Konfigurieren Sie die App-Registrierung mit den bereichen, die in der API-Referenz definiert sind. Diese Konfiguration gibt Azure an, dass Ihre Anwendung auf die Bereitstellungs-API zugreifen darf.
- Als Administrator für den Mandanten erlauben Sie der Anwendung, die von Ihnen zugewiesenen App-Rollen zu verwenden.