Tipo de recurso chatMessagechatMessage resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível no v 1.0, use o seletor de versão .To determine whether an API is available in v1.0, use the Version selector.

Representa uma mensagem de bate-papo individual em um canal ou bate-papo.Represents an individual chat message within a channel or chat. A mensagem pode ser uma mensagem raiz ou parte de um thread definido pela propriedade replyToId na mensagem.The message can be a root message or part of a thread that is defined by the replyToId property in the message.

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Mensagens de canalChannel messages
Listar canal chatList channel chatMessage chatMessage collectionchatMessage collection Lista de todas as mensagens de chat raiz em um canal.List of all root chat messages in a channel.
Obter chatMessages em um Delta de canalGet chatMessages in a channel delta chatMessagechatMessage Obter mensagens de chat incrementais em um canal.Get incremental chat messages in a channel.
Criar assinatura para novas mensagens de canalCreate subscription for new channel messages subscriptionsubscription Ouvir mensagens de canal novas e editadas e reações para elas.Listen for new and edited channel messages, and reactions to them.
Obter canal chatGet channel chatMessage chatMessagechatMessage Obtenha uma única mensagem de chat raiz de um canal.Get a single root chat message from a channel.
Criar chat em um canal ou chatCreate chatMessage in a channel or chat chatMessagechatMessage Criar uma nova mensagem de chat de nível superior em um canal.Create a new top-level chat message in a channel.
Atualizar chatUpdate chatMessage chatMessagechatMessage Atualizar a propriedade policyViolation de uma mensagem de chat.Update the policyViolation property of a chat message.
Respostas de mensagens de canalChannel message replies
Listar respostas a um chatList replies to a chatMessage chatMessage collectionchatMessage collection Lista de todas as respostas para uma mensagem de chat no canal.List of all replies to a chat message in channel.
Obter uma resposta para um chatGet a reply to a chatMessage chatMessagechatMessage Obter uma única resposta para uma mensagem de chat em um canal.Get a single reply to a chat message in a channel.
Responder a um chat em um canalReply to a chatMessage in a channel chatMessagechatMessage Responder a uma mensagem de chat existente em um canal.Reply to an existing chat message in a channel.
Atualizar chatUpdate chatMessage chatMessagechatMessage Atualizar a propriedade policyViolation de uma mensagem de chat.Update the policyViolation property of a chat message.
1:1 e mensagens de chat de grupo1:1 and group chat messages
Obter chat no chatGet chatMessage in chat chatMessagechatMessage Obter uma única mensagem de chat em um chat.Get a single chat message in a chat.
Listar chatMessages em um chatList chatMessages in a chat chatMessagechatMessage Listar mensagens de chat em um bate-papo de grupo ou 1:1.List chat messages in a 1:1 or group chat.
Criar assinatura para novas mensagens de chatCreate subscription for new chat messages subscriptionsubscription Ouvir mensagens de chat novas e editadas e reações para elas.Listen for new and edited chat messages, and reactions to them.
Criar chat em um chatCreate chatMessage in a chat chatMessagechatMessage Envie uma mensagem de chat em uma conversa existente de chat de grupo ou 1:1.Send a chat message in an existing 1:1 or group chat conversation.
Atualizar chatUpdate chatMessage chatMessagechatMessage Atualizar a propriedade policyViolation de uma mensagem de chat.Update the policyViolation property of a chat message.
Conteúdo hospedadoHosted content
Listar todo o conteúdo hospedadoList all hosted content coleção chatMessageHostedContentchatMessageHostedContent collection Obter todo o conteúdo hospedado em uma mensagem de chat.Get all hosted content in a chat message.
Obter conteúdo hospedadoGet hosted content chatMessageHostedContentchatMessageHostedContent Obter conteúdo hospedado de uma mensagem de chat.Get hosted content from a chat message.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
idid StringString Somente leitura.Read-only. ID única da mensagem.Unique ID of the message.
replyToIdreplyToId stringstring Somente leitura.Read-only. ID da mensagem de chat pai ou mensagem de chat raiz do thread.ID of the parent chat message or root chat message of the thread. (Só se aplica a mensagens de chat em canais, não chats.)(Only applies to chat messages in channels, not chats.)
fromfrom identitySetidentitySet Somente leitura.Read only. Detalhes do remetente da mensagem de chat.Details of the sender of the chat message.
etagetag stringstring Somente leitura.Read-only. Número de versão da mensagem de chat.Version number of the chat message.
messageTypemessageType stringstring O tipo de mensagem de chat.The type of chat message. Os valores possíveis são: message .The possible values are: message.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Somente leitura.Read only. Carimbo de data/hora de quando a mensagem de chat foi criada.Timestamp of when the chat message was created.
lastModifiedDateTimelastModifiedDateTime dateTimeOffsetdateTimeOffset Somente leitura.Read only. Carimbo de data/hora em que a mensagem de chat é criada (configuração inicial) ou modificada, incluindo quando uma reação é adicionada ou removida.Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.
lastEditedDateTimelastEditedDateTime dateTimeOffsetdateTimeOffset Somente leitura.Read only. Carimbo de data/hora em que foram feitas edições na mensagem de chat.Timestamp when edits to the chat message were made. Dispara um sinalizador "editado" na interface do usuário do Microsoft Teams.Triggers an "Edited" flag in the Teams UI. Se não for feita nenhuma edição, o valor será null .If no edits are made the value is null.
deletedDateTimedeletedDateTime dateTimeOffsetdateTimeOffset Somente leitura.Read only. Carimbo de data/hora em que a mensagem de chat foi excluída ou nula se não for excluída.Timestamp at which the chat message was deleted, or null if not deleted.
assuntosubject stringstring O assunto da mensagem de chat, em texto não criptografado.The subject of the chat message, in plaintext.
bodybody itemBodyitemBody Representação de texto não criptografado/HTML do conteúdo da mensagem de chat.Plaintext/HTML representation of the content of the chat message. A representação é especificada pelo contentType dentro do corpo.Representation is specified by the contentType inside the body. O conteúdo estará sempre em HTML se a mensagem de chat contiver um chatMessageMention.The content is always in HTML if the chat message contains a chatMessageMention.
summarysummary stringstring Texto de resumo da mensagem de chat que pode ser usado para notificações por push e visualizações de resumo ou exibições de retorno.Summary text of the chat message that could be used for push notifications and summary views or fall back views. Aplica-se somente a mensagens de chat de canal, e não a mensagens de chat em um chat.Only applies to channel chat messages, not chat messages in a chat.
attachmentsattachments chatMessageAttachment collectionchatMessageAttachment collection Arquivos anexos.Attached files. No momento, os anexos são somente leitura, não há suporte para o envio de anexos.Attachments are currently read-only – sending attachments is not supported.
mentionsmentions chatMessageMention collectionchatMessageMention collection Lista de entidades mencionadas na mensagem de chat.List of entities mentioned in the chat message. Atualmente, dá suporte a usuário, bot, equipe, canal.Currently supports user, bot, team, channel.
importânciaimportance stringstring A importância da mensagem de chat.The importance of the chat message. Os valores possíveis são: normal, high, urgent.The possible values are: normal, high, urgent.
reactionsreactions chatMessageReaction collectionchatMessageReaction collection Reações para esta mensagem de chat (por exemplo, como).Reactions for this chat message (for example, Like).
localidadelocale stringstring Local da mensagem de chat definida pelo cliente.Locale of the chat message set by the client.
policyViolationpolicyViolation chatMessagePolicyViolationchatMessagePolicyViolation Define as propriedades de uma violação de política definida por um aplicativo DLP (prevenção de perda de dados).Defines the properties of a policy violation set by a data loss prevention (DLP) application.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recurso.The following is a JSON representation of the resource.

{
  "id": "string (identifier)",
  "replyToId": "string (identifier)",
  "from": {"@odata.type": "microsoft.graph.identitySet"},
  "etag": "string",
  "messageType": "string",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "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"},
  "deleted": true
}