Azure Communication Services – Speciális üzenetkezelési események
Ez a cikk a Communication Services speciális üzenetkezelési eseményeinek tulajdonságait és sémáját ismerteti. Az eseménysémákról az Azure Event Grid eseményséma című témakörben olvashat.
Eseménytípusok
Az Azure Communication Services a következő speciális üzenetkezelési eseménytípusokat bocsátja ki:
| Eseménytípus | Leírás |
|---|---|
| Microsoft.Communication.AdvancedMessageReceived | Akkor jelenik meg, amikor a Communication Services speciális üzenetkezelése üzenetet kap. |
| Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated | Akkor jelenik meg, ha a Communication Services speciális üzenetkezelése állapotfrissítést kap egy korábban elküldött üzenetértesítéshez. |
| Microsoft.Communication.AdvancedMessageAnalysisCompleted(előzetes verzió) | Közzétéve, amikor a Communication Service ügyfélüzenettel fejez be egy AI-elemzést. |
Eseményválaszok
Esemény aktiválásakor az Event Grid szolgáltatás adatokat küld az eseményről a végpontok előfizetéséhez.
Ez a szakasz egy példát tartalmaz arra, hogy az adatok hogyan néznek ki az egyes eseményekhez.
Microsoft.Communication.AdvancedMessageReceived esemény
Akkor jelenik meg, amikor a Communication Services speciális üzenetkezelése üzenetet kap.
Példaforgatókönyv: Egy WhatsApp-felhasználó WhatsApp-üzenetet küld egy WhatsApp-üzleti számnak, amely egy Kommunikációs szolgáltatási erőforrás aktív speciális üzenetkezelési csatornához csatlakozik. Ennek eredményeképpen Microsoft.Communication.AdvancedMessageReceived a felhasználó WhatsApp-üzenetének tartalma közzé lesz téve.
Attribútumlista
Az eseményekre jellemző Microsoft.Communication.AdvancedMessageReceived attribútumok részletei.
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| channelType | string |
✔️ | Annak a csatornának a csatornatípusa, amelyen az üzenet el lett küldve. Pl. "whatsapp". |
| from | string |
✔️ | Az üzenetet küldő feladó azonosítója. |
| felhasználóként a(z) | string |
✔️ | Az üzenetet fogadó csatornaazonosító GUID formátumban. |
| receivedTimestamp | DateTimeOffset |
✔️ | Az üzenet időbélyege. |
| content | string |
✔️ | Az üzenet szöveges tartalma. |
| média | MediaContent |
✔️ | A fogadott adathordozó részletei. |
| kontextus | MessageContext |
✔️ | A fogadott adathordozó részletei. |
| gomb | ButtonContent |
✔️ | A fogadott adathordozó részletei. |
| interactive | InteractiveContent |
✔️ | A fogadott adathordozó részletei. |
MediaContent
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| mimeType | string |
❌ | A média MIME-típusa. A médialetöltések megfelelő fájltípusának meghatározására szolgál. |
| id | string |
❌ | Médiaazonosító. A letöltéshez használt adathordozó lekérésére szolgál, GUID formátumban. |
| fileName | string |
✔️ | A mögöttes médiafájl fájlneve a feltöltéskor megadott módon. |
| felirat | string |
✔️ | A médiaobjektum feliratszövege, ha támogatott és meg van adva. |
MessageContext
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| from | string |
✔️ | A bejövő üzenetre válaszoló ügyfél WhatsApp-azonosítója. |
| id | string |
✔️ | Az elküldött üzenet üzenetazonosítója egy bejövő válaszhoz. |
ButtonContent
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| text | string |
✔️ | A gomb szövege. |
| payload | string |
✔️ | A felhasználó által kiválasztott gomb hasznos adatai, amelyet a vállalat állított be. |
InteractiveContent
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| típus | InteractiveReplyType |
✔️ | Az interaktív tartalom típusa. |
| buttonReply | InteractiveButtonReplyContent |
✔️ | Elküldve, amikor egy ügyfél kiválaszt egy gombot. |
| listReply | InteractiveListReplyContent |
✔️ | Akkor küldi el, ha egy ügyfél kiválaszt egy elemet egy listából. |
InteractiveReplyType
| Érték | Leírás |
|---|---|
| buttonReply | Az interaktív tartalom egy gomb. |
| listReply | Az interaktív tartalom egy lista. |
| ismeretlen | Az interaktív tartalom ismeretlen. |
InteractiveButtonReplyContent
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| id | string |
✔️ | A gomb azonosítója. |
| cím | string |
✔️ | A gomb címe. |
InteractiveListReplyContent
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| id | string |
✔️ | A kijelölt listaelem azonosítója. |
| cím | string |
✔️ | A kijelölt listaelem címe. |
| leírás | string |
✔️ | A kijelölt sor leírása. |
Példák
Szöveges üzenet érkezett
[{
"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",
"from": "{sender@id}",
"to": "11111111-1111-1111-1111-111111111111",
"receivedTimestamp": "2023-07-06T18:30:19+00:00"
},
"eventType": "Microsoft.Communication.AdvancedMessageReceived",
"dataVersion": "1.0",
"metadataVersion": "1",
"eventTime": "2023-07-06T18:30:22.1921716Z"
}]
Médiaüzenet érkezett
[{
"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",
"media": {
"mimeType": "image/jpeg",
"id": "22222222-2222-2222-2222-222222222222",
"caption": "This is a media caption"
},
"from": "{sender@id}",
"to": "11111111-1111-1111-1111-111111111111",
"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 esemény
Akkor jelenik meg, ha a Communication Services speciális üzenetkezelése állapotfrissítést kap egy korábban elküldött üzenetértesítéshez.
Példaforgatókönyv: A Contoso egy WhatsApp Business-fiókhoz csatlakoztatott aktív speciális üzenetkezelési csatornát használ WhatsApp-üzenet whatsApp-felhasználónak való küldéséhez. A WhatsApp ezután válaszol a Contoso Speciális üzenetkezelési csatornájára a korábban elküldött üzenet állapotával. Ennek eredményeképpen az Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated üzenet állapotát tartalmazó esemény lesz közzétéve.
Attribútumlista
Az eseményekre jellemző Microsoft.Communication.AdvancedMessageReceived attribútumok részletei.
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| channelType | string |
✔️ | Annak a csatornának a csatornatípusa, amelyen az üzenet el lett küldve. |
| from | string |
✔️ | Az üzenetet küldő csatornaazonosító GUID formátumban. |
| felhasználóként a(z) | string |
✔️ | Az üzenet címzettazonosítója. |
| receivedTimestamp | DateTimeOffset |
✔️ | Az üzenet időbélyege. |
| messageId | string |
✔️ | Az üzenet azonosítója GUID formátumban. |
| status | string |
✔️ | Az üzenet állapota. A lehetséges értékek a következők: Sent, Delivered, Readés Failed. További információ: Állapot. |
| error | ChannelEventError |
✔️ | Egy hiba részleteit tartalmazza. |
ChannelEventError
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| channelCode | string |
✔️ | A csatornán kapott hibakód. |
| channelMessage | string |
✔️ | A csatornán kapott hibaüzenet. |
Állapot
| Érték | Leírás |
|---|---|
| Elküldött | Az üzenetküldő szolgáltatás elküldte az üzenetet a címzettnek |
| Kézbesítve | Az üzenet címzettje megkapta az üzenetet |
| Olvasás | Az üzenet címzettje felolvassa az üzenetet |
| Sikertelen | Nem sikerült megfelelően elküldeni az üzenetet |
Példák
Frissítés üzenetkézbesítéshez
[{
"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"
}]
Frissítés sikertelen üzenetkézbesítéshez
[{
"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"
}]
Microsoft.Communication.AdvancedMessageAnalysisCompleted(előzetes verzió) esemény
Közzétéve, amikor a Communication Service ügyfélüzenettel fejez be egy AI-elemzést.
Példaforgatókönyv: Egy WhatsApp-felhasználó WhatsApp-üzenetet küld egy WhatsApp-üzleti számnak, amely egy aktív speciális üzenetkezelési csatornához csatlakozik egy Kommunikációs szolgáltatások erőforrásban, amely engedélyezte az Üzenetelemzés funkciót. Ennek eredményeképpen megjelenik egy Microsoft.Communication.AdvancedMessageAnalysisA felhasználó WhatsApp-üzenetének elemzése.
Attribútumlista
Az eseményekre jellemző Microsoft.Communication.AdvancedMessageAnalysisCompleted attribútumok részletei.
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| channelType | string |
✔️ | Annak a csatornának a csatornatípusa, amelyen az üzenet el lett küldve. |
| from | string |
✔️ | Az üzenetet küldő csatornaazonosító GUID formátumban. |
| felhasználóként a(z) | string |
✔️ | Az üzenet címzettazonosítója. |
| receivedTimestamp | DateTimeOffset |
✔️ | Az üzenet időbélyege. |
| originalMessage | string |
✔️ | Az eredeti felhasználói üzenet. |
| intentAnalysis | string |
✔️ | A fogadott felhasználói üzenet szándékelemzése. |
| languageDetection | LanguageDetection |
✔️ | A fogadott felhasználói üzenet nyelvfelismerését tartalmazza. |
| extractedKeyPhrases | List<string> |
✔️ | A kapott felhasználói üzenet kulcskifejezéseit tartalmazza. |
LanguageDetection
| Attribútum | Típus | Nullázható | Leírás |
|---|---|---|---|
| language | string |
✔️ | Az észlelt languege. |
| confidenceScore | float |
✔️ | Az észlelt nyelv megbízhatósági pontszáma. |
| fordítás | string |
✔️ | Az üzenet fordítása. |
Példák
Az üzenetelemzés befejeződött
[{
"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"
}]
Gyorsútmutató
A speciális üzenetküldési események webes horogokkal való feliratkozását bemutató rövid útmutatót a speciális üzenetkezelési események kezelése című rövid útmutatóban talál.