Azure Communication Services – Rozšířené události zasílání zpráv
Článek
Tento článek obsahuje vlastnosti a schéma pro události rozšířeného zasílání zpráv komunikačních služeb. Úvod do schémat událostí najdete ve schématu událostí služby Azure Event Grid.
Typy událostí
Služba Azure Communication Services generuje následující typy událostí rozšířeného zasílání zpráv:
Publikováno, když rozšířené zasílání zpráv komunikačních služeb obdrží zprávu.
Ukázkový scénář: Uživatel WhatsApp odešle zprávu WhatsAppu na číslo WhatsApp Business, které je připojené k aktivnímu kanálu rozšířeného zasílání zpráv v prostředku Komunikační služby. V důsledku toho Microsoft.Communication.AdvancedMessageReceived se publikuje obsah zprávy WhatsApp uživatele.
Seznam atributů
Podrobnosti o atributech specifických pro Microsoft.Communication.AdvancedMessageReceived události
Atribut
Typ
S možnou hodnotou Null
Popis
channelType
string
❌
Typ kanálu, na který byla zpráva odeslána. Například: "whatsapp".
messageId
string
❌
ID zprávy přijímá událost jako IDENTIFIKÁTOR GUID.
messageType
string
❌
Typ zprávy události přijetí zprávy. Například: "interactive", "sticker", "reaction".
from
string
❌
ID odesílatele, které zprávu odeslalo.
na
string
❌
ID kanálu, které zprávu obdrželo, je formátované jako identifikátor GUID.
Publikováno, když rozšířené zasílání zpráv komunikačních služeb obdrží aktualizaci stavu pro dříve odeslané oznámení zprávy.
Ukázkový scénář: Společnost Contoso používá aktivní kanál rozšířeného zasílání zpráv připojený k účtu WhatsApp Business k odeslání zprávy WhatsApp uživateli WhatsApp. WhatsApp pak odpoví na kanál Rozšířené zasílání zpráv společnosti Contoso se stavem dříve odeslané zprávy. V důsledku toho se publikuje událost obsahující Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated stav zprávy.
Seznam atributů
Podrobnosti o atributech specifických pro Microsoft.Communication.AdvancedMessageReceived události
Atribut
Typ
S možnou hodnotou Null
Popis
channelType
string
❌
Typ kanálu, na který byla zpráva odeslána.
from
string
❌
ID kanálu, které zprávu odeslalo, je formátované jako identifikátor GUID.
na
string
❌
ID příjemce, na které byla zpráva odeslána.
receivedTimestamp
DateTimeOffset
❌
Časové razítko zprávy
messageId
string
✔️
ID zprávy formátované jako identifikátor GUID.
stav
string
✔️
Stav zprávy Možné hodnoty zahrnují Sent, Delivered, Reada Failed. Další informace naleznete v tématu Stav.
Publikuje se po dokončení analýzy umělé inteligence se zprávou zákazníka.
Ukázkový scénář: Uživatel WhatsApp odešle zprávu na WhatsApp Business Number připojené k aktivnímu kanálu rozšířeného zasílání zpráv v prostředku služby Communication Services, který se přihlásil k funkci Analýza zpráv. V důsledku toho systém publikuje Microsoft.Communication.AdvancedMessageAnalysisCompleted s analýzou zprávy WhatsApp uživatele.
Seznam atributů
Podrobnosti o atributech specifických pro Microsoft.Communication.AdvancedMessageAnalysisCompleted události
Atribut
Typ
S možnou hodnotou Null
Popis
channelType
string
✔️
Typ kanálu, na který byla zpráva odeslána.
from
string
✔️
ID kanálu, které zprávu odeslalo, je formátované jako identifikátor GUID.
Obsahuje rozpoznávání jazyka přijaté zprávy uživatele.
extractedKeyPhrases
List<string>
✔️
Obsahuje klíčové fráze přijaté zprávy uživatele.
LanguageDetection
Atribut
Typ
S možnou hodnotou Null
Popis
jazyk
string
✔️
Zjistil se jazyk.
confidenceScore
float
✔️
Zjistilo se skóre spolehlivosti jazyka.
Překlad
string
✔️
Překlad zprávy.
Příklady
Analýza zpráv byla dokončena.
[{
"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"
}]
Rychlé zprovoznění
Rychlý start, který ukazuje, jak se přihlásit k odběru událostí služby Advanced Messaging pomocí webhooků, najdete v tématu Rychlý start: Zpracování událostí rozšířeného zasílání zpráv.