Tipo de recurso targetedChatMessage

Espacio de nombres: microsoft.graph

Representa un mensaje de destino en Microsoft Teams que solo es visible para un destinatario especificado. A diferencia de los mensajes normales que son visibles para todos los participantes en un chat o canal de grupo, los mensajes de destino proporcionan privacidad para las interacciones de bot y las comunicaciones de aplicación a usuario que requieren información específica del usuario.

Los mensajes de destino se usan en escenarios como:

• Solicitudes de autenticación de bots en contextos de grupo, donde las credenciales solo deben ser visibles para el usuario solicitante.
• Chat resúmenes de nuevos miembros, visibles solo para el miembro que se une.
• Mensajes de bot proactivos y reactivos que contienen información confidencial o específica del usuario.

Hereda de chatMessage.

Métodos

Método	Tipo devuelto	Descripción
Obtener todos los mensajes de destino	colección targetedChatMessage	Obtenga todos los mensajes dirigidos enviados a un usuario específico en chats y canales de grupo.
Obtener todos los mensajes de destino retenidos	colección targetedChatMessage	Obtenga todos los mensajes de destino retenidos enviados a un usuario específico en chats y canales de grupo.
Eliminación del mensaje de destino del canal	Ninguno	Elimine un mensaje de destino específico de un contexto de canal.
Eliminación del mensaje de destino del chat	Ninguno	Elimine un mensaje específico de destino de un contexto de chat.

Propiedades

Propiedad	Tipo	Descripción
attachments	Colección chatMessageAttachment	Referencias a objetos adjuntos, como archivos, pestañas, reuniones u otros elementos. Se hereda de chatMessage.
body	itemBody	Contenido del mensaje. Se hereda de chatMessage.
chatId	Cadena	Identificador único del chat si el mensaje de destino se envió en un contexto de chat de grupo. Se hereda de chatMessage.
channelIdentity	channelIdentity	La información del canal y del equipo si el mensaje de destino se envió en un contexto de canal. Contiene las propiedades channelId y teamId . Se hereda de chatMessage.
createdDateTime	DateTimeOffset	Fecha y hora en que se creó el mensaje. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Se hereda de chatMessage.
deletedDateTime	DateTimeOffset	Fecha y hora en que se eliminó el mensaje. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Solo se aplica a los mensajes retenidos. Se hereda de chatMessage.
etag	Cadena	Número de versión del mensaje. Se hereda de chatMessage.
eventDetail	eventMessageDetail	Detalles sobre el evento si este mensaje representa un evento del sistema. Se hereda de chatMessage.
from	chatMessageFromIdentitySet	Detalles sobre el remitente del mensaje de destino. Se hereda de chatMessage.
id	Cadena	Identificador único del mensaje. El identificador de mensaje solo es único en el contexto de una sola conversación (chat o canal) para un usuario específico. Se hereda de chatMessage.
importance	chatMessageImportance	La importancia del mensaje. Los valores posibles son: normal, high, urgent y unknownFutureValue Se hereda de chatMessage.
lastEditedDateTime	DateTimeOffset	Fecha y hora en que se editó el mensaje por última vez. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Se hereda de chatMessage.
lastModifiedDateTime	DateTimeOffset	Fecha y hora en que se modificó por última vez el mensaje o cualquiera de sus propiedades. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Se hereda de chatMessage.
configuración regional	Cadena	Configuración regional del mensaje establecida por el cliente, con en-usel formato . Se hereda de chatMessage.
mentions	Colección chatMessageMention	Lista de entidades que se mencionan en el mensaje. Se hereda de chatMessage.
messageHistory	colección chatMessageHistoryItem	Historial de ediciones aplicadas al mensaje. Se hereda de chatMessage.
messageType	chatMessageType	El tipo de mensaje. Los valores posibles son: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: systemEventMessage. Se hereda de chatMessage.
policyViolation	chatMessagePolicyViolation	Información sobre las infracciones de directiva aplicadas al mensaje por las aplicaciones de prevención de pérdida de datos (DLP). Se hereda de chatMessage.
reactions	Colección chatMessageReaction	Las reacciones aplicadas al mensaje (por ejemplo, como el corazón y la risa). Se hereda de chatMessage.
destinatario	identity	Destinatario previsto del mensaje de destino.
replyToId	Cadena	Identificador del mensaje primario o del mensaje raíz del subproceso. Se hereda de chatMessage.
subject	String	El asunto del mensaje. Se hereda de chatMessage.
summary	Cadena	Texto de resumen del mensaje que se puede usar para notificaciones o vistas de resumen. Se hereda de chatMessage.
webUrl	Cadena	Vínculo al mensaje en Microsoft Teams. Se hereda de chatMessage.

Relaciones

Relación	Tipo	Descripción
hostedContents	colección chatMessageHostedContent	Contenido hospedado en el mensaje, como imágenes o fragmentos de código. Se hereda de chatMessage.
respuestas	Colección chatMessage	Responde al mensaje. Actualmente no se admite para los mensajes de destino. Se hereda de chatMessage.

Representación JSON

La siguiente representación JSON muestra el 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"
}