Partager via


Ressource type chatMessage

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 de conversation individuelle au sein d’une entité de canal ou une conversation. Le message peut être un message d’origine ou une partie d’un fil de discussion qui est défini(e) par la propriétéreplyToIddans le message.

Remarque : Cette ressource prend en charge l’abonnement aux modifications (créer, mettre à jour et supprimer) à l’aide de notifications de modification. Les appelants peuvent ainsi s’abonner et obtenir des modifications en temps réel. Pour plus d’informations, consultez Obtenir des notifications pour les messages.

Méthodes

Méthode Type renvoyé Description
Messages de canal
Répertorier les messages dans le canal collectionchatMessage Liste de tous les messages racine dans un canal.
Créer un abonnement pour les nouveaux messages de canal abonnement Écoutez les messages nouveaux, modifiés et supprimés, ainsi que les réactions à ceux-ci.
Obtenir le message dans le canal chatMessage Obtenez un seul message racine dans un canal.
Envoyer un message dans le canal chatMessage Créez un message racine dans un canal.
Mettre à jour le message dans le canal Aucun Mettez à jour les propriétés d’un message de conversation.
Supprimer le message dans le canal Aucun Supprimez le message dans un canal.
Annuler la suppression d’un message dans le canal Aucun Annuler la suppression du message dans un canal.
Définir la réaction à un message dans le canal Aucun Définir la réaction à un message dans un canal.
Réaction non définie à un message dans le canal Aucun Réaction non définie à un message dans un canal.
Réponses aux messages de canal
Lister les réponses aux messages collectionchatMessage Liste de toutes les réponses à un message de conversation dans le canal.
Obtenir un message de réponse dans le canal chatMessage Obtenez un seul message de réponse dans un canal.
Répondre à un message dans le canal chatMessage Répondre à un message de conversation existant dans un canal.
Mettre à jour le message de réponse chatMessage Mettez à jour les propriétés d’un message de conversation.
Supprimer le message de réponse dans le canal chatMessage Supprimez le message de réponse unique dans un canal.
Annuler la suppression d’un message de réponse dans le canal chatMessage Annuler la suppression du message de réponse unique dans un canal.
Définir la réaction à un message de réponse dans le canal chatMessage Définir la réaction à un message de réponse dans un canal.
Réaction non définie à un message de réponse dans le canal chatMessage Annuler la réaction à un message de réponse dans un canal.
Messages de conversation
Répertorier les messages dans la conversation chatMessage Répertorier les messages de conversation dans une conversation.
Obtenir le message dans une conversation chatMessage Obtenez un message de conversation unique dans une conversation.
Recevoir des messages dans toutes les conversations pour l’utilisateur collection de conversations Obtenez des messages de toutes les conversations auxquelles un utilisateur participe, y compris les conversations 1:1, les conversations de groupe et les conversations de réunion.
Obtenir des messages de conversation delta pour l’utilisateur collectionchatMessage Obtenez la liste des messages de toutes les conversations auxquelles un utilisateur participe, y compris les conversations en tête-à-tête, les conversations de groupe et les conversations de réunion.
Ajout de l’API de recherche de tous les messages de canal collection channel Obtenir tous les messages de tous les canaux auxquels un utilisateur participe.
Créer un abonnement pour les nouveaux messages de conversation abonnement Écoutez les messages de conversation nouveaux, modifiés et supprimés, ainsi que les réactions à ceux-ci.
Envoyer un message dans une conversation chatMessage Envoyer un message de conversation dans une conversation 1:1 ou de groupe existante.
Mettre à jour le message dans la conversation chatMessage Mettez à jour les propriétés d’un message de conversation.
Supprimer le message dans la conversation chatMessage Supprimez le message d’une conversation.
Annuler la suppression d’un message dans la conversation chatMessage Annuler la suppression du message dans une conversation.
Définir la réaction à un message dans la conversation chatMessage Définir la réaction à un message dans une conversation.
Annuler la réaction à un message dans la conversation chatMessage Réaction non définie à un message dans une conversation.
Contenu hébergé
Répertorier tout le contenu hébergé collection chatMessageHostedContent Obtenir tout le contenu hébergé associé à un message.
Obtenir du contenu hébergé chatMessageHostedContent Obtenir le contenu hébergé (et ses octets) pour un message.

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, etc.
body itemBody Représentation en texte clair/HTML du contenu du message de conversation. La représentation est spécifiée par contentType dans le corps. Le contenu est toujours au format HTML si le message de conversation contient un chatMessageMention.
channelIdentity channelIdentity Si le message a été envoyé dans un canal, représente l’identité du canal.
chatId chaîne Si le message a été envoyé dans une conversation, représente l’identité de la conversation.
createdDateTime dateTimeOffset Horodatage de la création du message de conversation.
deletedDateTime dateTimeOffset En lecture seule. Horodatage auquel le message de conversation a été supprimé, ou null s’il n’est pas supprimé.
etag chaîne En lecture seule. Numéro de version du message de conversation.
eventDetail eventMessageDetail En lecture seule. Le cas échéant, représente les détails d’un événement qui s’est produit dans une conversation, un canal ou une équipe, par exemple, l’ajout de nouveaux membres. Pour les messages d’événement, la propriété messageType est définie sur systemEventMessage.
de chatMessageFromIdentitySet Détails de l’expéditeur du message de conversation. Peut être défini uniquement pendant la migration.
id String En lecture seule. ID unique du message. Les ID sont uniques au sein d’une conversation/d’un canal/d’une réponse à un message, mais peuvent être dupliqués dans d’autres conversations/canaux/réponses aux messages.
importance string Importance du message de conversation. Les valeurs possibles sont normal, high, urgent.
lastEditedDateTime dateTimeOffset En lecture seule. Horodatage lorsque des modifications ont été apportées au message de conversation. Déclenche un indicateur « Modifié » dans l’interface utilisateur Teams. Si aucune modification n’est apportée, la valeur est null.
lastModifiedDateTime dateTimeOffset En lecture seule. Horodatage lorsque le message de conversation est créé (paramètre initial) ou modifié, y compris lorsqu’une réaction est ajoutée ou supprimée.
local string Paramètres régionaux du message de conversation défini par le client. Toujours défini sur en-us.
mentions collectionchatMessageMention Liste des entités mentionnées dans le message de conversation. Les entités prises en charge sont les suivantes : utilisateur, bot, équipe, canal, conversation et balise.
messageHistory collection chatMessageHistoryItem Liste de l’historique d’activité d’un élément de message, y compris l’heure et les actions de modification, telles que reactionAdded, reactionRemoved ou les modifications de réaction, sur le message.
messageType chatMessageType Type de message de conversation. Les valeurs possibles sont : message, chatEvent, typing, unknownFutureValue, systemEventMessage. Notez que vous devez utiliser l’en-tête de requête Prefer: include-unknown-enum-members pour obtenir la valeur suivante dans cette evolvable enum : systemEventMessage.
onBehalfOf chatMessageFromIdentitySet Attribution par l’utilisateur du message lorsque le bot envoie un message au nom d’un utilisateur.
policyViolation chatMessagePolicyViolation Définit les propriétés d’une violation de stratégie définie par une application de protection contre la perte de données (DLP).
réactions collectionchatMessageReaction Réactions pour ce message de conversation (par exemple, J’aime).
replyToId chaîne En lecture seule. ID du message de conversation parent ou du message de conversation racine du thread. (S’applique uniquement aux messages de conversation dans les canaux, et non aux conversations.)
subject string Objet du message de conversation, en texte clair.
résumé string Texte de synthèse du message de conversation qui peut être utilisé pour les notifications Push et les vues récapitulatives ou les vues de secours. S’applique uniquement aux messages de conversation de canal, et non aux messages de conversation dans une conversation.
webUrl chaîne En lecture seule. Lien vers le message dans Microsoft Teams.

Relations

Relation Type Description
Réponses collectionchatMessage Réponses à un message spécifié. Prend en charge $expand les messages de canal.
hostedContents collection chatMessageHostedContent Contenu d’un message hébergé par Microsoft Teams , par exemple, des images ou des extraits de code.

Représentation JSON

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

{
  "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"}],
  "replyToId": "String (identifier)",
  "subject": "String",
  "summary": "String",
  "webUrl": "String"
}