Serviços de Comunicação do Azure - Eventos de Mensagens Avançadas
Artigo
Este artigo fornece as propriedades e o esquema para eventos de Mensagens Avançadas dos Serviços de Comunicação. Para obter uma introdução aos esquemas de eventos, consulte Esquema de eventos da Grade de Eventos do Azure.
Tipos de evento
Os Serviços de Comunicação do Azure emitem os seguintes tipos de eventos de Mensagens Avançadas:
Publicado quando o Mensagens Avançadas dos Serviços de Comunicação recebe uma atualização de status para uma notificação de mensagem enviada anteriormente.
Publicado quando o Mensagens Avançadas dos Serviços de Comunicação recebe uma mensagem.
Cenário de exemplo: um usuário do WhatsApp envia uma mensagem do WhatsApp para um número comercial do WhatsApp que está conectado a um canal de mensagens avançadas ativo em um recurso de serviços de comunicação. Como resultado, um Microsoft.Communication.AdvancedMessageReceived com o conteúdo da mensagem do WhatsApp do usuário é publicado.
Lista de atributos
Detalhes dos atributos específicos dos Microsoft.Communication.AdvancedMessageReceived eventos.
Atributo
Type
Que podem ser nulos
Description
channelType
string
❌
Tipo de canal do canal em que a mensagem foi enviada. Por exemplo: "whatsapp".
messageId
string
❌
ID da mensagem do evento de recebimento da mensagem como GUID.
Tipo de mensagem
string
❌
Tipo de mensagem do evento de recebimento de mensagem. Tais como: "interactive", "sticker", "reaction".
de
string
❌
ID do remetente que enviou a mensagem.
para
string
❌
O ID do canal que recebeu a mensagem, formatado como um GUID.
receivedTimestamp
DateTimeOffset
❌
Carimbo de data/hora quando a mensagem é recebida.
Publicado quando o Mensagens Avançadas dos Serviços de Comunicação recebe uma atualização de status para uma notificação de mensagem enviada anteriormente.
Cenário de exemplo: a Contoso usa um canal de Mensagens Avançadas ativo conectado a uma Conta do WhatsApp Business para enviar uma mensagem do WhatsApp a um usuário do WhatsApp. Em seguida, o WhatsApp responde ao canal de Mensagens Avançadas da Contoso com o status da mensagem enviada anteriormente. Como resultado, um Microsoft.Communication.AdvancedMessageDeliveryStatusUpdated evento que contém o status da mensagem é publicado.
Lista de atributos
Detalhes dos atributos específicos dos Microsoft.Communication.AdvancedMessageReceived eventos.
Atributo
Type
Que podem ser nulos
Description
channelType
string
❌
Tipo de canal do canal em que a mensagem foi enviada.
de
string
❌
O ID do canal que enviou a mensagem, formatado como um GUID.
para
string
❌
ID do destinatário para o qual a mensagem foi enviada.
receivedTimestamp
DateTimeOffset
❌
Carimbo de data/hora da mensagem.
messageId
string
✔️
O ID da mensagem, formatada como um GUID.
status
string
✔️
Status da mensagem. Os valores possíveis incluem Sent, Delivered, Read, e Failed. Para obter mais informações, consulte Status.
Publicado quando o Serviço de Comunicação conclui uma análise de IA com uma mensagem do cliente.
Cenário de exemplo: um usuário do WhatsApp envia uma mensagem para um número comercial do WhatsApp conectado a um canal de mensagens avançadas ativo em um recurso de serviços de comunicação que optou pelo recurso de análise de mensagens. Como resultado, o sistema publica um Microsoft.Communication.AdvancedMessageAnalysisCompleted com a análise da mensagem do WhatsApp do usuário.
Lista de atributos
Detalhes dos atributos específicos dos Microsoft.Communication.AdvancedMessageAnalysisCompleted eventos.
Atributo
Type
Que podem ser nulos
Description
channelType
string
✔️
Tipo de canal do canal em que a mensagem foi enviada.
de
string
✔️
O ID do canal que enviou a mensagem, formatado como um GUID.
para
string
✔️
ID do destinatário para o qual a mensagem foi enviada.
receivedTimestamp
DateTimeOffset
✔️
Carimbo de data/hora da mensagem.
originalMensagem
string
✔️
A mensagem de usuário original.
Análise de intenção
string
✔️
A análise de intenção da mensagem de usuário recebida.
Contém a deteção de idioma da mensagem de usuário recebida.
extractedKeyPhrases
List<string>
✔️
Contém as frases-chave da mensagem de usuário recebida.
Deteção de idioma
Atributo
Type
Que podem ser nulos
Description
idioma
string
✔️
O idioma detetado.
confiançaScore
float
✔️
O índice de confiança da língua detetada.
tradução
string
✔️
A tradução da mensagem.
Exemplos
Análise de mensagens concluída
[{
"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"
}]
Início Rápido
Para obter um guia de início rápido que mostra como se inscrever em eventos de Mensagens Avançadas usando ganchos da Web, consulte Guia de início rápido: manipular eventos de mensagens avançadas.