chatMessage : setReaction

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 .

Définir une réaction à un seul message de conversation ou à un message de conversation répondre dans un canal ou une conversation.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Autorisations pour le canal

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) ChannelMessage.Send
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Autorisations pour les conversations

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Chat. ReadWrite, ChatMessage.Send
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Requête HTTP

Pour définir une réaction à un chatMessage dans un canal :

POST /teams/{teamsId}/channels/{channelId}/messages/{chatMessageId}/setReaction
POST /teams/{teamId}/channels/{channelId}/messages/{messageId}/replies/{replyId}/setReaction

Pour définir une réaction à un message de conversation:

POST /chats/{chatId}/messages/{chatMessageId}/setReaction

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez un objet JSON avec les paramètres suivants.

Paramètre Type Description
displayName String Nom d’affichage de l’emoji personnalisé. Facultatif. Lorsque reactionType est custom, spécifiez displayName, reactionId ou les deux.
ID de réaction String Identificateur émis par le service de l’emoji personnalisé. Facultatif. Lorsque reactionType est custom, spécifiez displayName, reactionId ou les deux.
reactionType String Type de réaction. Obligatoire. Spécifiez un caractère Unicode pour une réaction standard ou custom pour une réaction emoji personnalisée.

Si vous spécifiez à la fois displayName et reactionId, ils doivent identifier le même emoji personnalisé à l’étendue du client.

Réponse

Si elle réussit, cette action renvoie un code de réponse 204 No Content.

Cette action renvoie également un 400 Bad Request code de réponse si reactionType l’est custom et que ni displayName ni reactionId ne sont fournis, ou si les identificateurs fournis se résolvent en différents emojis personnalisés. L’action retourne un 404 Not Found code de réponse si l’emoji personnalisé ne peut pas être résolu dans le client.

Exemples

Exemple 1 : Définir une réaction à un message de conversation

L’exemple suivant montre comment définir une réaction à un message de conversation.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/chats/19:8b1131f7c9e64f7b9b4b3f6d2f6f15a7@thread.v2/messages/1700000000000/setReaction
Content-Type: application/json

{
  "reactionType": "💘"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content

Exemple 2 : Définir une réaction à un message dans un canal

L’exemple suivant montre comment définir une réaction à un message dans un canal.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4a95f7d8db4c4e7fae1ec0b28d1d8a52@thread.tacv2/messages/1700000000000/setReaction
Content-Type: application/json

{
  "reactionType": "💘"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content

Exemple 3 : Définir une réaction à un message de réponse

L’exemple suivant montre comment définir une réaction à un message de réponse.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4a95f7d8db4c4e7fae1ec0b28d1d8a52@thread.tacv2/messages/1700000000000/replies/1700000001000/setReaction
Content-Type: application/json

{
  "reactionType": "💘"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content

Exemple 4 : Définir une réaction emoji personnalisée par nom d’affichage et ID de réaction

L’exemple suivant montre comment définir une réaction emoji personnalisée par nom d’affichage et ID de réaction.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/chats/19:8b1131f7c9e64f7b9b4b3f6d2f6f15a7@thread.v2/messages/1700000000000/setReaction
Content-Type: application/json

{
  "reactionType": "custom",
  "displayName": "party-parrot",
  "reactionId": "opaque-service-issued-id"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content
  • Dernière mise à jour :