Службы коммуникации Azure: события телефонии и SMS

Статья
03/25/2023

В этой статье рассматриваются свойства и схема для событий телефонии и SMS Служб коммуникации. Общие сведения о схемах событий см. в статье Схема событий службы "Сетка событий Azure".

Типы событий

Службы коммуникации Azure создают события телефонии и SMS следующих типов:

Тип события	Описание
Microsoft.Communication.SMSReceived	Публикуется при получении SMS-сообщения на номер телефона, связанного со Службой коммуникации.
Microsoft.Communication.SMSDeliveryReportReceived	Публикуется при получении отчета о доставке для SMS-сообщений, отправленных Службой коммуникации.

Ответы на события

При активации события служба Сетки событий отправляет данные о нем на подписанные конечные точки.

В этом разделе приведен пример того, как будут выглядеть данные для каждого события.

Событие 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"
}]

Примечание

Возможные значения для DeliveryStatus: Delivered и Failed.

Событие 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"
}]

Дальнейшие действия

См. следующее руководство. Краткое руководство. Обработка событий SMS и отчетов о доставке.

Поделиться через