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.
Important
Dieses Feature von Azure Communication Services befindet sich derzeit in der Vorschau. Features in der Vorschau sind öffentlich verfügbar und können von allen neuen und vorhandenen Microsoft-Kunden verwendet werden.
Vorschau-APIs und -SDKs werden ohne Vereinbarung zum Servicelevel bereitgestellt. Es wird empfohlen, diese nicht für Produktionsworkloads zu verwenden. Bestimmte Features werden möglicherweise nicht unterstützt oder Funktionen sind eingeschränkt.
Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.
Introduction
Willkommen bei Messaging Connect, einer neuen Möglichkeit, short Message Service (SMS) global mit Azure Communication Services bereitzustellen. Es integriert vertrauenswürdige Partner, sodass Sie Nummern leasen und lokale behördliche Anforderungen erfüllen können, während Sie weiterhin die vertrauten Azure Communication Services verwenden: einzelner API-Endpunkt, starke Observierbarkeit und umfassende Integration in Microsoft-Dienste. Ganz gleich, ob Sie Terminerinnerungen, Buchungsbestätigungen oder intelligente Copilot-Eingabeaufforderungen senden, Messaging Connect hilft Ihnen, Benutzer global mit geringerer Komplexität zu erreichen.
Anstatt separate Integrationen mit mehreren Anbietern zu erstellen und aufrechtzuerhalten, verbinden Sie sich einmal über Azure Communication Services und leiten Datenverkehr an globale Partner weiter. Der Partner übernimmt das Nummernleasing und die Regelkonformität. Messaging-, Observability- und KI-Workflows verbleiben in Ihrer Azure-Umgebung, in der Sie bereits erstellen, überwachen und skalieren.
Wert auf einen Blick:
Weltweite Reichweite über 190+ Länder
Lokale Compliance und schnellere Bereitstellung über Partner
Einfache Verwendung von Azure Communication Services-APIs/SDKs, Diagnosen und Event Grid-Observability
Aufgabentrennung: Microsoft stellt die Entwicklerplattform bereit; Partner liefern und stellen Nummern bereit
Konzeptionelle Übersicht
Globale SMS ist inhärent komplex: Vorschriften unterscheiden sich je nach Land, Absendertypen variieren und Lieferwege sind fragmentiert. Messaging Connect integriert vorab genehmigte Partner, sodass Sie kompatible Absenderidentitäten erwerben und Datenverkehr weiterleiten können, ohne die Azure Communication Services-Entwicklerumgebung verlassen zu müssen.
Bereitstellungsfluss (hohe Ebene):
Wechseln Sie im Azure-Portal zum Bereich "Messaging Connect".
Wählen Sie Ihren Messaging Connect-Partner aus.
Sie werden zum Portal des Partners umgeleitet, um SMS-fähige Telefonnummern zu kaufen/zu konfigurieren, alle erforderlichen Registrierungen abzuschließen und die Genehmigung zu warten.
Der Partner synchronisiert genehmigte Nummern zurück zu Ihrer Azure Communication Services-Ressource.
Die Nummer wird im Azure-Portal angezeigt und kann mit AZURE Communication Services-SMS-APIs verwendet werden.
Sie können SMS mit den standardmäßigen AZURE Communication Services-SMS-APIs senden und empfangen. Wenn Sie Nachrichten senden, authentifizieren Sie sich wie gewohnt bei Azure und schließen einen Schlüssel aus Ihrem Messaging Connect-Partner zur Laufzeit ein, damit wir Ihren Datenverkehr entsprechend weiterleiten können. Der Partner verarbeitet die Nachrichtenübermittlung, während die Beobachtbarkeit – z. B. Übermittlungsbestätigungen, Diagnose und Protokollierung – mit Ihren anderen Diensten in Azure verbleibt.
Dieses Modell eignet sich gut in realen Szenarien. Sie können Messaging Connect verwenden, um Benutzer weltweit zu erreichen – ganz gleich, ob Sie einen KI-gestützten Assistenten mit Copilot Studio erstellen, Logistik verwalten, die lokale Absender-IDs in Brasilien und Indien erfordert, oder Kampagnen in Dutzenden von Ländern koordinieren. Mit Azure Communication Services über Messaging Connect können Sie die richtigen Absenderidentitäten über einen vertrauenswürdigen Partner erwerben und mit Ihrem bevorzugten Azure Communication Services SMS SDK verwenden und gleichzeitig die volle Kontrolle und Observierbarkeit in Azure behalten.
Capabilities
In der folgenden Tabelle sind die verfügbaren Funktionen für die Verwendung von Messaging Connect während der öffentlichen Vorschau zusammengefasst. Einige Funktionen werden direkt von Azure bereitgestellt, andere von Messaging Connect-Partnern.
| Capability | Supported |
|---|---|
| Unterstützte Partner | Infobip (weitere Partner in Kürze verfügbar) |
| Lange Codes | ✔️ |
| Dynamische alphanumerische Absender-ID | ✔️ |
| Kurzcodes | ❌ (in Kürze verfügbar) |
| Vorregistrierte Alpha-Absender-ID (partnerverwaltet) | ✔️ |
| Bidirektionale Nachrichten | ✔️ |
| Einweg-Kommunikation | ✔️ |
| 1:1 (einzelner Empfänger) | ✔️ |
| 1:N (Massennachrichten) | ✔️ |
| Abdeckung in 190 Ländern | ✔️ |
| Zustellberichte (DLRs) | ✔️ |
| Ereignisraster für eingehende Nachrichten | ✔️ |
| Partnerverwaltetes Opt-Out | ✔️ |
| Durchsetzung lokaler Vorschriften | ✔️ |
| C# SDK | ✔️ |
| JavaScript SDK | ✔️ |
| Python SDK | ❌ (in Kürze verfügbar) |
| Java-SDK | ❌ (in Kürze verfügbar) |
| Automatische Länderauswahl (von Partnern verwaltet) | Infobip ✔️ |
🌐 Verfügbarkeit des Landes
Messaging Connect erweitert erheblich die Anzahl der Länder, die Sie mit Azure Communication Services erreichen können – unterstützt über 190 Länder über unser globales Partnernetzwerk. Während der öffentlichen Vorschau können Sie zwei Arten von Absenderidentitäten aus dem Messaging Connect-Partner erwerben und verwenden:
- Lange Codes – Standardmäßige lokale Telefonnummern oder Mobiltelefonnummern, die bidirektionale SMS unterstützen. Häufig als virtuelle Langcodes bezeichnet.
- Dynamische alphanumerische Absender-IDs – Unidirektionale, markenbezogene Absender (z. B. "CONTOSO"), sofern zulässig. Sie können DASID nur in nicht von Azure unterstützten Ländern aktivieren.
Wenn Sie im Azure-Portal nach einem Land und Nummerntyp suchen, wird Messaging Connect als Option angeboten, wenn Azure Communication Services diese Konfiguration nicht direkt unterstützt. Anschließend führen Sie den Bereitstellungsprozess über das Portal des Partners aus.
Der Messaging Connect-Partner bestimmt die Verfügbarkeit des Landes. Der Messaging Connect-Partner (z. B. Infobip) verarbeitet Nummerntypen, Complianceanforderungen und Onboardingschritte, die je nach Land variieren.
| Partner | Globale Reichweite | Unterstützte Länder |
|---|---|---|
| Infobip | Mit 800+ Netzbetreibern in 200 Ländern verbunden, unterstützt Infobip Kurzcodes, lange Codes (VLNs) und alphanumerische Absender. Unidirektionale SMS ist in fast allen Märkten erhältlich; bidirektionale in mehr als 100 Ländern. | Infobip-Abdeckung anzeigen. |
Authentifizierung: Sicherer Zugriff mit Azure Identity
Um Nachrichten über Messaging Connect zu senden, muss Ihre Anwendung sich mit Azure Communication Services mithilfe eines der unterstützten Identitätsmodelle authentifizieren. Dieser Schritt überprüft, ob Ihre App über die Berechtigung zum Senden von Nachrichten über Ihre Azure Communication Services-Ressource verfügt und sicherstellt, dass Ihre Nachrichten dem richtigen Azure-Abonnement zugeordnet sind.
Azure Communication Services unterstützt die folgenden Authentifizierungsmethoden:
- Zugriffstastenauthentifizierung (Verbindungszeichenfolgen)
- Microsoft Entra ID-Authentifizierung
Sie authentifizieren sich bei Azure Communication Services auf die gleiche Weise wie bei jeder anderen SMS-Anforderung. Messaging Connect ändert nicht die Funktionsweise der Authentifizierung auf Plattformebene – sie fügt einfach einen partnerbasierten Routingschritt hinzu, nachdem Ihre Nachricht überprüft wurde.
Weitere Informationen: Authentifizieren bei Azure Communication Services
Nach der Authentifizierung enthält Ihre Anwendung zur Laufzeit auch einen Partner-API-Schlüssel, um die Nachricht über den richtigen Messaging Connect-Partner weiterzuleiten. Dieser Partner-API-Schlüssel ist Teil der Nachrichtennutzlast und wird im nächsten Abschnitt weiter erläutert.
Wie Messaging Connect Ihre Anforderungen überprüft
Bevor eine Nachricht mithilfe von Messaging Connect gesendet werden kann, überprüft Azure, ob Ihre Anforderung die erforderlichen Routinginformationen enthält und ordnungsgemäß authentifiziert ist. Um diesen Schritt auszuführen, muss Ihre Nutzlast bestimmte Metadaten enthalten, die den Messaging Connect-Partner identifizieren und Azure Communication Services die Weiterleitung der Nachricht über ihre Infrastruktur ermöglichen.
Erforderliches Payloadformat
Wenn Sie eine Nachricht mit einer Messaging Connect-Nummer senden, muss Ihre Anforderung ein messagingConnect Objekt enthalten. Dieses Objekt enthält den API-Schlüssel, der vom Messaging Connect-Partner (z. B. Infobip) und dem Namen des Partners bereitgestellt wird. Azure verwendet diese Informationen, um die Anforderung zu autorisieren und zu bestimmen, wie die Nachricht weitergeleitet wird.
{
"from": "+447700900123",
"to": ["+447700900456"],
"message": "Hello from Messaging Connect!",
"options": {
"messagingConnect": {
"apiKey": "your-partner-api-key",
"partner": "[PARTNER NAME]"
}
}
}
Das messagingConnect Objekt ist immer dann erforderlich, wenn Sie eine über Messaging Connect bereitgestellte Nummer verwenden. Wenn sie fehlt oder falsch konfiguriert ist, lehnt Azure Communication Services die Nachricht ab.
Sobald diese Metadaten enthalten sind, führt Azure Communication Services Überprüfungen in zwei Phasen durch: Zuerst überprüft Azure Communication Services Ihre Anforderung, sobald sie empfangen wird, und dann erneut nach der Übermittlung an den Partner.
Synchrone Überprüfung
Diese erste Überprüfungsebene erfolgt, sobald Azure Communication Services Ihre Nachrichtenanfrage empfängt. Wenn etwas fehlt oder ungültig ist – z. B. der Partnername, der API-Schlüssel oder die Zuordnung zwischen der Nummer und Ihrer Azure Communication Services-Ressource – erhalten Sie eine sofortige Fehlerantwort. Diese Überprüfung verhindert, dass Nachrichten falsch gesendet oder an den falschen Partner weitergeleitet werden.
Häufige Validierungsergebnisse:
| Scenario | Response |
|---|---|
Fehlende messagingConnect Felder |
400 Ungültige Anforderung mit Überprüfungsdetails |
| Nicht autorisierte Absendernummer | 401 Nicht autorisiert |
Fehlende messagingConnect für Messaging Connect-Telefonnummer |
400 Ungültige Anforderung – "MessagingConnect-Option wird nicht bereitgestellt" |
| Partnerkonflikt | 400 Ungültige Anforderung – "MessagingConnect-Option stimmt nicht mit den Nummerninformationen überein." |
Diese Fehler werden synchron in Ihrer API-Antwort zurückgegeben und auch in Azure-Diagnosen und -Protokollen angezeigt.
Fehler bei der asynchronen Übermittlung
Selbst wenn Ihre Anforderung die synchrone Überprüfung bestanden hat, übergibt Azure Communication Services sie möglicherweise immer noch nicht an den Messaging Connect-Partner. In einigen Fällen stoppt Azure Communication Services die Nachricht vor der Übergabe an den Partner, z. B. wenn der Empfänger sich zuvor vom Empfang abgemeldet hat oder ein bekannter Zustellungsblock seitens des Partners vorhanden ist. Diese Situationen führen immer noch zu einem Zustellungsbericht, sodass Sie immer über das Ergebnis der Nachricht informiert sind. Sobald eine Nachricht an den Partner übergeben wird, werden alle nachgelagerten Zustellungsfehler ( z. B. nicht erreichbare Nummer, abgelaufener Gültigkeitszeitraum oder Ablehnung auf Netzbetreiberebene ) auch asynchron über Übermittlungsberichte zurückgegeben. Sie können Übermittlungsstatus in Ihren Übermittlungsberichten aus Azure Event Grid-Ereignissen anzeigen (sofern konfiguriert).
Weitere Informationen: Übermittlungsberichte zu Azure Event Grid-Ereignissen
Tip
Um einen vollständigen Einblick in Ihren Nachrichtendatenverkehr zu gewährleisten, empfehlen wir dringend, Ereignisabonnements für Übermittlungsberichte zu konfigurieren. Mit diesem Setup können Sie den Nachrichtenstatus überwachen, Fehler beheben und in Ihre vorhandenen Telemetriesysteme integrieren. Erfahren Sie, wie Sie SMS-Ereignisse konfigurieren: Behandeln von SMS-Ereignissen
Note
Wenn Ihre Nachricht fehlschlägt, überprüfen Sie das messagingConnect Objekt auf Genauigkeit, überprüfen Sie den Zustellungsbericht, und wenden Sie sich an die Partnerdokumentation für nachgeschaltete Fehlercodes.
Important
Microsoft behält keine Anmeldeinformationen für den Zugriff auf externe Messaging Connect-Partner bei. Partner-API-Schlüssel werden nur verwendet, um jede Nachrichtenanforderung zu verarbeiten und werden nach Abschluss der Anforderung sofort verworfen. Diese Anmeldeinformationen werden nicht in irgendeiner Form gespeichert, protokolliert oder beibehalten.
Globaler Zugriff mit sicherem und kompatiblem Messaging
Messaging Connect ist für die globale Nutzung entwickelt – unabhängig davon, ob Sie aus Asien, Afrika, Südamerika oder der Europäischen Union tätig sind. In diesem Abschnitt wird erläutert, wie Daten über Regionen hinweg fließen, wie der Datenschutz verwaltet wird und wie Azure die Einhaltung der Residency-Anforderungen gewährleistet.
Nachrichtenrouting und Datenfluss
Messaging Connect trennt die Nachrichtenübermittlung (vom Partner verarbeitet) von der Verarbeitung und Observierbarkeit (verarbeitet von Azure). Funktionsweise:
- Ausgehende Nachrichten: Sie senden eine SMS mithilfe der Azure Communication Services-API und fügen Partnerweiterleitungsinformationen über
messagingConnectdas Objekt ein. Azure protokolliert die Nachricht, führt eine Überprüfung durch und leitet sie dann an den ausgewählten Messaging Connect-Partner weiter. - Eingehende Nachrichten: Der Partner empfängt die SMS und leitet sie an die Azure-Infrastruktur weiter. Von dort aus verarbeitet Azure Communication Services die Nachricht wie jede an Azure Communication Services-native Nummern gesendete Nachricht und löst Ereignisse über Event Grid aus.
Obwohl der Partner die Zustellung verarbeitet, bietet Azure Folgendes:
- Lieferbestätigungen und Beobachtbarkeit
- Standardmäßige Azure Communication Services-APIs und SDKs
- Nur vorübergehende Nachrichtenverarbeitung – es werden keine Nachrichteninhalte gespeichert.
Azure Communication Services behält SMS-Nachrichteninhalte nach Zustellung oder Ausfall nicht bei. Nachrichten und Metadaten werden nur bei Bedarf für Routing und Diagnose vorübergehend im Arbeitsspeicher verarbeitet.
Important
Microsoft behält keine Anmeldeinformationen für den Zugriff auf externe Messaging Connect-Partner bei. Partner-API-Schlüssel werden nur verwendet, um jede Nachrichtenanforderung zu verarbeiten und werden nach Abschluss der Anforderung sofort verworfen. Diese Anmeldeinformationen werden nicht in irgendeiner Form gespeichert, protokolliert oder beibehalten.
Weitere Informationen: Datenresidenz und Datenschutz für Benutzer
EU-Datengrenze (EUDB)
Azure Communication Services garantiert, dass SMS-Daten innerhalb der EUDB in Regionen der EUDB gespeichert werden. Ab heute verarbeiten und speichern wir Daten in den Regionen Niederlande, Irland oder der Schweiz und stellen sicher, dass keine unbefugte Datenübertragung außerhalb des EWR (Europäischer Wirtschaftsraum) erfolgt. Darüber hinaus verwendet Azure Communication Services erweiterte Sicherheitsmaßnahmen, einschließlich Verschlüsselung, um SMS-Daten sowohl im Ruhezustand als auch während der Übertragung zu schützen. Kunden können ihre bevorzugte Datenhaltung innerhalb der EUDB auswählen und sicherstellen, dass die Daten in den vorgesehenen EU-Regionen verbleiben.
Weitere Informationen: Datengrenze der Europäischen Union (EUDB)
Verwenden von Messaging Connect von überall aus
Messaging Connect ist für die globale Verwendung konzipiert. Nachdem Sie eine Nummer über einen Messaging Connect-Partner erworben haben, integrieren Sie sie mithilfe von Azure Communication Services-APIs in Ihre Anwendung – unabhängig davon, wo sie gehostet wird. Einige Länder erzwingen jedoch lokale Telekommunikationsregeln für die Nummernnutzung, zulässige Inhaltstypen oder Anforderungen an die Datenverkehrsherkunft. Der Messaging Connect-Partner verwaltet diese Anforderungen während des Nummernbereitstellungsprozesses. Der Partner, nicht Azure Communication Services, optimiert Übermittlungsrouten. Je nach Nummerntyp, lokalen Regeln und Partnereinrichtung können Nachrichten über die lokale oder regionale Infrastruktur weitergeleitet werden.
Opt-out-Verwaltung
Die Opt-Out- und Opt-In-Compliance ist ein wichtiger Bestandteil von SMS-Nachrichten, insbesondere in regulierten Märkten. Mit Messaging Connect wird diese Verantwortung von Ihnen (dem Kunden), dem Partner (z. B. Infobip) und Microsoft geteilt, wobei jeder eine unterschiedliche Rolle spielt.
Wichtige Verantwortlichkeiten
- Der Partner (z. B. Infobip) unterstützt die Erkennung von Opt-Out- und Opt-In-Schlüsselwörtern wie "STOP" oder "START", aber das Verhalten ist nicht automatisch.
Note
Sie müssen diese Schlüsselwörter explizit über das Portal des Partners konfigurieren. Infobip kann eine Sperrliste von deaktivierten Benutzern verwalten, aber Sie werden davon ausgehen, dass Sie Ihre eigene Liste verwalten – insbesondere, wenn Opt-Outs über andere Kanäle erfolgen (z. B. E-Mail- oder Webformulare).
- Bestätigungsmeldungen wie "Sie sind abgemeldet" werden standardmäßig nicht gesendet. Wenn gewünscht, müssen Sie sie explizit mit dem Partner konfigurieren oder in Ihrer eigenen Anwendung implementieren.
- Sie, der Kunde, sind dafür verantwortlich, sicherzustellen, dass Ihre Messaging-Erfahrung den lokalen Vorschriften entspricht, einschließlich Opt-out-Behandlung, Schlüsselwortkonfiguration und Endbenutzerzustimmungsverwaltung.
- Azure Communication Services verarbeitet keine Opt-Out-Schlüsselwörter oder sendet keine automatisierten Antworten. Microsoft behält jedoch eine Reihe vordefinierter Opt-Out-Schlüsselwörter zur Observability bei.
Funktionsweise von Azure Communication Services
Standardmäßig erkennt Azure Communication Services standardmäßig standardmäßige Opt-In-/Out-Schlüsselwörter: START und UNSTOP werden als Opt-In Trigger erkannt, während STOP, ARRET, QUIT, END, REVOKE, OPT OUT, CANCEL und UNSUBSCRIBE als Opt-out-Befehle erkannt werden. Wenn eine eingehende Nachricht genau mit einem dieser Schlüsselwörter übereinstimmt, verarbeitet Azure Communication Services automatisch die Anforderung und aktualisiert den Opt-In-Status des Benutzers in unserer Datenbank entsprechend.
Preise und Abrechnung
Messaging Connect verwendet ein zweigeteiltes Gebührenmodell, um Microsofts Plattformnutzung von den Bereitstellungs- und Leasingdiensten des Partners zu trennen.
Was Sie Microsoft bezahlen
Sie zahlen eine Plattformgebühr für die Nutzung von Azure Communication Services-APIs und der Infrastruktur für Messaging Connect. Dies umfasst Nachrichtenverarbeitung, Diagnose, Übermittlungsnachverfolgung und Beobachtbarkeit auf API-Ebene.
- Azure berechnet eine Plattformgebühr von 0,0025 USD für jede gesendete SMS-Sendeanfrage – unabhängig davon, ob die Nachricht letztendlich vom Partner übermittelt wird. Microsoft berechnet nicht die Lieferung.
- Diese Gebühr ist für Azure-Vorauszahlung (auch als Geldverpflichtung bezeichnet) und MACC (Microsoft Azure Consumption Commitment) berechtigt und wird als Teil Ihrer normalen Azure-Rechnung angezeigt.
Der Messaging Connect-Partner, nicht Microsoft, verarbeitet die Nachrichtenübermittlung.
Was Sie für den Partner bezahlen
Sie bezahlen den Messaging Connect-Partner direkt für:
- Telefonnummernleasing (monatlich oder jährlich)
- Gebühren pro Nachrichtenzustellung, die je nach Land und Route variieren
Der Partner definiert kommerzielle Bedingungen und Supportstufen. Standardmäßig erhalten Sie direkt vom Messaging Connect-Partner (z. B. Infobip) eine Rechnung für Liefer- und Nummernleasinggebühren. Diese Gebühren werden nicht auf Ihrer Azure-Rechnung angezeigt, es sei denn, Sie richten die Marketplace-Abrechnung explizit ein. Es gibt keine Abonnementeinschränkungen. Sie können Messaging Connect mit jedem beliebigen Azure-Abonnementtyp verwenden, einschließlich Pay-as-you-go und Enterprise-Vereinbarungen. Im Gegensatz zu den direkten SMS-Angeboten von Microsoft ist Messaging Connect kein Telekommunikationsdienst – es handelt sich um ein Plattformmodell für Entwickler.
| Partner | Liefergebührmodell | Preisübersicht |
|---|---|---|
| Infobip | Pay-as-you-go-Preismodell für SMS. | Infobip SMS-Tarife anzeigen |
Optional: Konsolidierte Abrechnung über Azure Marketplace
Wenn Sie die Gebühren lieber in Ihrer Azure-Rechnung konsolidieren möchten, können Sie anfordern, dass der Partner Messaging Connect über den Azure Marketplace anbietet. So funktioniert der Marketplace-Fluss:
- Sie bitten den Partner (Infobip), ein privates Angebot über Azure Marketplace zu übermitteln.
- Ihr Azure-Administrator akzeptiert das Angebot im Azure-Portal.
- Jeden Monat sendet der Partner Nutzungsdaten an Microsoft.
- Microsoft berechnet Sie im Namen des Partners (eine Pass-Through-Gebühr).
Dieses Setup vereinfacht die Beschaffung und erlaubt die Verwendung von Messaging Connect, um auf Ihre Azure-MACC-Verpflichtung angerechnet zu werden.
Weitere Informationen: Azure Marketplace
Tip
Unabhängig davon, ob Sie partner- oder Marketplace-Abrechnung wählen, bleibt die technische Erfahrung in Azure identisch.
Entwicklererfahrung
Abrufen einer Telefonnummer mit Messaging Connect
Messaging Connect führt ein neues Bereitstellungsmodell ein: Anstatt Nummern direkt von Microsoft abzurufen, erwerben Sie sie über einen vertrauenswürdigen Partner – beginnend mit Infobip – und verbinden sie dann mit Ihrer Azure Communication Services-Ressource. Mit diesem Prozess können Sie auf SMS-Nummern in über 190 Ländern zugreifen, während der Partner lokale Compliance-, Dokumentations- und Genehmigungsflüsse verarbeitet.
Tip
Wenn Sie neu bei Azure Communication Services sind, empfehlen wir, mit dem Leitfaden "Eine Kommunikationsdienste-Ressource erstellen" zu beginnen, um SMS mit Messaging Connect einzurichten und bereitzustellen.
Gehen wir schritt-für-Schritt:
Auswählen Ihres Messaging Connect-Partners
Wechseln Sie im Azure-Portal in Ihrer Kommunikationsdienste-Ressource zum Messaging Connect-Blade und wählen Sie einen Partner aus der Liste aus. Akzeptieren Sie die Bedingungen. Sie werden zur Website des Partners umgeleitet, um den Erwerb der Nummer abzuschließen.
Abrufen der Nummer im Portal des Partners
Um die Nummer zu erwerben, folgen Sie den Anweisungen des Messaging Connect-Partners. Je nach Land müssen Sie möglicherweise unterstützende Dokumente hochladen oder eine vollständige Identitätsüberprüfung durchführen. Nach der Genehmigung wird die Nummer Ihrem Partnerkonto zugewiesen.
Tip
Benötigen Sie Hilfe beim Konfigurieren der Infobip-Seite?
Folgen Sie dem offiziellen Leitfaden, um Ihre Azure Communication Services-Ressource mit Infobip zu verbinden und SMS-Nummern bereitzustellen:
SMS für Microsoft Azure Communication Services – Messaging Connect
Zurück zum Azure-Portal
Nachdem der Partner bestätigt hat, dass Ihre Nummern bereitgestellt werden, löst er die Synchronisierung mit Azure Communication Services aus. Nach Abschluss der Synchronisierung werden die Nummern automatisch in Ihrer ACS-Ressource angezeigt – bereit für die Verwendung mit der ACS SMS-API, genau wie jede zahl, die direkt über Azure Communication Services bereitgestellt wird. Auf Ihrer Seite ist kein zusätzliches Setup erforderlich.
Note
Der Messaging Connect-Partner legt den Genehmigungs- und Aktivierungszeitraum fest, der je nach Land und Nummerntyp variiert. Messaging Connect unterstützt derzeit keine sofortige Bereitstellung, und Microsoft ist nicht am Überprüfungs- oder Genehmigungsprozess beteiligt.
Wichtige Hinweise:
- Microsoft verwaltet keine Compliance- oder Überprüfungen für Messaging Connect-Nummern. Der Partner übernimmt diesen Prozess vollständig.
- Jeder Partner verfügt je nach Region und lokalen Telekommunikationsvorschriften über unterschiedliche Bereitstellungsprozesse und Service-Level-Vereinbarungen (SLAs).
- Über Messaging Connect erworbene Nummern werden im Azure-Portal mit einer Bezeichnung "Operator name" angezeigt, sodass Sie sie von verwalteten Azure Communication Services-Nummern unterscheiden können.
- Wenn Sie Nachrichten mit diesen Nummern senden möchten, vergessen Sie nicht, das
MessagingConnectObjekt in Ihre API-Anforderung einzuschließen.
SMS SDK-Lernprogramm
Note
Die folgenden API- und SDK-Versionen werden während der öffentlichen Vorschau von Messaging Connect unterstützt:
-
API-Version:
2025-05-29-preview -
JavaScript SDK:
1.2.0-beta.4 -
.NET SDK:
1.1.0-beta.3
Messaging Connect baut auf den vorhandenen SMS-Funktionen von Azure Communication Services auf. Es verwendet dieselben SMS-APIs und SDKs. Wenn Sie also bereits mit dem Senden von Nachrichten über ACS vertraut sind – insbesondere, wenn Sie die Schnellstartanleitung zum Senden von SMS abgeschlossen haben – sind Sie fast da. Stellen Sie einfach sicher, dass Sie die Send SMS with options Methode verwenden und das MessagingConnect Objekt in das Optionsfeld einschließen.
Wenn Sie mit Azure Communication Services noch nicht vertraut sind, führen Sie zunächst die Schnellstartanleitung zum Senden von SMS aus, um die Authentifizierung einzurichten, erstellen Sie Ihre SmsClientUnd verstehen Sie die grundlegende Struktur einer Sendeanfrage. Achten Sie darauf, das MessagingConnect Objekt in Ihre Anforderung aufzunehmen.
Dieses Objekt enthält:
- Der Partnername (z. B. "infobip")
- Der Partner-API-Schlüssel, den Sie nach dem Erwerb der Nummer erhalten haben
Ihr Azure Communication Services-Token autorisiert weiterhin die Anforderung an Azure, und der Partnerschlüssel teilt Azure Communication Services mit, wie die Nachricht weitergeleitet wird.
Tip
So rufen Sie Ihren Partner-API-Schlüssel von Infobip ab
Zum Senden von Nachrichten mit Messaging Connect benötigen Sie einen Infobip-API-Schlüssel:
- Melden Sie sich mit Ihren Infobip-Anmeldeinformationen beim Infobip-Portal an.
- Wählen Sie "Neuen API-Schlüssel erstellen" aus.
- Unter API-Bereiche aktivieren Sie:
sms:message:send. - Speichern Sie Ihren API-Schlüssel an einem sicheren Speicherort. Sie verwenden sie in Ihrem Azure Communication Services-API-Aufruf.
Die folgenden Beispiele zeigen, wie Sie eine Nachricht mit Messaging Connect mit C# und JavaScript senden.
C#-Beispiel
smsClient.Send(
from: "<YOUR-ACS-NUMBER>",
to: ["<RECIPIENT-NUMBER>"],
message: $"Hello from Azure Communication Services!",
options: new SmsSendOptions(true)
{
MessagingConnect = new MessagingConnectOptions("<YOUR-INFOBIP-API-KEY>", "infobip")
});
JavaScript-Beispiel
await smsClient.send(
{
from: "<YOUR-ACS-NUMBER>",
to: ["<RECIPIENT-NUMBER>"],
message: "Hello from Azure Communication Services! JS SDK is working!",
},
{
enableDeliveryReport: true, // Optional: Enable delivery reports
messagingConnect: {
apiKey: "<YOUR-INFOBIP-API-KEY>",
partner: "infobip"
}
});
Tip
Wenn Sie eine Messaging Connect-Nummer verwenden, aber das MessagingConnect-Objekt nicht einschließen, schlägt die Anforderung mit einem Überprüfungsfehler fehl. Eine Liste der möglichen Überprüfungsfehler und -antworten finden Sie in der Tabelle mit den Validierungsergebnissen.
SMS-Fehlercodes
Wenn Sie SMS-Nachrichten über Messaging Connect senden, treten möglicherweise Fehlercodes auf – entweder als Teil der synchronen Überprüfung (sofortige API-Antwort) oder in asynchronen Übermittlungsberichten. Azure Communication Services verwendet dasselbe Fehlermodell für den gesamten SMS-Datenverkehr, einschließlich Messaging Connect.
Weitere Informationen: Vollständige Liste der SMS-Fehlercodes anzeigen
Verzeichnis für Messaging Connect Partner
Messaging Connect funktioniert über direkte Integrationen mit vertrauenswürdigen globalen SMS-Anbietern. Diese Partner sorgen für die Nummernbereitstellung, Compliance, Lieferung und Kündigungserzwingung, während Azure die Entwicklungsplattform, Einblicke und Nachrichtenorchestrierung bereitstellt. In der folgenden Tabelle sind die derzeit unterstützten Partner aufgeführt. Weitere Partner werden im Laufe der Zeit hinzugefügt, um eine breitere Abdeckung und Redundanz zu bieten.
| Partner | Kurzbeschreibung | Verfügbarkeit von Ländern/Regionen | Pricing |
|---|---|---|---|
| Infobip | Globale Kommunikationsplattform mit direkten Verbindungen zu über 800 Netzbetreibern in mehr als 200 Ländern und Gebieten. Infobip unterstützt alle Absendertypen, darunter kurze Codes, lange Codes (virtuelle lange Codes oder VLNs) und alphanumerische Codes (Alphas). Weitere Informationen | Einweg-Messaging ist für nahezu alle Netzwerke in allen Ländern und Regionen verfügbar. Zwei-Wege-Nachrichten werden in über 100 Ländern unterstützt. Länderabdeckung | Infobip bietet ein flexibles Pay-as-You-Go-Preismodell für SMS. Preise ansehen. Für benutzerdefinierte Preise wenden Sie sich an den Vertrieb. |
Important
Messaging Connect-Partner werden basierend auf globaler Reichweite, behördlicher Expertise, Zuverlässigkeit und starker Integration in das Ökosystem von Microsoft ausgewählt.