Tipo de recurso chatMessage

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa un mensaje de chat individual dentro de un canal o chat. El mensaje puede ser un mensaje raíz o parte de una conversación que está definida por la propiedad del mensaje replyToId.

El recurso targetedChatMessage es un tipo especializado de mensaje de chat que solo son visibles para los destinatarios especificados. Para obtener más información, consulte targetedChatMessage.

Nota: Este recurso admite la suscripción a cambios (crear, actualizar y eliminar) mediante notificaciones de cambios. Esto permite a los autores de llamadas suscribirse y obtener cambios en tiempo real. Para obtener más información, vea obtener notificaciones de mensajes.

Métodos

Método Tipo de valor devuelto Descripción
Mensajes del canal
Enumerar mensajes en el canal Colección chatMessage Lista de todos los mensajes raíz de un canal.
Crear una suscripción para los mensajes de canal nuevos subscripción Escucha mensajes nuevos, editados y eliminados, así como las reacciones a los mismos.
Obtener mensaje en el canal chatMessage Obtener un único mensaje raíz en un canal.
Enviar mensaje en el canal chatMessage Cree un mensaje raíz en un canal.
Actualizar mensaje en el canal Ninguno Actualizar las propiedades de un mensaje de chat.
Eliminar mensaje en el canal Ninguno Elimine el mensaje de un canal.
Deshacer la eliminación de un mensaje en el canal Ninguno Recuperar el mensaje en un canal.
Establecer la reacción a un mensaje en el canal Ninguno Establecer la reacción a un mensaje en un canal.
Reacción sin establecer a un mensaje en el canal Ninguno Reacción sin establecer a un mensaje en un canal.
Respuestas a mensajes de canal
Enumerar respuestas al mensaje Colección chatMessage Lista de todas las respuestas a un mensaje de chat en el canal.
Obtener mensaje de respuesta en el canal chatMessage Obtenga un único mensaje de respuesta en un canal.
Responder a un mensaje en el canal chatMessage Responder a un mensaje de chat existente en un canal.
Actualizar mensaje de respuesta chatMessage Actualizar las propiedades de un mensaje de chat.
Eliminar mensaje de respuesta en el canal chatMessage Eliminar el mensaje de respuesta único de un canal.
Deshacer la eliminación de un mensaje de respuesta en el canal chatMessage Recuperar el mensaje de respuesta único de un canal.
Establecer la reacción a un mensaje de respuesta en el canal chatMessage Establezca la reacción a un mensaje de respuesta en un canal.
Reacción no establecida a un mensaje de respuesta en el canal chatMessage Reacción sin establecer a un mensaje de respuesta en un canal.
Mensajes de chat
Mostrar mensajes en el chat chatMessage Enumerar mensajes de chat en un chat.
Obtener mensaje de chat chatMessage Obtener un solo mensaje de chat en un chat.
Obtener mensajes en todos los chats para un usuario Colección de chats Obtener mensajes de todos los chats en los que participe un usuario, incluidos los chats individuales, los chats de grupo y los chats de reunión.
Obtener mensajes de chat diferenciales para el usuario Colección chatMessage Obtenga la lista de mensajes de todos los chats en los que participa un usuario, incluidos los chats uno a uno, los chats de grupo y los chats de reunión.
Obtener todos los mensajes del canal Colección channel Obtiene todos los mensajes de todos los canales en los que un usuario es participante.
Crear una suscripción para los nuevos mensajes de chat subscripción Escuche los mensajes de chat nuevos, editados y eliminados, y las reacciones a ellos.
Enviar mensaje en el chat chatMessage Enviar un mensaje de chat en una conversación de chat 1:1 o de chat grupal existente.
Actualizar mensaje en el chat chatMessage Actualizar las propiedades de un mensaje de chat.
Eliminar mensaje en el chat chatMessage Eliminar el mensaje de un chat.
Deshacer la eliminación de un mensaje en el chat chatMessage Recuperar el mensaje en un chat.
Establecer la reacción a un mensaje en el chat chatMessage Establecer la reacción a un mensaje en un chat.
Reacción sin establecer a un mensaje en el chat chatMessage Reacción sin establecer a un mensaje en un chat.
Reenviar mensaje al chat colección forwardToChatResult Reenvíe un mensaje de chat, un mensaje de canal o un mensaje de canal para responder a un chat.
Responder con cita chatMessage Responder con cita a un único mensaje de chat o a varios mensajes de chat en un chat.
Contenido hospedado
Enumerar todo el contenido hospedado colección chatMessageHostedContent Obtener todos los contenidos hospedados asociados a un mensaje.
Obtener contenido hospedado chatMessageHostedContent Obtener contenido hospedado (y sus bytes) para un mensaje.

