Managing Message Reactions Across Channels

I often find that the most frustrating part of building chat tools is dealing with inconsistent APIs. One platform wants a specific ID for a reaction, while another expects a boolean flag. It gets messy fast when you just want your bot to acknowledge a message with a simple thumbs-up.

I prefer using a unified set of semantics to handle these interactions. Here is how to manage reactions across different channels without writing custom logic for every single one.

What You’ll Need

• Access to supported channels: Discord, Slack, Google Chat, Telegram, WhatsApp, or Signal.
• For Signal: The channels.signal.reactionNotifications setting must be enabled to receive inbound reaction events.

Quick Start

You can manage reactions using three primary configurations. These work across most supported platforms.

1. Add a reaction: Provide the emoji you want to use.
2. Remove all bot reactions: Set emoji to an empty string ("").
3. Remove a specific emoji: Provide the emoji and set remove: true.

Channel-Specific Behavior

While the semantics are shared, different platforms handle these flags in their own way:

• Discord and Slack: Setting emoji="" removes every reaction the bot has added to that message. Using remove: true targets only the emoji you specify.
• Google Chat: An empty emoji string removes the app’s reactions. Use remove: true to delete a specific one.
• WhatsApp: The remove: true flag maps to an empty emoji. You must still provide the emoji value for this to work.
• Telegram: An empty emoji string removes the bot’s reactions. If you use remove: true, you must still provide a non-empty emoji string to pass tool validation.

Troubleshooting

Telegram Validation Fails

If you are trying to remove a reaction on Telegram using remove: true, the tool might fail if the emoji field is empty. Ensure you provide the emoji string even when removing it.

Missing Signal Notifications

If your bot is not reacting to inbound signals, check your configuration. Inbound reaction notifications for Signal only emit system events when channels.signal.reactionNotifications is enabled.

Need help with a specific channel configuration? Ask the AI Setup Assistant.

What’s Next

• Channel Configuration Overview
• System Events Reference