chatMessage: setReaction

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Establecer una reacción a un único chatMessage o una respuesta de mensaje de chat en un canal o un chat.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Permisos para el canal

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) ChannelMessage.Send
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación No admitida.

Permisos para chat

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Chat. Lectura y escritura y ChatMessage.Send
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación No admitida.

Solicitud HTTP

Para establecer una reacción a un chatMessage en un canal:

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

Para establecer una reacción a un chatMessage en un chat:

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.

Parámetro Tipo Descripción
displayName Cadena El nombre para mostrar del emoji personalizado. Opcional. Cuando reactionType sea custom, especifique displayName, reactionId o ambos.
reactionId Cadena El identificador emitido por el servicio del emoji personalizado. Opcional. Cuando reactionType sea custom, especifique displayName, reactionId o ambos.
tipo de reacción Cadena El tipo de reacción. Obligatorio. Especifique un carácter Unicode para una reacción estándar o custom para una reacción de emoji personalizada.

Si especifica displayName y reactionId, deben identificar el mismo emoji personalizado en el ámbito empresarial.

Respuesta

Si se ejecuta correctamente, esta acción devuelve un código de respuesta 204 No Content.

Esta acción también devuelve un 400 Bad Request código de respuesta si reactionType es custom y no se proporcionan displayName ni reactionId , o si los identificadores proporcionados se resuelven en diferentes emojis personalizados. La acción devuelve un 404 Not Found código de respuesta si el emoji personalizado no se puede resolver en el espacio empresarial.

Ejemplos

Ejemplo 1: Establecer una reacción a un mensaje de chat

En el siguiente ejemplo se muestra cómo establecer una reacción a un mensaje de chat.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

{
  "reactionType": "💘"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 2: Establecer una reacción a un mensaje en un canal

En el ejemplo siguiente se muestra cómo establecer una reacción a un mensaje en un canal.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 3: Establecer una reacción a un mensaje de respuesta

En el siguiente ejemplo se muestra cómo establecer una reacción en un mensaje de respuesta.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 4: Establecer una reacción de emoji personalizada por nombre para mostrar e id. de reacción

En el siguiente ejemplo se muestra cómo establecer una reacción de emoji personalizada por nombre para mostrar e Id. de reacción.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content
  • Se actualizó por última vez el