Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 dirigido 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 grupal o canal, los mensajes dirigidos proporcionan privacidad para las interacciones de bots y las comunicaciones de aplicación a usuario que requieren información específica del usuario.
Los mensajes dirigidos 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.
- Resúmenes de chat para 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 dirigidos | Colección targetedChatMessage | Obtenga todos los mensajes dirigidos enviados a un usuario específico en chats grupales y canales. |
| Obtener todos los mensajes dirigidos retenidos | Colección targetedChatMessage | Obtenga todos los mensajes dirigidos retenidos enviados a un usuario específico en chats grupales y canales. |
| Eliminar mensaje dirigido del canal | Ninguno | Eliminar un mensaje dirigido específico de un contexto de canal. |
| Eliminar mensaje dirigido del chat | Ninguno | Eliminar un mensaje objetivo específico 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. Heredado de chatMessage. |
| body | itemBody | El contenido del mensaje. Heredado 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 . Heredado de chatMessage. |
| chatId | Cadena | El identificador único del chat si el mensaje de destino se envió en un contexto de chat grupal. Heredado de chatMessage. |
| createdDateTime | DateTimeOffset | La fecha y hora en que se creó el mensaje. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Heredado de chatMessage. |
| deletedDateTime | DateTimeOffset | La fecha y hora en que se eliminó el mensaje. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Solo se aplica a los mensajes retenidos. Heredado de chatMessage. |
| etag | Cadena | Número de versión del mensaje. Heredado de chatMessage. |
| eventDetail | eventMessageDetail | Detalles sobre el evento si este mensaje representa un evento del sistema. Heredado de chatMessage. |
| from | chatMessageFromIdentitySet | Detalles sobre el remitente del mensaje de destino. Heredado de chatMessage. |
| id | Cadena | Identificador único del mensaje. El id. de mensaje solo es único en el contexto de una única conversación (chat o canal) para un usuario específico. Heredado de chatMessage. |
| importance | chatMessageImportance | La importancia del mensaje. Los valores posibles son: normal, high, urgent y unknownFutureValue Heredado 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 con el formato ISO 8601 y siempre está en UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Heredado 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 con el formato ISO 8601 y siempre está en UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Heredado de chatMessage. |
| configuración regional | Cadena | La configuración regional del mensaje establecida por el cliente, con formato .en-us Heredado de chatMessage. |
| mentions | Colección chatMessageMention | Lista de entidades que se mencionan en el mensaje. Heredado de chatMessage. |
| messageHistory | colección chatMessageHistoryItem | Historial de ediciones aplicadas al mensaje. Heredado 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 evolutiva: systemEventMessage. Heredado de chatMessage. |
| onBehalfOf | chatMessageFromIdentitySet | Información sobre el usuario en cuyo nombre se envió el mensaje. Heredado de chatMessage. |
| policyViolation | chatMessagePolicyViolation | Información sobre las infracciones de directivas aplicadas al mensaje por las aplicaciones de prevención de pérdida de datos (DLP). Heredado de chatMessage. |
| reactions | Colección chatMessageReaction | Las reacciones aplicadas al mensaje (por ejemplo, me gusta, corazón y risa). Heredado de chatMessage. |
| destinatario | identity | El destinatario previsto del mensaje de destino. |
| replyToId | Cadena | El identificador del mensaje primario o del mensaje raíz del subproceso. Heredado de chatMessage. |
| subject | String | El asunto del mensaje. Heredado de chatMessage. |
| summary | Cadena | Texto de resumen del mensaje que se puede usar para notificaciones o vistas de resumen. Heredado de chatMessage. |
| webUrl | Cadena | El vínculo al mensaje en Microsoft Teams. Heredado 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. Heredado de chatMessage. |
| respuestas | Colección chatMessage | Responde al mensaje. Actualmente no se admite para mensajes dirigidos. Heredado 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"},
"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"}],
"recipient": {"@odata.type": "microsoft.graph.identity"},
"replyToId": "String",
"subject": "String",
"summary": "String",
"webUrl": "String"
}