Tipo de recurso chatMessagechatMessage resource type

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Representa un mensaje de chat individual dentro de un canal o chat.Represents an individual chat message within a channel or chat. El mensaje puede ser un mensaje raíz o parte de una conversación que está definida por la propiedad del mensaje replyToId.The message can be a root message or part of a thread that is defined by the replyToId property in the message.

Nota: Este recurso admite la suscripción a cambios (crear, actualizar y eliminar) mediante notificaciones de cambio.Note: This resource supports subscribing to changes (create, update, and delete) using change notifications. Esto permite a los autores de llamadas suscribirse y obtener cambios en tiempo real.This allows callers to subscribe and get changes in real time. Para obtener más información, vea obtener notificaciones de mensajes.For details, see Get notifications for messages.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Mensajes de canalChannel messages
Enumerar mensajes en el canalList messages in channel Colección chatMessagechatMessage collection Lista de todos los mensajes raíz de un canal.List of all root messages in a channel.
Obtener delta de mensajes en el canalGet delta of messages in channel chatMessagechatMessage Obtenga mensajes incrementales en un canal.Get incremental messages in a channel.
Crear suscripción para nuevos mensajes de canalCreate subscription for new channel messages subscriptionsubscription Escuche los mensajes nuevos, editados y eliminados y las reacciones a ellos.Listen for new, edited, and deleted messages, and reactions to them.
Obtener mensaje en el canalGet message in channel chatMessagechatMessage Obtener un único mensaje raíz en un canal.Get a single root message in a channel.
Enviar mensaje en canalSend message in channel chatMessagechatMessage Cree un nuevo mensaje raíz en un canal.Create a new root message in a channel.
Actualizar mensaje en canalUpdate message in channel chatMessagechatMessage Actualice la propiedad policyViolation de un mensaje de chat.Update the policyViolation property of a chat message.
Respuestas de mensajes de canalChannel message replies
Enumerar respuestas al mensajeList replies to message Colección chatMessagechatMessage collection Lista de todas las respuestas a un mensaje de chat en el canal.List of all replies to a chat message in channel.
Obtener mensaje de respuesta en el canalGet reply message in channel chatMessagechatMessage Obtener un solo mensaje de respuesta en un canal.Get a single reply message in a channel.
Responder a un mensaje en el canalReply to a message in channel chatMessagechatMessage Responder a un mensaje de chat existente en un canal.Reply to an existing chat message in a channel.
Actualizar mensaje de respuestaUpdate reply message chatMessagechatMessage Actualice la propiedad policyViolation de un mensaje de chat.Update the policyViolation property of a chat message.
Mensajes de chatChat messages
Enumerar mensajes en el chatList messages in chat chatMessagechatMessage Enumerar mensajes de chat en un chat.List chat messages in a chat.
Obtener mensaje de chatGet message in chat chatMessagechatMessage Obtener un solo mensaje de chat en un chat.Get a single chat message in a chat.
Crear suscripción para nuevos mensajes de chatCreate subscription for new chat messages subscriptionsubscription Escuche los mensajes de chat nuevos, editados y eliminados y las reacciones a ellos.Listen for new, edited, and deleted chat messages, and reactions to them.
Enviar mensaje en chatSend message in chat chatMessagechatMessage Enviar un mensaje de chat en una conversación de chat de grupo o 1:1 existente.Send a chat message in an existing 1:1 or group chat conversation.
Actualizar mensaje en chatUpdate message in chat chatMessagechatMessage Actualice la propiedad policyViolation de un mensaje de chat.Update the policyViolation property of a chat message.
Contenido hospedadoHosted content
Enumerar todo el contenido hospedadoList all hosted content colección chatMessageHostedContentchatMessageHostedContent collection Obtener todo el contenido hospedado asociado a un mensaje.Get all hosted contents associated with a message.
Obtener contenido hospedadoGet hosted content chatMessageHostedContentchatMessageHostedContent Obtener contenido hospedado (y bytes) para un mensaje.Get hosted content (and it's bytes) for a message.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
idid CadenaString Solo lectura.Read-only. Identificador único del mensaje.Unique Id of the message.
replyToIdreplyToId stringstring Solo lectura.Read-only. Id. del mensaje de chat principal o del mensaje de chat raíz del subproceso.Id of the parent chat message or root chat message of the thread. (Solo se aplica a los mensajes de chat en canales, no a los chats).(Only applies to chat messages in channels, not chats.)
fromfrom identitySetidentitySet Solo lectura.Read only. Detalles del remitente del mensaje de chat.Details of the sender of the chat message.
etagetag stringstring Solo lectura.Read-only. Número de versión del mensaje de chat.Version number of the chat message.
messageTypemessageType cadenastring El tipo de mensaje de chat.The type of chat message. Los valores posibles son: message .The possible values are: message.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Marca de tiempo de cuando se creó el mensaje de chat.Timestamp of when the chat message was created.
lastModifiedDateTimelastModifiedDateTime dateTimeOffsetdateTimeOffset Solo lectura.Read only. Marca de tiempo cuando se crea o modifica el mensaje de chat (configuración inicial), incluso cuando se agrega o quita una reacción.Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.
lastEditedDateTimelastEditedDateTime dateTimeOffsetdateTimeOffset Solo lectura.Read only. Marca de tiempo cuando se realizaron modificaciones en el mensaje de chat.Timestamp when edits to the chat message were made. Desencadena una marca "Editada" en la interfaz de usuario de Teams.Triggers an "Edited" flag in the Teams UI. Si no se realizan modificaciones, el valor es null .If no edits are made the value is null.
deletedDateTimedeletedDateTime dateTimeOffsetdateTimeOffset Solo lectura.Read only. Marca de tiempo en la que se eliminó el mensaje de chat o null si no se eliminó.Timestamp at which the chat message was deleted, or null if not deleted.
subjectsubject cadenastring El asunto del mensaje de chat, en texto sin formato.The subject of the chat message, in plaintext.
bodybody itemBodyitemBody Representación de texto sin formato/HTML del contenido del mensaje de chat.Plaintext/HTML representation of the content of the chat message. La representación la especifica contentType en el cuerpo.Representation is specified by the contentType inside the body. El contenido siempre está en HTML si el mensaje de chat contiene un chatMessageMention.The content is always in HTML if the chat message contains a chatMessageMention.
summarysummary cadenastring Texto de resumen del mensaje de chat que podría usarse para notificaciones de inserción y vistas de resumen o vistas de reserva.Summary text of the chat message that could be used for push notifications and summary views or fall back views. Solo se aplica a los mensajes de chat de canal, no a los mensajes de chat en un chat.Only applies to channel chat messages, not chat messages in a chat.
attachmentsattachments Colección chatMessageAttachmentchatMessageAttachment collection .Archivos adjuntosAttached files. Actualmente los datos adjuntos son de solo lectura: no se admite el envío de datos adjuntos.Attachments are currently read-only – sending attachments is not supported.
mentionsmentions Colección chatMessageMentionchatMessageMention collection Lista de entidades mencionadas en el mensaje de chat.List of entities mentioned in the chat message. Actualmente compatible con usuario, bot, equipo y canal.Currently supports user, bot, team, channel.
importanceimportance cadenastring La importancia del mensaje de chat.The importance of the chat message. Los valores posibles son: normal, high, urgent.The possible values are: normal, high, urgent.
reactionsreactions Colección chatMessageReactionchatMessageReaction collection Reacciones para este mensaje de chat (por ejemplo, Me gusta).Reactions for this chat message (for example, Like).
localelocale cadenastring Configuración regional del mensaje de chat establecido por el cliente.Locale of the chat message set by the client. Siempre se establece en en-us.Always set to en-us.
policyViolationpolicyViolation chatMessagePolicyViolationchatMessagePolicyViolation Define las propiedades de una infracción de directiva establecidas por una aplicación de prevención de pérdida de datos (DLP).Defines the properties of a policy violation set by a data loss prevention (DLP) application.
chatIdchatId cadenastring Si el mensaje se envió en un chat, representa la identidad del chat.If the message was sent in a chat, represents the identity of the chat.
channelIdentitychannelIdentity channelIdentitychannelIdentity Si el mensaje se envió en un canal, representa la identidad del canal.If the message was sent in a channel, represents identity of the channel.
webUrlwebUrl stringstring Solo lectura.Read-only. Vínculo al mensaje en Microsoft Teams.Link to the message in Microsoft Teams.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
respuestasreplies chatMessagechatMessage Respuestas para un mensaje especificado.Replies for a specified message.
hostedContentshostedContents chatMessageHostedContentchatMessageHostedContent Contenido de un mensaje hospedado por Microsoft Teams, por ejemplo, imágenes, fragmentos de código, etc.Content in a message hosted by Microsoft Teams e.g. images, code snippets etc.

Representación JSONJSON representation

La siguiente es una representación JSON del recursoThe 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)",
  "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"
}