Azure Communication Services – Ereignisse für Telefonie und SMS

Artikel
03/25/2023

In diesem Artikel werden die Eigenschaften und das Schema für Ereignisse für Telefonie und SMS der Kommunikationsdienste beschrieben. Eine Einführung in Ereignisschemas finden Sie unter Azure Event Grid-Ereignisschema.

Ereignistypen

Von Azure Communication Services werden die folgenden Ereignistypen für Telefonie und SMS ausgegeben:

Ereignistyp	Beschreibung
Microsoft.Communication.SMSReceived	Wird veröffentlicht, wenn eine SMS von einer Telefonnummer eingeht, die dem Kommunikationsdienst zugeordnet ist.
Microsoft.Communication.SMSDeliveryReportReceived	Wird veröffentlicht, wenn ein Zustellbericht für eine von der Communication Services-Instanz gesendete SMS empfangen wird.

Ereignisantworten

Wenn ein Ereignis ausgelöst wird, sendet der Event Grid-Dienst Daten zum Ereignis an die Endpunkte, die über ein entsprechendes Abonnement verfügen.

In diesem Abschnitt wird anhand eines Beispiels gezeigt, wie diese Daten für jedes Ereignis aussehen.

Ereignis „Microsoft.Communication.SMSDeliveryReportReceived“

[{
  "id": "Outgoing_202009180022138813a09b-0cbf-4304-9b03-1546683bb910",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
  "subject": "/phonenumber/15555555555",
  "data": {
    "MessageId": "Outgoing_202009180022138813a09b-0cbf-4304-9b03-1546683bb910",
    "From": "15555555555",
    "To": "+15555555555",
    "DeliveryStatus": "Delivered",
    "DeliveryStatusDetails": "No error.",
    "ReceivedTimestamp": "2020-09-18T00:22:20.2855749Z",
    "DeliveryAttempts": [
      {
        "Timestamp": "2020-09-18T00:22:14.9315918Z",
        "SegmentsSucceeded": 1,
        "SegmentsFailed": 0
      }
    ],
    "Tag": "Optional customer-tag set in the original message"
  },
  "eventType": "Microsoft.Communication.SMSDeliveryReportReceived",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "eventTime": "2020-09-18T00:22:20Z"
}]

Hinweis

Mögliche Werte für DeliveryStatus sind Delivered und Failed.

Ereignis „Microsoft.Communication.SMSReceived“

[{
  "id": "Incoming_20200918002745d29ebbea-3341-4466-9690-0a03af35228e",
  "topic": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/acse2e/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
  "subject": "/phonenumber/15555555555",
  "data": {
    "MessageId": "Incoming_20200918002745d29ebbea-3341-4466-9690-0a03af35228e",
    "From": "15555555555",
    "To": "15555555555",
    "Message": "Great to connect with Azure Communication Services events",
    "ReceivedTimestamp": "2020-09-18T00:27:45.32Z"
  },
  "eventType": "Microsoft.Communication.SMSReceived",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "eventTime": "2020-09-18T00:27:47Z"
}]

Nächste Schritte

Weitere Informationen finden Sie im folgenden Tutorial:Schnellstart: Verarbeiten von SMS- und Übermittlungsberichtsereignissen.

Freigeben über