Ressource type chatMessage

Espace de noms: microsoft.graph

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é replyToId dans le message.

Remarque: cette ressource prend en charge l’abonnement aux modifications (créer, mettre à jour et supprimer) à l’aide de notifications de modifications. 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
Liste des messages dans le canal collectionchatMessage Liste de tous les messages racine dans un canal.
Obtenir le delta des messages dans le canal chatMessage Recevez des messages incrémentiels dans un canal.
Créer un abonnement pour les nouveaux messages de canal abonnement Écouter les messages nouveaux, modifiés et supprimés, ainsi que leurs réactions.
Obtenir un message dans le canal chatMessage Obtenir un message racine unique 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 chatMessage Mettez à jour la propriété policyViolation d’un message de conversation.
Réponses aux messages du canal
Ré lister les réponses au message collectionchatMessage Liste de toutes les réponses à un message de conversation dans le canal.
Obtenir un message de réponse dans le canal chatMessage Obtenir un message de réponse unique 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 la propriété policyViolation d’un message de conversation.
Messages de conversation
Liste des messages dans la conversation chatMessage Liste des 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 conversation Obtenez des messages à partir de toutes les conversations d’un utilisateur participant, y compris les conversations 1:1, 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 Écouter les messages de conversation nouveaux, modifiés et supprimés, ainsi que leurs réactions.
Envoyer un message dans une conversation chatMessage Envoyer un message de conversation dans une conversation 1:1 ou de groupe existante.
Mettre à jour un message dans une conversation chatMessage Mettez à jour la propriété policyViolation d’un message de conversation.
Contenu hébergé
Liste de 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
id String En lecture seule. ID unique du message.
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, pas dans les conversations.)
de chatMessageFromIdentitySet Détails de l’expéditeur du message de conversation. Ne peut être définie que pendant la migration.
etag chaîne En lecture seule. Numéro de version du message de conversation.
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.
createdDateTime dateTimeOffset Timestamp of when the chat message was created.
lastModifiedDateTime dateTimeOffset En lecture seule. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.
lastEditedDateTime dateTimeOffset En lecture seule. Timestamp when edits to the chat message were made. Déclenche un indicateur « Modifié » dans l’interface Teams’utilisateur. Si aucune modification n’est réalisée, la valeur est null .
deletedDateTime dateTimeOffset En lecture seule. Timestamp at which the chat message was deleted, or null if not deleted.
sujet string Objet du message de conversation, en texte brut.
body itemBody Représentation html/texte brut 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.
résumé string Texte récapitulatif du message de conversation qui peut être utilisé pour les notifications Push et les affichages récapitulatifs ou les affichages de retour. S’applique uniquement aux messages de conversation de canal, et non aux messages de conversation dans une conversation.
pièces jointes collectionchatMessageAttachment Références à des objets joints tels que des fichiers, des onglets, des réunions, etc.
mentions collectionchatMessageMention Liste des entités mentionnées dans le message de conversation. Les entités pris en charge sont : utilisateur, bot, équipe et canal.
importance string Importance du message de conversation. Les valeurs possibles sont normal, high, urgent.
réactions collectionchatMessageReaction Réactions pour ce message de conversation (par exemple, « J’aime »).
local string Paramètres régionaux du message de conversation définies par le client. Toujours défini sur en-us.
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).
chatId string Si le message a été envoyé dans une conversation, représente l’identité de la conversation.
channelIdentity channelIdentity Si le message a été envoyé dans un canal, représente l’identité du canal.
webUrl chaîne En lecture seule. Lien vers le message dans Microsoft Teams.
eventDetail eventMessageDetail En lecture seule. S’il est présent, représente les détails d’un événement qui s’est produit dans une conversation, un canal ou une équipe, par exemple, en ajoutant de nouveaux membres. Pour les messages d’événement, la propriété messageType est définie sur systemEventMessage .

Relations

Relation Type Description
réponses chatMessage Répond à un message spécifié.
hostedContents chatMessageHostedContent Contenu d’un message hébergé par Microsoft Teams par exemple, des images ou des extraits de code.

Représentation JSON

Voici une représentation JSON de la ressource.

{
  "id": "string (identifier)",
  "replyToId": "string (identifier)",
  "from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
  "etag": "string",
  "messageType": "string",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "string (timestamp)",
  "lastEditedDateTime": "string (timestamp)",
  "deletedDateTime": "string (timestamp)",
  "subject": "string",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "summary": "string",
  "attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
  "mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
  "importance": "string",
  "reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
  "locale": "string",
  "policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
  "chatId": "string",
  "channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
  "webUrl": "string",
  "eventDetail": {
    "@odata.type": "microsoft.graph.eventMessageDetail"
  }
}