Azure Communication Services – SMS-händelser

Artikel
01/29/2025

Den här artikeln innehåller egenskaper och schema för SMS-händelser för kommunikationstjänster. En introduktion till händelsescheman finns i Händelseschema för Azure Event Grid.

Händelsetyper

Azure Communication Services genererar följande SMS-händelsetyper:

Händelsetyp	beskrivning
Microsoft.Communication.SMSReceived	Publicerad när ett SMS tas emot av ett telefonnummer som är kopplat till kommunikationstjänsten.
Microsoft.Communication.SMSDeliveryReportReceived	Publicerad när en leveransrapport tas emot för ett SMS som skickas av kommunikationstjänsten.

Händelsesvar

När en händelse utlöses skickar Event Grid-tjänsten data om händelsen till prenumererande slutpunkter.

Det här avsnittet innehåller ett exempel på hur dessa data skulle se ut för varje händelse.

Microsoft.Communication.SMSDeliveryReportReceived-händelse

[{
  "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"
}]

Kommentar

Möjliga värden för DeliveryStatus är Delivered och Failed.

Microsoft.Communication.SMSReceived-händelse

[{
  "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",
    "segmentCount": 1
  },
  "eventType": "Microsoft.Communication.SMSReceived",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "eventTime": "2020-09-18T00:27:47Z"
}]

Nästa steg

Se följande självstudie:Snabbstart: Hantera sms- och leveransrapporthändelser.

Dela via