Azure Communication Services - Événements de téléphonie et SMS

Article
03/25/2023

Cet article décrit les propriétés et le schéma des événements de téléphonie et SMS. Pour une présentation des schémas d’événements, consultez Schéma d’événements Azure Event Grid.

Types d’événements

Azure Communication Services émet les types d’événements de téléphonie et SMS suivants :

Type d'événement	Description
Microsoft.Communication.SMSReceived	Publié lorsqu’un SMS est reçu par un numéro de téléphone associé au service de communication.
Microsoft.Communication.SMSDeliveryReportReceived	Publié lorsqu’un rapport de remise est reçu pour un SMS envoyé par le service de communication.

Réponses aux événements

Quand un événement est déclenché, le service Event Grid envoie les données relatives à cet événement aux points de terminaison d’abonnement.

Cette section contient un exemple de ce à quoi ces données ressembleraient pour chaque événement.

Événement 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"
}]

Notes

Les valeurs possibles pour DeliveryStatus sont Delivered et Failed.

Événement 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"
}]

Étapes suivantes

Consultez le tutoriel suivant : Démarrage rapide : Gérer les événements de sms et de rapport de remise.

Partager via