chatMessage: setReaction

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Legen Sie eine Reaktion auf eine einzelne chatMessage oder eine Chat-Nachrichtenantwort in einem Kanal oder Chat fest.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungen für Kanal

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) ChannelMessage.Send
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application Nicht unterstützt

Berechtigungen für Chat

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Chat. ReadWrite, ChatMessage.Send
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application Nicht unterstützt

HTTP-Anforderung

So legen Sie eine Reaktion auf eine chatMessage in einem Kanal fest:

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

So legen Sie eine Reaktion auf eine chatMessage in einem Chat fest:

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

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter Typ Beschreibung
displayName Zeichenfolge Der Anzeigename des benutzerdefinierten Emojis. Optional. Wenn reactionType ist custom, geben Sie displayName, reactionId oder beides an.
reactionId Zeichenfolge Der vom Dienst ausgegebene Bezeichner des benutzerdefinierten Emojis. Optional. Wenn reactionType ist custom, geben Sie displayName, reactionId oder beides an.
reactionType Zeichenfolge Der Reaktionstyp. Erforderlich. Geben Sie ein Unicode-Zeichen für eine Standardreaktion oder custom für eine benutzerdefinierte Emoji-Reaktion an.

Wenn Sie sowohl displayName als auch reactionId angeben, müssen sie dasselbe mandantenbezogene benutzerdefinierte Emoji identifizieren.

Antwort

Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Diese Aktion gibt auch einen 400 Bad Request Antwortcode zurück, wenn reactionType ist custom und weder displayName noch reactionId angegeben wird, oder wenn die angegebenen Bezeichner in verschiedene benutzerdefinierte Emojis aufgelöst werden. Die Aktion gibt einen 404 Not Found Antwortcode zurück, wenn das benutzerdefinierte Emoji nicht im Mandanten aufgelöst werden kann.

Beispiele

Beispiel 1: Festlegen einer Reaktion auf eine Chatnachricht

Im folgenden Beispiel wird gezeigt, wie Sie eine Reaktion auf eine Chatnachricht festlegen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

{
  "reactionType": "💘"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 2: Festlegen einer Reaktion auf eine Nachricht in einem Kanal

Das folgende Beispiel zeigt, wie Sie eine Reaktion auf eine Nachricht in einem Kanal festlegen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 3: Festlegen einer Reaktion auf eine Antwortnachricht

Das folgende Beispiel zeigt, wie Sie eine Reaktion auf eine Antwortnachricht festlegen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 4: Festlegen einer benutzerdefinierten Emoji-Reaktion anhand des Anzeigenamens und der Reaktions-ID

Das folgende Beispiel zeigt, wie Sie eine benutzerdefinierte Emoji-Reaktion anhand des Anzeigenamens und der Reaktions-ID festlegen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content
  • Zuletzt aktualisiert um