Azure İletişim Hizmetleri - Gelişmiş Mesajlaşma olayları
Bu makale, İletişim Hizmetleri Gelişmiş Mesajlaşma olaylarının özelliklerini ve şemasını sağlar. Olay şemalarına giriş için bkz . Azure Event Grid olay şeması.
Olay tipleri
Azure İletişim Hizmetleri aşağıdaki Gelişmiş Mesajlaşma olay türlerini yayar:
| Olay türü | Açıklama |
|---|---|
| Microsoft.Communication.AdvancedMessageReceived | İletişim Hizmetleri Gelişmiş Mesajlaşma bir ileti aldığında yayımlanır. |
| Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated | İletişim Hizmetleri Gelişmiş Mesajlaşma, daha önce gönderilmiş bir ileti bildirimi için durum güncelleştirmesi aldığında yayımlanır. |
| Microsoft.Communication.AdvancedMessageAnalysisCompleted(Önizleme) | İletişim Hizmeti müşteri iletisiyle yapay zeka analizini tamamladığında yayımlanır. |
Olay yanıtları
Bir olay tetiklendiğinde Event Grid hizmeti bu olayla ilgili verileri abone olan uç noktalara gönderir.
Bu bölüm, bu verilerin her olay için nasıl görüneceğine ilişkin bir örnek içerir.
Microsoft.Communication.AdvancedMessageReceived olayı
İletişim Hizmetleri Gelişmiş Mesajlaşma bir ileti aldığında yayımlanır.
Örnek senaryo: Bir WhatsApp kullanıcısı, bir İletişim Hizmetleri kaynağındaki etkin bir Gelişmiş Mesajlaşma kanalına bağlı bir WhatsApp İş Numarasına Bir WhatsApp iletisi gönderir. Sonuç olarak, kullanıcının WhatsApp iletisinin içeriğini içeren bir Microsoft.Communication.AdvancedMessageReceived yayımlanır.
Öznitelik listesi
Olaylara özgü Microsoft.Communication.AdvancedMessageReceived özniteliklerin ayrıntıları.
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| channelType | string |
✔️ | İletinin gönderildiği kanalın kanal türü. Örneğin "whatsapp". |
| kimden | string |
✔️ | İletiyi gönderen gönderen kimliği. |
| kullanıcısı | string |
✔️ | guid olarak biçimlendirilmiş, iletiyi alan kanal kimliği. |
| receivedTimestamp | DateTimeOffset |
✔️ | İletinin zaman damgası. |
| content | string |
✔️ | İletideki metin içeriği. |
| medya | MediaContent |
✔️ | Alınan medyayla ilgili ayrıntıları içerir. |
| bağlam | MessageContext |
✔️ | Alınan medyayla ilgili ayrıntıları içerir. |
| düğme | ButtonContent |
✔️ | Alınan medyayla ilgili ayrıntıları içerir. |
| etkileşimli | InteractiveContent |
✔️ | Alınan medyayla ilgili ayrıntıları içerir. |
MediaContent
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| mimeType | string |
❌ | Medyanın MIME türü. Medya indirmeleri için doğru dosya türünü belirlemek için kullanılır. |
| id | string |
❌ | Medya Kimliği. İndirme için guid olarak biçimlendirilmiş medyayı almak için kullanılır. |
| fileName | string |
✔️ | Karşıya yüklendiğinde belirtilen temel medya dosyasının dosya adı. |
| Başlık | string |
✔️ | Destekleniyorsa ve sağlanıyorsa, medya nesnesi için resim yazısı metni. |
MessageContext
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| kaynak | string |
✔️ | Gelen iletiyi yanıtlayan müşterinin WhatsApp Kimliği. |
| id | string |
✔️ | Gelen yanıt için gönderilen iletinin ileti kimliği. |
ButtonContent
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| text | string |
✔️ | Düğmenin metni. |
| yük | string |
✔️ | kullanıcının seçtiği düğmenin işletme tarafından ayarlanan yükü. |
InteractiveContent
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| Tür | InteractiveReplyType |
✔️ | Etkileşimli içeriğin türü. |
| buttonReply | InteractiveButtonReplyContent |
✔️ | Müşteri bir düğme seçtiğinde gönderilir. |
| listReply | InteractiveListReplyContent |
✔️ | Müşteri listeden bir öğe seçtiğinde gönderilir. |
InteractiveReplyType
| Value | Açıklama |
|---|---|
| buttonReply | Etkileşimli içerik bir düğmedir. |
| listReply | Etkileşimli içerik bir listedir. |
| bilinmiyor | Etkileşimli içerik bilinmiyor. |
InteractiveButtonReplyContent
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| id | string |
✔️ | Düğmenin kimliği. |
| başlık | string |
✔️ | Düğmenin başlığı. |
InteractiveListReplyContent
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| id | string |
✔️ | Seçili liste öğesinin kimliği. |
| başlık | string |
✔️ | Seçili liste öğesinin başlığı. |
| açıklama | string |
✔️ | Seçili satırın açıklaması. |
Örnekler
Kısa mesaj alındı
[{
"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"
}]
Medya iletisi alındı
[{
"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 olayı
İletişim Hizmetleri Gelişmiş Mesajlaşma, daha önce gönderilmiş bir ileti bildirimi için durum güncelleştirmesi aldığında yayımlanır.
Örnek senaryo: Contoso, bir WhatsApp kullanıcısına WhatsApp iletisi göndermek için WhatsApp Business Hesabına bağlı etkin bir Gelişmiş Mesajlaşma kanalı kullanır. Ardından WhatsApp, Contoso'nun Gelişmiş Mesajlaşma kanalını daha önce gönderilen iletinin durumuyla yanıtlar. Sonuç olarak, ileti durumunu içeren bir Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated olay yayımlanır.
Öznitelik listesi
Olaylara özgü Microsoft.Communication.AdvancedMessageReceived özniteliklerin ayrıntıları.
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| channelType | string |
✔️ | İletinin gönderildiği kanalın kanal türü. |
| kimden | string |
✔️ | İletiyi gönderen, GUID olarak biçimlendirilmiş kanal kimliği. |
| kullanıcısı | string |
✔️ | İletinin gönderildiği alıcı kimliği. |
| receivedTimestamp | DateTimeOffset |
✔️ | İletinin zaman damgası. |
| messageId | string |
✔️ | GUID olarak biçimlendirilmiş iletinin kimliği. |
| durum | string |
✔️ | İletinin durumu. Olası değerler , , DeliveredReadve Faileddeğerlerini içerirSent. Daha fazla bilgi için bkz . Durum. |
| error | ChannelEventError |
✔️ | Hatanın ayrıntılarını içerir. |
ChannelEventError
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| channelCode | string |
✔️ | Bu kanalda alınan hata kodu. |
| channelMessage | string |
✔️ | Bu kanalda alınan hata iletisi. |
Durum
| Value | Açıklama |
|---|---|
| Gönderildi | İleti hizmeti iletiyi alıcıya gönderdi |
| Teslim edildi | İleti alıcısı iletiyi aldı |
| Okundu | İleti alıcısı iletiyi okudu |
| Başarısız | İleti doğru gönderemedi |
Örnekler
İleti teslimi için güncelleştirme
[{
"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"
}]
Hatayla ileti teslimi için güncelleştirme
[{
"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(Önizleme) olayı
İletişim Hizmeti müşteri iletisiyle yapay zeka analizini tamamladığında yayımlanır.
Örnek senaryo: Bir WhatsApp kullanıcısı, İleti Analizi özelliğini kabul eden bir İletişim Hizmetleri kaynağındaki etkin bir Gelişmiş Mesajlaşma kanalına bağlı bir WhatsApp İş Numarasına Bir WhatsApp iletisi gönderir. Sonuç olarak, kullanıcının WhatsApp iletisinin analiziyle Microsoft.Communication.AdvancedMessageAnalysisCompleted yayımlanır.
Öznitelik listesi
Olaylara özgü Microsoft.Communication.AdvancedMessageAnalysisCompleted özniteliklerin ayrıntıları.
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| channelType | string |
✔️ | İletinin gönderildiği kanalın kanal türü. |
| kimden | string |
✔️ | İletiyi gönderen, GUID olarak biçimlendirilmiş kanal kimliği. |
| kullanıcısı | string |
✔️ | İletinin gönderildiği alıcı kimliği. |
| receivedTimestamp | DateTimeOffset |
✔️ | İletinin zaman damgası. |
| originalMessage | string |
✔️ | Özgün kullanıcı iletisi. |
| intentAnalysis | string |
✔️ | Alınan kullanıcı iletisinin amaç analizi. |
| languageDetection | LanguageDetection |
✔️ | Alınan kullanıcı iletisinin dil algılamasını içerir. |
| extractedKeyPhrases | List<string> |
✔️ | Alınan kullanıcı iletisinin anahtar ifadelerini içerir. |
LanguageDetection
| Öznitelik | Tür | Null değeri alabilen | Açıklama |
|---|---|---|---|
| dil | string |
✔️ | Languege algılandı. |
| confidenceScore | float |
✔️ | Algılanan dilin güvenilirlik puanı. |
| çeviri | string |
✔️ | İleti çevirisi. |
Örnekler
İleti Analizi Tamamlandı
[{
"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"
}]
Hızlı Başlangıç
Web kancalarını kullanarak Gelişmiş Mesajlaşma olaylarına nasıl abone olunduğunu gösteren hızlı başlangıç için bkz . Hızlı Başlangıç: Gelişmiş Mesajlaşma olaylarını işleme.