Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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.
La ressource targetedChatMessage est un type spécialisé de message de conversation visible uniquement par des destinataires spécifiés. Pour plus d’informations, consultez targetedChatMessage.
Remarque : cette ressource prend en charge l’abonnement aux modifications (création, mise à jour et suppression) à 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 | ||
| Lister 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, ainsi que les réactions à ceux-ci, ainsi que les messages nouveaux, modifiés ou supprimés. |
| 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 | Aucun | Mettez à jour les propriétés d’un message de conversation. |
| Supprimer un message dans le canal | Aucun | Supprimez le message dans un canal. |
| Annuler la suppression d’un message dans un canal | Aucun | Annuler la suppression du message dans un canal. |
| Définir la réaction à un message dans un canal | Aucun | Définir la réaction à un message dans un canal. |
| Réaction non définie à un message dans un canal | Aucun | Réaction non définie à un message dans un canal. |
| Réponses aux messages du canal | ||
| Liste des réponses au message | collectionchatMessage | Liste de toutes les réponses à un message de conversation dans un canal. |
| Obtenir un message de réponse dans le canal | chatMessage | Obtenir un message de réponse unique dans un canal. |
| Réponse à un message dans un canal | chatMessage | Réponse à 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 un 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 un 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 | Réaction non définie à un message de réponse dans un canal. |
| Messages de conversation | ||
| Lister les messages dans la conversation | chatMessage | Répertorier les messages de conversation dans une conversation. |
| Obtenir le message dans une conversation | chatMessage | Obtenez un seul message de conversation dans une conversation. |
| Recevoir des messages dans toutes les conversations pour l’utilisateur | Collection de conversations | Recevez 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 la conversation | chatMessage | Envoyez un message de conversation dans une conversation existante en tête à tête ou de groupe. |
| Mettre à jour le message dans la conversation | chatMessage | Mettez à jour les propriétés d’un message de conversation. |
| Supprimer un message dans la conversation | chatMessage | Supprimez le message d’une conversation. |
| Annuler la suppression d’un message dans la conversation | chatMessage | Annulez la suppression du message dans une conversation. |
| Définir la réaction à un message de conversation | chatMessage | Définir la réaction à un message de conversation |
| Réaction non définie à un message de conversation | chatMessage | Réaction non définie à un message de conversation. |
| Transférer le message à la conversation | collecte forwardToChatResult | Transférez un message de conversation, un message de canal ou un message de canal répondez à une conversation. |
| Répondre avec un devis | chatMessage | Répondez avec des guillemets à un seul message de conversation ou à plusieurs messages de conversation 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 | Les références à des objets joints tels que des fichiers, des onglets, des réunions, etc. |
| corps | chatMessageBody | Représentation en texte clair/HTML/Markdown du contenu du message de conversation. La représentation est spécifiée par la propriété messageBodyContentType (ou contentType déconseillé) à l’intérieur du corps. Le contenu est toujours en HTML si le message de conversation contient une mention chatMessageMention. |
| channelIdentity | channelIdentity | Si le message a été envoyé dans un canal, représente l’identité du canal. |
| chatId | string | Si le message a été envoyé dans une conversation, représente l’identité de la conversation. |
| Références | chatMessageCitation collection | En lecture seule. Citations en ligne qui font référence aux sources externes citées dans le message. Les citations sont générées par le système pour les messages de bot et apparaissent sous forme d’une collection dactylographiée. |
| 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’a pas été supprimé. |
| etag | chaîne | En lecture seule. Numéro de version du message de conversation. |
| Détail événement | 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, l’ajout de nouveaux membres. Pour les messages d’événement, la propriété messageType est définie sur systemEventMessage. |
| from | 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/canal/réponse au message, mais peuvent être dupliqués dans d’autres conversations/canaux/réponses aux messages. |
| importance | chatMessageImportance | L’importance du message. Les valeurs possibles sont : normal, high, urgent, unknownFutureValue. |
| lastEditedDateTime | dateTimeOffset | En lecture seule. Horodatage du moment où les modifications du message de conversation ont été effectuées. Déclenche un indicateur « Modifié » dans l’interface utilisateur Teams. Si aucune modification n’est effectuée, la valeur est null. |
| lastModifiedDateTime | dateTimeOffset | En lecture seule. Horodatage de la création (paramètre initial) ou de la modification du message de conversation, y compris l’ajout ou la suppression d’une réaction. |
| local | string | Paramètres régionaux du message de conversation définis 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, robot, équipe, canal, conversation et balise. |
| Historique des messages | chatMessageHistoryItem collection | Liste de l’historique d’activité d’un élément de message, y compris l’heure de modification et les actions, telles que reactionAdded, reactionRemoved ou les changements de réaction, sur le message. |
| messageType | chatMessageType | Type de message de conversation. Les valeurs possibles sont : message, chatEvent, typing, unknownFutureValue, systemEventMessage. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les membres suivants dans cette énumération évolutive : systemEventMessage. |
| onBehalfOf | chatMessageFromIdentitySet | Attribution 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.) |
| sujet | string | Objet du message de conversation, en texte brut. |
| résumé | string | Texte de résumé du message de conversation qui peut être utilisé pour les notifications Push et les affichages récapitulatifs ou les affichages 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 les $expand 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.chatMessageBody"},
"channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
"chatId": "String",
"citations": [{"@odata.type": "microsoft.graph.chatMessageCitation"}],
"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"
}