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"
}