Freigeben über

SMS-Ereignisse für Azure Communication Services (Vorschau)

Connector zum Empfangen von SMS-Nachrichten aus den Azure Communication Services-Ressourcen in Ihrem Abonnement.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Microsoft
URL https://azure.microsoft.com/services/communication-services
Email acssolutions@microsoft.com
Connectormetadaten
Herausgeber Microsoft
Webseite https://azure.microsoft.com/services/communication-services
Datenschutzrichtlinie https://privacy.microsoft.com
Kategorien Communication

Der Connector für SMS-Ereignisse von Azure Communication Services ermöglicht die Verarbeitung von SMS-Nachrichten, die an Azure Communication Services-Telefonnummern gesendet werden.

Voraussetzungen

Sie benötigen Folgendes, um fortzufahren:

  • Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature
  • Ein Azure-Abonnement mit dem registrierten Event Grid-Ressourcenanbieter
  • Eine Azure Communication Services-Ressource
  • Eine Azure Communication Services-Telefonnummer, die für den Empfang von SMS-Nachrichten eingerichtet ist

So erhalten Sie Anmeldeinformationen

  1. Erstellen Sie eine Azure Communication Services-Ressource – Schnellstartdokument.

  2. Kaufen Sie eine Telefonnummer in dieser Ressource, wobei die Funktion "SMS senden und empfangen" ausgewählt ist.

  3. Registrieren Sie einen Event Grid-Ressourcenanbieter für das Abonnement, in dem die Azure Communication Services-Ressource enthalten ist.

  4. Erstellen Sie einen Microsoft Entra ID-Benutzer oder Dienstprinzipal, der für die Connectorverbindung verwendet werden kann.

    • Option 1: Verbindung mit dem Microsoft Entra ID-Konto – Hinzufügen eines neuen Benutzers
    • Option 2: Verbindung mithilfe der Dienstprinzipalauthentifizierung (Microsoft Entra ID-Anwendung) – Sie können auch einen Dienstprinzipal einrichten, eine registrierte Anwendung über die Azure CLI oder über das Azure-Portal erstellen. Die Anmeldeinformationen können dann zur Authentifizierung verwendet werden.

  5. Stellen Sie sicher, dass dem Benutzer oder Dienstprinzipal der Microsoft Entra-ID die folgenden Berechtigungen zugewiesen sind:

    • Microsoft.Communication/CommunicationServices/Read

    • Microsoft.Resources/subscriptions/resourceGroups/read

    • Microsoft.EventGrid/eventSubscriptions/write

    • Microsoft.EventGrid/eventSubscriptions/read

    • Microsoft.EventGrid/eventSubscriptions/delete

      Dies kann durch Erstellen einer benutzerdefinierten Rolle oder Zuweisen des Benutzers zu den folgenden integrierten Rollen erreicht werden:

    • Reader – Auf Ressourcenebene von Azure Communication Services

    • EventGrid EventSubscription-Mitwirkender – Auf Ressourcengruppenebene

Erste Schritte mit Ihrem Connector

Dieser Connector enthält einen einzelnen Trigger , wenn eine SMS-Nachricht empfangen wird. Standardmäßig wird sie ausgeführt, wenn eine Nachricht an eine Ihrer gekauften Telefonnummern gesendet wird, aber sie kann auch so konfiguriert werden, dass sie nur basierend auf den Telefonnummern "An" und "Von" der SMS-Nachricht ausgeführt wird.

Bekannte Probleme und Einschränkungen

  • Trigger vorübergehend deaktiviert beim Update, wenn "Ereignisabonnementname" festgelegt ist – Wenn beim Erstellen des Triggers ein Wert dem Feld "Ereignisabonnementname" zugewiesen wurde, kann es bis zu 10 Minuten dauern, bis alle Aktualisierungen des Triggers (z. B. Hinzufügen einer "An"-Telefonnummer) angewendet werden. Während dieser Zeit funktioniert der Trigger nicht.
  • Ereignisabonnement nicht gelöscht, wenn die Verbindung vor Flow gelöscht wurde.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:
Microsoft Entra ID-integriert Verwenden Sie die Microsoft Entra-ID, um auf ACS-Ereignisressourcen zuzugreifen. Alle Regionen Nicht teilbar
Dienstprinzipalauthentifizierung (Microsoft Entra ID-Anwendung) Verwenden Sie die Microsoft Entra ID-Authentifizierung, um auf Ihre Azure Communication Service-Ressource zuzugreifen. Alle Regionen Nicht teilbar
Standard [VERALTET] Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Alle Regionen Nicht teilbar

Microsoft Entra ID integriert

Authentifizierungs-ID: aadOauth

Anwendbar: Alle Regionen

Verwenden Sie die Microsoft Entra-ID, um auf ACS-Ereignisressourcen zuzugreifen.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Dienstprinzipalauthentifizierung (Microsoft Entra ID-Anwendung)

Auth-ID: aadOauthClientCredentials

Anwendbar: Alle Regionen

Verwenden Sie die Microsoft Entra ID-Authentifizierung, um auf Ihre Azure Communication Service-Ressource zuzugreifen.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
Mieter-ID Schnur Mandanten-ID Ihrer Microsoft Entra ID-Anwendung. Richtig
Kunden-ID Schnur Client-ID (oder Anwendungs-ID) Ihrer Microsoft Entra-ID-Anwendung. Richtig
Geheimer Clientschlüssel securestring Geheimer Clientschlüssel Ihrer Microsoft Entra ID-Anwendung. Richtig

Standard [VERALTET]

Anwendbar: Alle Regionen

Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Auslöser

Wenn eine SMS-Nachricht empfangen wird

Wenn eine SMS-Nachricht von Azure Communication Services empfangen wird.

Wenn eine SMS-Nachricht empfangen wird

Vorgangs-ID:
CreateSMSReceivedEventSubscription

Wenn eine SMS-Nachricht von Azure Communication Services empfangen wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Subscription
 subscriptionId True string

Der eindeutige Bezeichner für das Microsoft Azure-Abonnement. Die Abonnement-ID ist Teil der ID für jede Azure-Ressource.
Ressourcengruppenname
 resourceGroupName True string

Der Name der Ressourcengruppe, die Ihre Ressource enthält.
Ressourcenname
 resourceName True string

Der Name der Kommunikationsdiensteressource.
Nach Telefonnummer filtern
 toPhoneNumbers array of string
Filtern nach Telefonnummer
 fromPhoneNumbers array of string
Name des Ereignisabonnements
 eventSubscriptionName string

Der Name für das neue Ereignisabonnement.
includedEventTypes
 includedEventTypes True array of string

Gibt zurück

Name Pfad Typ Beschreibung
array of object
Bis
 data.to string
Von
 data.from string
Nachricht
 data.message string
Empfangener Zeitstempel
 data.receivedTimestamp string
Nachrichten-ID
 data.messageId string