Tipo de recurso chatMessage

Namespace: microsoft.graph

Representa uma mensagem de bate-papo individual em um canal ou bate-papo. A mensagem pode ser uma mensagem raiz ou parte de um thread definido pela propriedade replyToId na mensagem.

Observação: esse recurso dá suporte à assinatura de alterações (criar, atualizar e excluir) usando notificações de alteração. Isso permite aos chamadores assinar e obter alterações em tempo real. Para obter detalhes, confira obter notificações dede mensagens.

Methods

Método	Tipo de retorno	Descrição
Mensagens do canal
Listar mensagens no canal	chatMessage collection	Lista de todas as mensagens raiz em um canal.
Obter delta de mensagens no canal	chatMessage	Obtenha mensagens incrementais em um canal.
Criar assinatura para novas mensagens de canal	assinatura	Ouça mensagens novas, editadas e excluídas e reações a elas.
Obter mensagem no canal	chatMessage	Obter uma única mensagem raiz em um canal.
Enviar mensagem no canal	chatMessage	Crie uma nova mensagem raiz em um canal.
Atualizar mensagem no canal	chatMessage	Atualize a propriedade policyViolation de uma mensagem de chat.
Respostas de mensagem de canal
Listar respostas à mensagem	chatMessage collection	Lista de todas as respostas a uma mensagem de chat no canal.
Obter mensagem de resposta no canal	chatMessage	Obtenha uma única mensagem de resposta em um canal.
Responder a uma mensagem no canal	chatMessage	Responder a uma mensagem de chat existente em um canal.
Atualizar mensagem de resposta	chatMessage	Atualize a propriedade policyViolation de uma mensagem de chat.
Mensagens de chat
Listar mensagens no chat	chatMessage	Listar mensagens de chat em um chat.
Receba uma mensagem no bate-papo	chatMessage	Obtenha uma única mensagem de chat em um chat.
Obter mensagens em todos os chats para o usuário	coleção de chat	Obtenha mensagens de todos os chats em que um usuário é participante, que inclui chats 1:1, chats em grupo e chats de reunião.
Obter todas as mensagens do canal	channel collection	Obter todas as mensagens de todos os chats nos quais um usuário é um participante.
Criar assinatura para novas mensagens de chat	assinatura	Ouça mensagens de chat novas, editadas e excluídas e reações a elas.
Enviar mensagem no chat	chatMessage	Envie uma mensagem de chat em uma conversa de chat em grupo ou 1:1 existente.
Atualizar mensagem no chat	chatMessage	Atualize a propriedade policyViolation de uma mensagem de chat.
Conteúdo hospedado
Listar todo o conteúdo hospedado	Coleção chatMessageHostedContent	Obter todo o conteúdo hospedado associado a uma mensagem.
Obter conteúdo hospedado	chatMessageHostedContent	Obter conteúdo hospedado (e seus bytes) para uma mensagem.

Propriedades

Propriedade	Tipo	Descrição
id	String	Somente leitura. ID única da mensagem.
replyToId	string	Somente leitura. ID da mensagem de chat pai ou da mensagem de chat raiz da conversa. (Aplica-se somente a mensagens de chat em canais, não chats.)
from	chatMessageFromIdentitySet	Detalhes do remetente da mensagem de chat. Só pode ser definido durante a migração.
etag	string	Somente leitura. Número de versão da mensagem de chat.
messageType	chatMessageType	O tipo de mensagem de chat. Os valores possíveis são: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Observe que você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter o seguinte valor nessa enumeração evolutiva: systemEventMessage.
createdDateTime	dateTimeOffset	Carimbo de data/hora de quando a mensagem de chat foi criada.
lastModifiedDateTime	dateTimeOffset	Somente leitura. Carimbo de data/hora quando a mensagem de chat é criada (configuração inicial) ou modificada, incluindo quando uma reação é adicionada ou removida.
lastEditedDateTime	dateTimeOffset	Somente leitura. Carimbo de data/hora quando as edições da mensagem de chat foram feitas. Dispara um sinalizador "Editado" na interface do Teams usuário. Se nenhuma edição for feita, o valor será null.
deletedDateTime	dateTimeOffset	Somente leitura. Carimbo de data/hora em que a mensagem de chat foi excluída ou nulo se não for excluído.
assunto	string	O assunto da mensagem de chat, em texto não criptografado.
body	itemBody	Representação de texto sem formatação/HTML do conteúdo da mensagem de chat. A representação é especificada pelo contentType dentro do corpo. O conteúdo estará sempre em HTML se a mensagem de chat contiver um chatMessageMention.
summary	string	Texto de resumo da mensagem de chat que pode ser usado para notificações por push e exibições de resumo ou exibições de fallback. Aplica-se somente a mensagens de chat de canal, não mensagens de chat em um chat.
attachments	chatMessageAttachment collection	Referências a objetos anexados, como arquivos, guias, reuniões etc.
mentions	chatMessageMention collection	Lista de entidades mencionadas na mensagem de chat. As entidades com suporte são: usuário, bot, equipe e canal.
importância	string	A importância da mensagem de chat. Os valores possíveis são: normal, high, urgent.
reactions	chatMessageReaction collection	Reações para essa mensagem de chat (por exemplo, Like).
localidade	string	Localidade da mensagem de chat definida pelo cliente. Sempre definido para en-us.
policyViolation	chatMessagePolicyViolation	Define as propriedades de um conjunto de violações de política por um aplicativo de prevenção contra perda de dados (DLP).
chatId	string	Se a mensagem foi enviada em um chat, representa a identidade do chat.
channelIdentity	channelIdentity	Se a mensagem foi enviada em um canal, representa a identidade do canal.
webUrl	cadeia de caracteres	Somente leitura. Link para a mensagem no Microsoft Teams.
eventDetail	eventMessageDetail	Somente leitura. Se presente, representa detalhes de um evento que ocorreu em um chat, um canal ou uma equipe, por exemplo, adicionando novos membros. Para mensagens de evento, a propriedade messageType será definida como systemEventMessage.

Relações

Relação	Tipo	Descrição
Respostas	chatMessage	Respostas para uma mensagem especificada. Suporte para $expand mensagens de canal.
hostedContents	chatMessageHostedContent	Conteúdo em uma mensagem hospedada por Microsoft Teams – por exemplo, imagens ou snippets de código.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "id": "string (identifier)",
  "replyToId": "string (identifier)",
  "from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
  "etag": "string",
  "messageType": "string",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "string (timestamp)",
  "lastEditedDateTime": "string (timestamp)",
  "deletedDateTime": "string (timestamp)",
  "subject": "string",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "summary": "string",
  "attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
  "mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
  "importance": "string",
  "reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
  "locale": "string",
  "policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
  "chatId": "string",
  "channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
  "webUrl": "string",
  "eventDetail": {
    "@odata.type": "microsoft.graph.eventMessageDetail"
  }
}