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
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 em um chat ou canal em grupo, as mensagens direcionadas fornecem privacidade para interações de bot e comunicações de aplicativo para usuário que exigem informações específicas do usuário.
As mensagens direcionadas são usadas em cenários como:
- Solicitações de autenticação de bot em contextos de grupo, onde as credenciais só devem ser visíveis para o usuário solicitante.
- Resumos do Chat para novos membros, visíveis apenas para o membro que ingressou.
- Mensagens de bot proativas e reativas que contêm informações confidenciais ou específicas do usuário.
Herda de chatMessage.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Obter todas as mensagens direcionadas | targetedChatMessage collection | Receba todas as mensagens direcionadas enviadas a um usuário específico em chats e canais em grupo. |
| Obter todas as mensagens direcionadas retidas | targetedChatMessage collection | Obtenha todas as mensagens direcionadas retidas enviadas a um usuário específico em chats e canais em grupo. |
| Excluir mensagem direcionada do canal | Nenhum | Exclua uma mensagem direcionada específica de um contexto de canal. |
| Excluir mensagem direcionada do chat | Nenhum | Exclua uma mensagem direcionada específica de um contexto de chat. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| attachments | chatMessageAttachment collection | Referências a objetos anexados, como arquivos, guias, reuniões ou outros itens. Herdado de chatMessage. |
| corpo | itemBody | O conteúdo da mensagem. Herdado de chatMessage. |
| chatId | Cadeia de caracteres | O identificador exclusivo do chat se a mensagem de destino tiver sido enviada em um contexto de chat de grupo. Herdado de chatMessage. |
| channelIdentity | channelIdentity | Informações do canal e da equipe se a mensagem de destino foi enviada em um contexto de canal. Contém as propriedades channelId e teamId . Herdado de 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 usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado de chatMessage. |
| deletedDateTime | DateTimeOffset | A data e hora em que a mensagem foi excluída. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2014 é 2014-01-01T00:00:00Z. Aplicável apenas para mensagens retidas. Herdado de chatMessage. |
| etag | Cadeia de caracteres | O número de versão da mensagem. Herdado de chatMessage. |
| eventDetail | eventMessageDetail | Detalhes sobre o evento se esta mensagem representa um evento do sistema. Herdado de chatMessage. |
| from | chatMessageFromIdentitySet | Detalhes sobre o remetente da mensagem de destino. Herdado de chatMessage. |
| id | Cadeia de caracteres | O identificador exclusivo da mensagem. A ID da mensagem só é exclusiva no contexto de uma única conversa (chat ou canal) para um usuário específico. Herdado de chatMessage. |
| importância | chatMessageImportance | A importância da mensagem. Os valores possíveis são: normal, high, urgent, unknownFutureValue. Herdado de 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 usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado de chatMessage. |
| lastModifiedDateTime | DateTimeOffset | Data e hora em que a mensagem ou qualquer uma de suas propriedades foi modificada pela última vez. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado de chatMessage. |
| localidade | Cadeia de caracteres | A localidade da mensagem conforme definida pelo cliente, formatada como en-us. Herdado de chatMessage. |
| mentions | chatMessageMention collection | Lista de entidades mencionada na mensagem. Herdado de chatMessage. |
| messageHistory | coleção chatMessageHistoryItem | Histórico de edições aplicadas à mensagem. Herdado de chatMessage. |
| messageType | chatMessageType | O tipo de mensagem. Os valores possíveis são: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Use o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: systemEventMessage. Herdado de chatMessage. |
| policyViolation | chatMessagePolicyViolation | Informações sobre violações de política aplicadas à mensagem por aplicativos de prevenção contra perda de dados (DLP). Herdado de chatMessage. |
| reactions | chatMessageReaction collection | As reações aplicadas à mensagem (por exemplo, curtir, coração e rir). Herdado de chatMessage. |
| destinatário | identity | O destinatário pretendido da mensagem de destino. |
| replyToId | Cadeia de caracteres | A ID da mensagem pai ou mensagem raiz do thread. Herdado de chatMessage. |
| assunto | String | O assunto da mensagem. Herdado de chatMessage. |
| summary | Cadeia de caracteres | Texto resumido da mensagem que pode ser usado para notificações ou exibições resumidas. Herdado de chatMessage. |
| webUrl | String | O link para a mensagem no Microsoft Teams. Herdado de chatMessage. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| conteúdo hospedado | chatMessageHostedColeção de conteúdo | Conteúdo hospedado na mensagem, como imagens ou trechos de código. Herdado de chatMessage. |
| respostas | chatMessage collection | Responder à mensagem. Atualmente não há suporte para mensagens direcionadas. Herdado de chatMessage. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.targetedChatMessage",
"attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
"body": {"@odata.type": "microsoft.graph.itemBody"},
"chatId": "String",
"channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
"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",
"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"
}