Azure Communication Services — zaawansowane zdarzenia obsługi komunikatów
Artykuł
Ten artykuł zawiera właściwości i schemat zdarzeń zaawansowanej obsługi komunikatów usług komunikacyjnych. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat zdarzeń usługi Azure Event Grid.
Typy zdarzeń
Usługi Azure Communication Services emitują następujące zaawansowane typy zdarzeń obsługi komunikatów:
Opublikowane, gdy usługa Communication Services Advanced Messaging odbiera komunikat.
Przykładowy scenariusz: Użytkownik WhatsApp wysyła wiadomość WhatsApp do numeru WhatsApp Business, który jest połączony z aktywnym kanałem Advanced Messaging w zasobie usług komunikacyjnych. W rezultacie Microsoft.Communication.AdvancedMessageReceived opublikowano zawartość wiadomości WhatsApp użytkownika.
Lista atrybutów
Szczegóły atrybutów specyficznych dla Microsoft.Communication.AdvancedMessageReceived zdarzeń.
Atrybut
Typ
Możliwa wartość Null
opis
channelType
string
❌
Typ kanału, na który wysłano wiadomość. Na przykład: "whatsapp".
messageId
string
❌
Identyfikator komunikatu odbiera zdarzenie jako identyfikator GUID.
messageType
string
❌
Typ komunikatu zdarzenia odbierania komunikatu. Na przykład: "interactive", , "reaction""sticker".
z
string
❌
Identyfikator nadawcy, który wysłał wiadomość.
na wartość
string
❌
Identyfikator kanału, który odebrał komunikat, sformatowany jako identyfikator GUID.
Opublikowane, gdy zaawansowane komunikaty usług komunikacyjnych odbierają aktualizację stanu dla wcześniej wysłanego powiadomienia o wiadomościach.
Przykładowy scenariusz: Firma Contoso używa aktywnego kanału Advanced Messaging połączonego z kontem WhatsApp Business, aby wysłać wiadomość WhatsApp do użytkownika WhatsApp. Następnie WhatsApp odpowiada na kanał Advanced Messaging firmy Contoso ze stanem wcześniej wysłanej wiadomości. W związku z tym Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated zdarzenie zawierające stan komunikatu jest publikowane.
Lista atrybutów
Szczegóły atrybutów specyficznych dla Microsoft.Communication.AdvancedMessageReceived zdarzeń.
Atrybut
Typ
Możliwa wartość Null
opis
channelType
string
❌
Typ kanału, na który wysłano wiadomość.
z
string
❌
Identyfikator kanału, który wysłał komunikat, sformatowany jako identyfikator GUID.
na wartość
string
❌
Identyfikator adresata, do którego wysłano wiadomość.
receivedTimestamp
DateTimeOffset
❌
Sygnatura czasowa wiadomości.
messageId
string
✔️
Identyfikator komunikatu sformatowany jako identyfikator GUID.
status
string
✔️
Stan wiadomości. Możliwe wartości to Sent, , ReadDeliveredi Failed. Aby uzyskać więcej informacji, zobacz Stan.
Opublikowane po zakończeniu analizy sztucznej inteligencji za pomocą komunikatu klienta.
Przykładowy scenariusz: użytkownik WhatsApp wysyła wiadomość do numeru WhatsApp Business połączonego z aktywnym kanałem Advanced Messaging w zasobie usług komunikacyjnych, który zdecydował się na funkcję Analizy wiadomości. W rezultacie system publikuje Microsoft.Communication.AdvancedMessageAnalysisCompleted element z analizą wiadomości WhatsApp użytkownika.
Lista atrybutów
Szczegóły atrybutów specyficznych dla Microsoft.Communication.AdvancedMessageAnalysisCompleted zdarzeń.
Atrybut
Typ
Możliwa wartość Null
opis
channelType
string
✔️
Typ kanału, na który wysłano wiadomość.
z
string
✔️
Identyfikator kanału, który wysłał komunikat, sformatowany jako identyfikator GUID.
na wartość
string
✔️
Identyfikator adresata, do którego wysłano wiadomość.
Zawiera wykrywanie języka odebranego komunikatu użytkownika.
extractedKeyPhrases
List<string>
✔️
Zawiera kluczowe frazy odebranego komunikatu użytkownika.
LanguageDetection
Atrybut
Typ
Możliwa wartość Null
opis
język
string
✔️
Wykryto język.
confidenceScore
float
✔️
Wykryto współczynnik ufności języka.
tłumaczenie
string
✔️
Tłumaczenie wiadomości.
Przykłady
Ukończono analizę komunikatów
[{
"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"
}]
Szybki start
Aby zapoznać się z przewodnikiem Szybki start pokazującym, jak subskrybować zdarzenia zaawansowane obsługi komunikatów przy użyciu elementów webhook, zobacz Szybki start: obsługa zaawansowanych zdarzeń obsługi komunikatów.