Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa uma mensagem direcionada no Microsoft Teams que é visível apenas para um destinatário especificado. Ao contrário das mensagens normais que são visíveis para todos os participantes num chat ou canal de grupo, as mensagens direcionadas fornecem privacidade para interações de bots e comunicações entre aplicações e utilizadores que requerem informações específicas do utilizador.
As mensagens direcionadas são utilizadas em cenários como:
- Bot authentication requests in group contexts, where credentials should only be visible to the requesting user.
- Resumos de chat para novos membros, visíveis apenas para o membro que se junta.
- Mensagens de bot proativas e reativas que contêm informações confidenciais ou específicas do utilizador.
Herda do chatMessage.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Obter todas as mensagens direcionadas | targetedChatMessage collection | Obtenha todas as mensagens direcionadas enviadas a um utilizador específico em chats e canais de grupo. |
| Obter todas as mensagens de destino retidas | targetedChatMessage collection | Obtenha todas as mensagens direcionadas retidas enviadas a um utilizador específico em chats e canais de grupo. |
| Eliminar mensagem direcionada para o canal | Nenhum | Eliminar uma mensagem específica direcionada de um contexto de canal. |
| Eliminar mensagem direcionada para o chat | Nenhum | Eliminar uma mensagem específica direcionada de um contexto de chat. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| attachments | chatMessageAttachment collection | Referências a objetos anexados, como ficheiros, separadores, reuniões ou outros itens. Herdado do chatMessage. |
| corpo | itemBody | O conteúdo da mensagem. Herdado do chatMessage. |
| channelIdentity | channelIdentity | As informações do canal e da equipa se a mensagem de destino foi enviada num contexto de canal. Contém as propriedades channelId e teamId . Herdado do chatMessage. |
| chatId | Cadeia de caracteres | O identificador exclusivo do chat se a mensagem de destino tiver sido enviada num contexto de chat de grupo. Herdado do chatMessage. |
| createdDateTime | DateTimeOffset | A data e hora em que a mensagem foi criada. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado do chatMessage. |
| deletedDateTime | DateTimeOffset | A data e hora em que a mensagem foi eliminada. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Aplicável apenas a mensagens retidas. Herdado do chatMessage. |
| etag | Cadeia de caracteres | O número de versão da mensagem. Herdado do chatMessage. |
| eventDetail | eventMessageDetail | Detalhes sobre o evento se esta mensagem representar um evento do sistema. Herdado do chatMessage. |
| from | chatMessageFromIdentitySet | Detalhes sobre o remetente da mensagem de destino. Herdado do chatMessage. |
| id | Cadeia de caracteres | Identificador exclusivo da mensagem. O ID da mensagem só é exclusivo no contexto de uma única conversação (chat ou canal) para um utilizador específico. Herdado do chatMessage. |
| importância | chatMessageImportance | A importância da mensagem. Os valores possíveis são: normal, high, urgent. Herdado do chatMessage. |
| lastEditedDateTime | DateTimeOffset | Data e hora em que a mensagem foi editada pela última vez. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado do chatMessage. |
| lastModifiedDateTime | DateTimeOffset | Data e hora em que a mensagem ou qualquer uma das respetivas propriedades foi modificada pela última vez. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado do chatMessage. |
| localidade | Cadeia de caracteres | A região da mensagem definida pelo cliente, formatada como en-us. Herdado do chatMessage. |
| mentions | chatMessageMention collection | Lista de entidades mencionada na mensagem. Herdado do chatMessage. |
| messageHistory | chatMessageHistoryItem collection (Coleção chatMessageHistoryItem ) | Histórico de edições aplicadas à mensagem. Herdado do chatMessage. |
| messageType | chatMessageType | O tipo de mensagem. Os valores possíveis são: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: systemEventMessage. Herdado do chatMessage. |
| onBehalfOf | chatMessageFromIdentitySet | Informações sobre o utilizador em cujo nome a mensagem foi enviada. Herdado do chatMessage. |
| policyViolation | chatMessagePolicyViolation | Informações sobre violações de política aplicadas à mensagem por aplicações de prevenção de perda de dados (DLP). Herdado do chatMessage. |
| reactions | chatMessageReaction collection | As reações aplicadas à mensagem (por exemplo, coração, riso). Herdado do chatMessage. |
| destinatário | identity | O destinatário pretendido da mensagem de destino. |
| replyToId | Cadeia de caracteres | O ID da mensagem principal ou da mensagem raiz do tópico. Herdado do chatMessage. |
| assunto | String | O assunto da mensagem. Herdado do chatMessage. |
| summary | Cadeia de caracteres | Texto de resumo da mensagem que pode ser utilizado para notificações ou vistas de resumo. Herdado do chatMessage. |
| webUrl | String | A ligação para a mensagem no Microsoft Teams. Herdado do chatMessage. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| hostedContents | chatMessageHostedContent collection (coleção chatMessageHostedContent ) | Conteúdo alojado na mensagem, como imagens ou fragmentos de código. Herdado do chatMessage. |
| respostas | chatMessage collection | Respostas à mensagem. Atualmente, não é suportado para mensagens direcionadas. Herdado do chatMessage. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.targetedChatMessage",
"attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
"body": {"@odata.type": "microsoft.graph.itemBody"},
"channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
"chatId": "String",
"createdDateTime": "String (timestamp)",
"deletedDateTime": "String (timestamp)",
"etag": "String",
"eventDetail": {"@odata.type": "microsoft.graph.eventMessageDetail"},
"from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
"id": "String (identifier)",
"importance": "String",
"lastEditedDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"locale": "String",
"mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
"messageHistory": [{"@odata.type": "microsoft.graph.chatMessageHistoryItem"}],
"messageType": "String",
"onBehalfOf": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
"policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
"reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
"recipient": {"@odata.type": "microsoft.graph.identity"},
"replyToId": "String",
"subject": "String",
"summary": "String",
"webUrl": "String"
}