> ## Documentation Index
> Fetch the complete documentation index at: https://agdiai-597e782f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Reactions

# Reactions

The agent can add and remove emoji reactions on messages using the `message`
tool with the `react` action. Reaction behavior varies by channel.

## How it works

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "action": "react",
  "messageId": "msg-123",
  "emoji": "thumbsup"
}
```

* `emoji` is required when adding a reaction.
* Set `emoji` to an empty string (`""`) to remove the bot's reaction(s).
* Set `remove: true` to remove a specific emoji (requires non-empty `emoji`).

## Channel behavior

> [accordion] Discord and Slack
>
> * Empty `emoji` removes all of the bot's reactions on the message.
> * `remove: true` removes just the specified emoji.

> [accordion] Google Chat
>
> * Empty `emoji` removes the app's reactions on the message.
> * `remove: true` removes just the specified emoji.

> [accordion] Telegram
>
> * Empty `emoji` removes the bot's reactions.
> * `remove: true` also removes reactions but still requires a non-empty `emoji` for tool validation.

> [accordion] WhatsApp
>
> * Empty `emoji` removes the bot reaction.
> * `remove: true` maps to empty emoji internally (still requires `emoji` in the tool call).

> [accordion] Zalo Personal (zalouser)
>
> * Requires non-empty `emoji`.
> * `remove: true` removes that specific emoji reaction.

> [accordion] Signal
>
> * Inbound reaction notifications are controlled by `channels.signal.reactionNotifications`: `"off"` disables them, `"own"` (default) emits events when users react to bot messages, and `"all"` emits events for all reactions.

## Related

* [Agent Send](https://agdiai-597e782f.mintlify.site/tools/agent-send.md) — the `message` tool that includes `react`
* [Channels](https://agdiai-597e782f.mintlify.site/channels.md) — channel-specific configuration


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.