Azure Communication Services – Telefoni- och SMS-händelser

Artikel
03/25/2023

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

Händelsetyper

Azure Communication Services genererar följande typer av telefoni- och SMS-händelser:

Händelsetyp	Beskrivning
Microsoft.Communication.SMSReceived	Publiceras när ett SMS tas emot av ett telefonnummer som är kopplat till kommunikationstjänsten.
Microsoft.Communication.SMSDeliveryReportReceived	Publiceras 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"
}]

Anteckning

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/50ad1522-5c2c-4d9a-a6c8-67c11ecb75b8/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ästa steg

Se följande självstudie: Snabbstart: Hantera händelser för SMS och leveransrapporter.

Dela via