chatMessage: unsetReaction

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Anule a definição de uma reação a uma única mensagem de bate-papo ou resposta de mensagem de chat em um canal ou chat.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Permissões para o canal

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) ChannelMessage.Send
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sem suporte.

Permissões para o chat

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Chat. ReadWrite, ChatMessage.Send
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sem suporte.

Solicitação HTTP

Para remover a definição de uma reação a um chatMessage em um canal:

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

Para remover a definição de uma reação a um chatMessage em um chat:

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça um objeto JSON com os parâmetros a seguir.

Parâmetro Tipo Descrição
displayName Cadeia de caracteres O nome de exibição do emoji personalizado. Opcional. Quando reactionType for custom, especifique displayName, reactionId ou ambos.
reactionId Cadeia de caracteres O identificador emitido pelo serviço do emoji personalizado. Opcional. Quando reactionType for custom, especifique displayName, reactionId ou ambos.
reactionType Cadeia de caracteres O tipo de reação. Obrigatório. Especifique um caractere Unicode para uma reação padrão ou custom para uma reação de emoji personalizada.

Se você especificar displayName e reactionId, eles deverão identificar o mesmo emoji personalizado no escopo do locatário.

Resposta

Se tiver êxito, esta ação retornará um código de resposta 204 No Content.

Essa ação também retornará um código de 400 Bad Request resposta se reactionType for custom e nem displayName nem reactionId forem fornecidos, ou se os identificadores fornecidos resolverem como emojis personalizados diferentes. A ação retornará um código de 404 Not Found resposta se o emoji personalizado não puder ser resolvido no locatário.

Exemplos

Exemplo 1: Remover a definição de uma reação a uma mensagem de chat

O exemplo a seguir mostra como remover a definição de uma reação a uma mensagem de chat.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
  "reactionType": "💘"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: Remover a definição de uma reação a uma mensagem em um canal

O exemplo a seguir mostra como remover a definição de uma reação a uma mensagem em um canal.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
  "reactionType": "💘"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 3: Remover a definição de uma reação a uma resposta de mensagem

O exemplo a seguir mostra como remover a definição de uma reação a uma resposta de mensagem.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
  "reactionType": "💘"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 4: Desmarque uma reação de emoji personalizada por nome de exibição e ID de reação

O exemplo a seguir mostra como desmarcar uma reação de emoji personalizada por nome de exibição e ID de reação.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

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

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Última atualização em