Propiedades

Propiedad Tipo Descripción
attachments Colección chatMessageAttachment Referencias a objetos adjuntos como archivos, pestañas, reuniones, etc.
body chatMessageBody Representación de texto sin formato/HTML/Markdown del contenido del mensaje de chat. La representación se especifica mediante la propiedad messageBodyContentType (o contentType en desuso) dentro del cuerpo. El contenido siempre está en HTML si el mensaje de chat contiene un chatMessageMention.
channelIdentity channelIdentity Si el mensaje se envió en un canal, representa la identidad del canal.
chatId string Si el mensaje se envió en un chat, representa la identidad del chat.
createdDateTime dateTimeOffset Marca de tiempo de cuándo se creó el mensaje de chat.
deletedDateTime dateTimeOffset Solo lectura. Marca de tiempo en la que se eliminó el mensaje de chat o nula si no se eliminó.
etag string Solo lectura. Número de versión del mensaje de chat.
eventDetail eventMessageDetail Solo lectura. Si está presente, representa detalles de un evento que ocurrió en un chat, un canal o un equipo, por ejemplo, agregar nuevos miembros. Para los mensajes de eventos, la propiedad messageType se establecerá en systemEventMessage.
from chatMessageFromIdentitySet Detalles del remitente del mensaje de chat. Solo se puede establecer durante la migración.
id Cadena Solo lectura. Id. único del mensaje. Los identificadores son únicos en un chat, canal o respuesta a un mensaje, pero se pueden duplicar en otros chats, canales o respuestas a mensajes.
importance chatMessageImportance La importancia del mensaje. Los valores posibles son: normal, high, urgent y unknownFutureValue
lastEditedDateTime dateTimeOffset Solo lectura. Marca de tiempo cuando se realizaron modificaciones en el mensaje de chat. Activa una marca "Editado" en la interfaz de usuario de Teams. Si no se realizan ediciones, el valor es null.
lastModifiedDateTime dateTimeOffset Solo lectura. Marca de tiempo cuando se crea el mensaje de chat (configuración inicial) o se modifica, incluso cuando se agrega o quita una reacción.
locale string Configuración regional del mensaje de chat establecido por el cliente. Siempre se establece en en-us.
mentions Colección chatMessageMention Lista de entidades mencionadas en el mensaje de chat. Las entidades admitidas son: usuario, bot, equipo, canal, chat y etiqueta.
messageHistory colección chatMessageHistoryItem Lista del historial de actividad de un elemento del mensaje, incluyendo el tiempo de modificación y las acciones, como reactionAdded, reactionRemoved o cambios de reacción, en el mensaje.
messageType chatMessageType El tipo de mensaje de chat. Los valores posibles son: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Use el encabezado de solicitud Prefer: include-unknown-enum-members para obtener los siguientes miembros en esta enumeración evolutiva: systemEventMessage.
onBehalfOf chatMessageFromIdentitySet Atribución del usuario del mensaje cuando el bot envía un mensaje en nombre de un usuario.
policyViolation chatMessagePolicyViolation Define las propiedades de una infracción de directiva establecida por una aplicación de prevención de pérdida de datos (DLP).
reactions Colección chatMessageReaction Reacciones para este mensaje de chat (por ejemplo, Me gusta).
replyToId string Solo lectura. Identificador del mensaje de chat primario o del mensaje de chat raíz de la conversación. (Solo se aplica a los mensajes de chat de los canales, no a los chats).
subject string El asunto del mensaje de chat, en texto sin formato.
summary string Texto de resumen del mensaje de chat que se puede usar para notificaciones push y vistas de resumen o vistas de reserva. Solo se aplica a los mensajes de chat del canal, no a los mensajes de chat de un chat.
webUrl string Solo lectura. Vincular al mensaje en Microsoft Teams.

Relaciones

Relación Tipo Descripción
respuestas Colección chatMessage Respuestas para un mensaje especificado. Compatibilidad $expand con mensajes de canal.
hostedContents colección chatMessageHostedContent Contenido de un mensaje hospedado por Microsoft Teams, por ejemplo, imágenes o fragmentos de código.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
  "body": {"@odata.type": "microsoft.graph.chatMessageBody"},
  "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"}],
  "replyToId": "String (identifier)",
  "subject": "String",
  "summary": "String",
  "webUrl": "String"
}
  • Last updated on