Servizi di comunicazione di Azure - Eventi di messaggistica avanzata
Articolo 02/25/2025
6 contributori
Commenti e suggerimenti
In questo articolo
Questo articolo fornisce le proprietà e lo schema per gli eventi di messaggistica avanzata di 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:
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 dell'aspetto dei dati per ogni evento.
Microsoft.Communication.AdvancedMessageReceived event
Pubblicato quando la messaggistica avanzata di Servizi di comunicazione riceve un messaggio.
Scenario di esempio: un utente WhatsApp invia un messaggio WhatsApp a un numero WhatsApp Business connesso a un canale di messaggistica avanzata attivo in una risorsa di Servizi di comunicazione. Di conseguenza, viene pubblicato un oggetto Microsoft.Communication.AdvancedMessageReceived con il contenuto del messaggio WhatsApp dell'utente.
Elenco attributi
Dettagli per gli attributi specifici degli eventi Microsoft.Communication.AdvancedMessageReceived.
Attributo
Type
Nullable
Descrizione
channelType
string❌
Tipo di canale del canale su cui è stato inviato il messaggio. Ad esempio: "whatsapp".
messageId
string❌
ID messaggio dell'evento di ricezione del messaggio come GUID.
messageType
string❌
Tipo di messaggio dell'evento di ricezione del messaggio. Ad esempio: "interactive", "sticker", "reaction".
da
string❌
ID del mittente che ha inviato il messaggio.
to
string❌
ID del canale che ha ricevuto il messaggio, formattato come GUID.
receivedTimestamp
DateTimeOffset❌
Timestamp quando viene ricevuto il messaggio.
content
string✔️
Contenuto del testo del messaggio.
media
MediaContent✔️
Contiene informazioni dettagliate sui supporti ricevuti .
context
MessageContext✔️
Contiene informazioni dettagliate sul contesto del messaggio di risposta nel caso in cui l'utente risponda al messaggio aziendale.
pulsante
ButtonContent✔️
Contiene i dettagli dell'utente del contenuto del pulsante di risposta selezionato per il messaggio modello.
interattivo
InteractiveContent✔️
Contiene informazioni dettagliate sulla risposta interattiva dei messaggi, ad esempio buttonReply o listReply
reazione
ReactionContent✔️
Contiene informazioni dettagliate sulla reazione ricevuta
MediaContent
Attributo
Type
Nullable
Descrizione
mimeType
string❌
Tipo MIME del file multimediale. Utilizzato per determinare il tipo di file corretto per i download di file multimediali.
ID
string❌
ID del file multimediale. Usato per recuperare i file multimediali per il download, formattati come GUID.
fileName
string✔️
Nome file del file multimediale sottostante come specificato al momento del caricamento.
caption
string✔️
Testo della didascalia per l'oggetto multimediale, se supportato e fornito.
animato
string✔️
Impostare su true se l'adesivo è animato; false in caso contrario.
MessageContext
Attributo
Type
Nullable
Descrizione
da
string✔️
ID WhatsApp per il cliente che ha risposto a un messaggio in ingresso.
ID
string✔️
ID del messaggio inviato per una risposta in ingresso.
ButtonContent
Attributo
Type
Nullable
Descrizione
Testo
string✔️
Testo del pulsante.
payload
string✔️
Payload, configurato dall'azienda, del pulsante selezionato dall'utente.
InteractiveContent
InteractiveReplyType
valore
Descrizione
buttonReply
Il contenuto interattivo è un pulsante.
listReply
Il contenuto interattivo è un elenco.
Sconosciuto
Il contenuto interattivo è sconosciuto.
InteractiveButtonReplyContent
Attributo
Type
Nullable
Descrizione
ID
string✔️
ID del pulsante.
title
string✔️
Titolo del pulsante.
InteractiveListReplyContent
Attributo
Type
Nullable
Descrizione
ID
string✔️
ID della voce di elenco selezionata.
title
string✔️
Titolo della voce di elenco selezionata.
description
string✔️
Descrizione della riga selezionata.
ReazioneContent
Attributo
Type
Nullable
Descrizione
messageId
string❌
ID messaggio a cui l'utente risponde.
emoji
string✔️
Stringa che rappresenta la sequenza di escape Unicode dell'emoji.
Esempi
Messaggio di testo ricevuto
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
"subject": "advancedMessage/sender/{sender@id}/recipient/11111111-1111-1111-1111-111111111111",
"data": {
"content": "Hello",
"channelType": "whatsapp",
"messageType": "text",
"from": "{sender@id}",
"to": "{channel-id}",
"receivedTimestamp": "2023-07-06T18:30:19+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2023-07-06T18:30:22.1921716Z"
}]
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
"subject": "advancedMessage/sender/{sender@id}/recipient/11111111-1111-1111-1111-111111111111",
"data": {
"channelType": "whatsapp",
"messageType": "image",
"media": {
"mimeType": "image/jpeg",
"id": "00000000-0000-0000-0000-000000000000",
"caption": "This is a media caption"
},
"from": "{sender@id}",
"to": "{channel-id}",
"receivedTimestamp": "2023-07-06T18:30:19+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2023-07-06T18:30:22.1921716Z"
}]
{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/acs-cpm-ppe-resources/providers/microsoft.communication/communicationservices/acscpm-whatsup-pperesource",
"subject": "advancedMessage/sender/14254360097/recipient/75476a19-a68d-4e10-806c-3680f099e069",
"data": {
"channelType": "whatsapp",
"messageType": "document",
"media": {
"mimeType": "application/pdf",
"id": "00000000-0000-0000-0000-000000000000",
"fileName": "UTSAV Mela 2024 India's Independence Day Kids Out and About Seattle.pdf"
},
"from": "14254360097",
"to": "{channel-id}",
"receivedTimestamp": "2024-12-24T06:41:56+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2024-12-24T06:41:59.1218953Z"
}
Elencare il messaggio di risposta ricevuto con InteractiveListReplyContent
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
"subject": "advancedMessage/sender/{sender@id}/recipient/00000000-0000-0000-0000-000000000000",
"data": {
"channelType": "whatsapp",
"messageType": "interactive",
"context": {
"from": "{receiverphonenumber@id}",
"id": "{reply-message-id}"
},
"interactive": {
"type": "listReply",
"listReply": {
"id": "priority_mail",
"title": "Priority Mail",
"description": "1–3 Days"
}
},
"from": "{sender@id}",
"to": "{channel-id}",
"receivedTimestamp": "2024-12-04T23:53:28+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2024-12-04T23:53:29.3079089Z"
}]
Messaggio del pulsante di risposta ricevuto con InteractiveButtonReplyContent
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
"subject": "advancedMessage/sender/{sender@id}/recipient/00000000-0000-0000-0000-000000000000",
"data": {
"channelType": "whatsapp",
"messageType": "interactive",
"context": {
"from": "{receiverphonenumber@id}",
"id": "{reply-message-id}"
},
"interactive": {
"type": "buttonReply",
"buttonReply": {
"id": "agree",
"title": "Agree"
}
},
"from": "{sender@id}",
"to": "{channel-id}",
"receivedTimestamp": "2024-12-04T23:57:04+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2024-12-04T23:57:04.9459858Z"
}]
Messaggio adesivo di risposta ricevuto
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
"subject": "advancedMessage/sender/{sender@id}/recipient/00000000-0000-0000-0000-000000000000",
"data": {
"channelType": "whatsapp",
"messageType": "sticker",
"media": {
"mimeType": "image/webp",
"id": "00000000-0000-0000-0000-000000000000",
"animated": false
},
"from": "{sender@id}",
"to": "{channel-id}",
"receivedTimestamp": "2024-12-04T23:57:04+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2024-12-04T23:57:04.9459858Z"
}]
Messaggio di risposta ricevuto
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
"subject": "advancedMessage/sender/{sender@id}/recipient/00000000-0000-0000-0000-000000000000",
"data": {
"channelType": "whatsapp",
"messageType": "reaction",
"reaction": {
"messageId": "{reply-message-id}",
"emoji": "👍"
},
"from": "{sender@id}",
"to": "{channel-id}",
"receivedTimestamp": "2024-12-04T23:57:04+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2024-12-04T23:57:04.9459858Z"
}]
Messaggio ButtonContent ricevuto
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
"subject": "advancedMessage/sender/{sender@id}/recipient/00000000-0000-0000-0000-000000000000",
"data": {
"channelType": "whatsapp",
"messageType": "button",
"context": {
"from": "{receiverphonenumber@id}",
"id": "{reply-message-id}"
},
"button": {
"text": "Yes",
"payload": "Kat said yes"
},
"from": "{sender@id}",
"to": "{channel-id}",
"receivedTimestamp": "2024-12-20T04:03:22+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2024-12-20T04:03:22.7978135Z"
}]
Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated event
Pubblicato quando la messaggistica avanzata di Servizi di comunicazione riceve un aggiornamento dello stato per una notifica di messaggio inviata in precedenza.
Scenario di esempio: Contoso usa un canale di messaggistica avanzata attivo connesso a un account WhatsApp Business per inviare un messaggio WhatsApp a un utente WhatsApp. WhatsApp risponde quindi al canale di messaggistica avanzata di Contoso con lo stato del messaggio inviato in precedenza. Di conseguenza, viene pubblicato un evento Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated contenente lo stato del messaggio.
Elenco attributi
Dettagli per gli attributi specifici degli eventi Microsoft.Communication.AdvancedMessageReceived.
Attributo
Type
Nullable
Descrizione
channelType
string❌
Tipo di canale del canale su cui è stato inviato il messaggio.
da
string❌
ID del canale che ha inviato il messaggio, formattato come GUID.
to
string❌
ID del destinatario a cui è stato inviato il messaggio.
receivedTimestamp
DateTimeOffset❌
Timestamp del messaggio.
messageId
string✔️
ID del messaggio, formattato come GUID.
stato
string✔️
Stato del messaggio. I valori possibili comprendono Sent, Delivered, Read, e Failed. Per altre informazioni, vedere Stato .
Errore
ChannelEventError✔️
Contiene i dettagli di un errore.
ChannelEventError
Attributo
Type
Nullable
Descrizione
channelCode
string✔️
Codice di errore ricevuto su questo canale.
channelMessage
string✔️
Messaggio di errore ricevuto su questo canale.
Status
valore
Descrizione
Inviato
Il servizio di messaggistica ha inviato il messaggio al destinatario
Consegnati
Il destinatario del messaggio ha ricevuto il messaggio
Lettura
Il destinatario del messaggio legge il messaggio
Non riuscito
L'invio del messaggio non è riuscito
Esempi
Aggiornamento per il recapito del messaggio
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
"subject": "advancedMessage/22222222-2222-2222-2222-222222222222/status/Sent",
"data": {
"messageId": "22222222-2222-2222-2222-222222222222",
"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"
}]
Aggiornamento per il recapito del messaggio con errore
[{
"id": "00000000-0000-0000-0000-000000000000",
"topic": "/subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name}/providers/microsoft.communication/communicationservices/acsxplatmsg-test",
"subject": "advancedMessage/22222222-2222-2222-2222-222222222222/status/Failed",
"data": {
"messageId": "22222222-2222-2222-2222-222222222222",
"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"
}]
Evento Microsoft.Communication.AdvancedMessageAnalysisCompleted(Preview)
Pubblicato quando il servizio di comunicazione completa un'analisi di intelligenza artificiale con un messaggio del cliente.
Scenario di esempio: un utente WhatsApp invia un messaggio a un numero whatsApp Business connesso a un canale di messaggistica avanzata attivo in una risorsa di Servizi di comunicazione che ha optato per la funzionalità di analisi dei messaggi. Di conseguenza, il sistema pubblica un con Microsoft.Communication.AdvancedMessageAnalysisCompleted l'analisi del messaggio WhatsApp dell'utente.
Elenco attributi
Dettagli per gli attributi specifici degli eventi Microsoft.Communication.AdvancedMessageAnalysisCompleted.
Attributo
Type
Nullable
Descrizione
channelType
string✔️
Tipo di canale del canale su cui è stato inviato il messaggio.
da
string✔️
ID del canale che ha inviato il messaggio, formattato come GUID.
to
string✔️
ID del destinatario a cui è stato inviato il messaggio.
receivedTimestamp
DateTimeOffset✔️
Timestamp del messaggio.
originalMessage
string✔️
Messaggio utente originale.
intentAnalysis
string✔️
Analisi delle finalità del messaggio utente ricevuto.
languageDetection
LanguageDetection✔️
Contiene il rilevamento della lingua del messaggio utente ricevuto.
extractedKeyPhrases
List<string>✔️
Contiene le frasi chiave del messaggio utente ricevuto.
LanguageDetection
Attributo
Type
Nullable
Descrizione
lingua
string✔️
È stata rilevata la lingua.
confidenceScore
float✔️
Punteggio di attendibilità della lingua rilevata.
Traduzione
string✔️
Traduzione del messaggio.
Esempi
Analisi dei messaggi completata
[{
"id": "df1c2d92-6155-4ad7-a865-cb8497106c52",
"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": {
"originalMessage": "Hello, could u help me order some flowers for Mother’s Day?",
"channelType": "whatsapp",
"languageDetection": {
"language": "English",
"confidenceScore": 0.99
},
"intentAnalysis": "Order request: The customer is contacting customer service to request assistance with ordering flowers for Mother's Day.",
"extractedKeyPhrases": [
"order",
"flowers",
"Mother's Day"
],
"from": "{sender@id}",
"to": "00000000-0000-0000-0000-000000000000",
"receivedTimestamp": "2024-07-05T19:10:35.28+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageAnalysisCompleted",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2024-07-05T19:10:35.2806524Z"
}]
Guida introduttiva
Per una guida introduttiva che illustra come abbonarsi a eventi di messaggistica avanzata tramite web hook, vedere Avvio rapido: Gestire eventi di messaggistica avanzata .