Servizi di comunicazione di Azure - Eventi di messaggistica avanzata
Importante
La funzionalità descritta in questo articolo è attualmente disponibile in anteprima pubblica. Questa versione di anteprima viene fornita senza un contratto di servizio e non è consigliabile per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.
Questo articolo fornisce le proprietà e lo schema per gli eventi di messaggistica avanzati dei servizi di comunicazione. Per un'introduzione agli schemi di eventi, vedere Schema di eventi di Griglia di eventi di Azure.
Tipi di evento
Servizi di comunicazione di Azure genera i tipi di evento di messaggistica avanzata seguenti:
Tipo di evento | Descrizione |
---|---|
Microsoft.Communication.AdvancedMessageReceived | Pubblicato quando il servizio di comunicazione riceve un messaggio WhatsApp. |
Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated | Pubblicato quando WhatsApp invia lo stato della notifica del messaggio come inviato/letto/non riuscito. |
Risposte di eventi
Quando viene attivato un evento, il servizio Griglia di eventi invia i dati relativi all'evento agli 'endpoint di sottoscrizione.
Questa sezione contiene un esempio che illustra l'aspetto dei dati per ogni evento.
Evento Microsoft.Communication.AdvancedMessageReceived
[{
"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"
}]
Evento Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated
[{
"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"
}]
Nota
I valori possibili per Status
sono Sent
, Read
Delivered
e Failed
.
Avvio rapido
Per una guida introduttiva che illustra come sottoscrivere eventi di messaggistica avanzata tramite web hook, vedere Avvio rapido: Gestire eventi di messaggistica avanzata.
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per