Type de ressource targetedChatMessage

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente un message ciblé dans Microsoft Teams qui est visible uniquement par un destinataire spécifié. Contrairement aux messages ordinaires qui sont visibles par tous les participants d’une conversation de groupe ou d’un canal, les messages ciblés fournissent une confidentialité pour les interactions de bot et les communications d’application à utilisateur qui nécessitent des informations spécifiques à l’utilisateur.

Les messages ciblés sont utilisés dans des scénarios tels que :

  • Demandes d’authentification de bot dans les contextes de groupe, où les informations d’identification doivent être visibles uniquement par l’utilisateur demandeur.
  • Résumés des conversations pour les nouveaux membres, visibles uniquement par le membre qui rejoint.
  • Messages de bot proactifs et réactifs qui contiennent des informations sensibles ou spécifiques à l’utilisateur.

Hérite de chatMessage.

Méthodes

Méthode Type de retour Description
Obtenir tous les messages ciblés collection targetedChatMessage Obtenez tous les messages ciblés envoyés à un utilisateur spécifique dans des conversations de groupe et des canaux.
Obtenir tous les messages ciblés conservés collection targetedChatMessage Obtenez tous les messages ciblés conservés envoyés à un utilisateur spécifique dans les conversations de groupe et les canaux.
Supprimer le message ciblé pour le canal Aucun Supprimer un message ciblé spécifique d’un contexte de canal.
Supprimer le message ciblé pour la conversation Aucun Supprimer un message ciblé spécifique d’un contexte de conversation.

Propriétés

Propriété Type Description
pièces jointes collectionchatMessageAttachment Références à des objets joints tels que des fichiers, des onglets, des réunions ou d’autres éléments. Hérité de chatMessage.
corps itemBody Contenu du message. Hérité de chatMessage.
channelIdentity channelIdentity Informations sur le canal et l’équipe si le message ciblé a été envoyé dans un contexte de canal. Contient les propriétés channelId et teamId . Hérité de chatMessage.
chatId String Identificateur unique de la conversation si le message ciblé a été envoyé dans un contexte de conversation de groupe. Hérité de chatMessage.
createdDateTime DateTimeOffset Date et heure de création du message. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Hérité de chatMessage.
deletedDateTime DateTimeOffset Date et heure de suppression du message. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Applicable uniquement aux messages conservés. Hérité de chatMessage.
etag String Numéro de version du message. Hérité de chatMessage.
eventDetail eventMessageDetail Détails sur l’événement si ce message représente un événement système. Hérité de chatMessage.
from chatMessageFromIdentitySet Détails sur l’expéditeur du message ciblé. Hérité de chatMessage.
id String Identificateur unique du message. L’ID de message n’est unique que dans le contexte d’une seule conversation (conversation ou canal) pour un utilisateur spécifique. Hérité de chatMessage.
importance chatMessageImportance Importance du message. Les valeurs possibles sont : normal, high, urgent. Hérité de chatMessage.
lastEditedDateTime DateTimeOffset Date et heure de la dernière modification du message. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Hérité de chatMessage.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière modification du message ou de l’une de ses propriétés. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Hérité de chatMessage.
local String Paramètres régionaux du message définis par le client, au en-usformat . Hérité de chatMessage.
mentions collectionchatMessageMention Liste des entités mentionnées dans le message. Hérité de chatMessage.
messageHistory collection chatMessageHistoryItem Historique des modifications appliquées au message. Hérité de chatMessage.
messageType chatMessageType Type du message. Les valeurs possibles sont : message, chatEvent, typing, unknownFutureValue, systemEventMessage. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes de cette énumération évolutive : systemEventMessage. Hérité de chatMessage.
onBehalfOf chatMessageFromIdentitySet Informations sur l’utilisateur au nom duquel le message a été envoyé. Hérité de chatMessage.
policyViolation chatMessagePolicyViolation Informations sur les violations de stratégie appliquées au message par les applications de protection contre la perte de données (DLP). Hérité de chatMessage.
réactions collectionchatMessageReaction Réactions appliquées au message (par exemple, j’aime, cœur, rire). Hérité de chatMessage.
destinataire identity Destinataire prévu du message ciblé.
replyToId String ID du message parent ou du message racine du thread. Hérité de chatMessage.
sujet String Objet du message. Hérité de chatMessage.
résumé String Texte récapitulative du message qui peut être utilisé pour les notifications ou les vues récapitulatives. Hérité de chatMessage.
webUrl String Lien vers le message dans Microsoft Teams. Hérité de chatMessage.

Relations

Relation Type Description
hostedContents collection chatMessageHostedContent Contenu hébergé dans le message, tel que des images ou des extraits de code. Hérité de chatMessage.
Réponses collectionchatMessage Répond au message. Actuellement non pris en charge pour les messages ciblés. Hérité de chatMessage.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@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"
}
  • Last updated on