Azure Communication Services – Avancerade meddelandehändelser
Den här artikeln innehåller egenskaper och schema för avancerade meddelandehä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 händelsetyper för Advanced Messaging:
Händelsetyp | beskrivning |
---|---|
Microsoft.Communication.AdvancedMessageReceived | Publicerad när Kommunikationstjänsten tar emot ett WhatsApp-meddelande. |
Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated | Publicerad när WhatsApp skickar status för meddelandemeddelandet som skickat/läst/misslyckat. |
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.AdvancedMessageReceived-händelse
[{
"id": "fdc64eca-390d-4974-abd6-1a13ccbe3160",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/acsxplatmsg-test",
"subject": "advancedMessage/sender/{sender@id}/recipient/00000000-0000-0000-0000-000000000000",
"data": {
"content": "Hello",
"channelType": "whatsapp",
"from": "{sender@id}",
"to": "00000000-0000-0000-0000-000000000000",
"receivedTimestamp": "2023-07-06T18:30:19+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2023-07-06T18:30:22.1921716Z"
}]
Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated-händelse
[{
"id": "48cd6446-01dd-479f-939c-171c86c46700",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/acsxplatmsg-test",
"subject": "advancedMessage/00000000-0000-0000-0000-000000000000/status/Failed",
"data": {
"messageId": "00000000-0000-0000-0000-000000000000",
"status": "Sent",
"channelType": "whatsapp",
"from": "{sender@id}",
"to": "{receiver@id}",
"receivedTimestamp": "2023-07-06T18:42:28+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2023-07-06T18:42:28.8454662Z"
}]
[{
"id": "48cd6446-01dd-479f-939c-171c86c46700",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/acsxplatmsg-test",
"subject": "advancedMessage/00000000-0000-0000-0000-000000000000/status/Failed",
"data": {
"messageId": "00000000-0000-0000-0000-000000000000",
"status": "Failed",
"channelType": "whatsapp",
"from": "{sender@id}",
"to": "{receiver@id}",
"receivedTimestamp": "2023-07-06T18:42:28+00:00",
"error": {
"channelCode": "131026",
"channelMessage": "Message Undeliverable."
}
},
"eventType": "Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2023-07-06T18:42:28.8454662Z"
}]
Kommentar
Möjliga värden för Status
är Sent
, Delivered
Read
och Failed
.
Snabbstart
En snabbstart som visar hur du prenumererar på avancerade meddelandehändelser med hjälp av webbkrokar finns i Snabbstart: Hantera avancerade meddelandehändelser.