Files
miku-discord/readmes/REACTION_FEATURE.md

2.2 KiB

Message Reaction Feature

Overview

This feature allows you to make Miku react to any message in Discord with a specific emoji of your choice through the Web UI.

How to Use

From the Web UI

  1. Navigate to the Actions Tab

  2. Find the "Add Reaction to Message" Section

    • Scroll down to find the "😊 Add Reaction to Message" section
  3. Fill in the Required Information

    • Message ID: Right-click on the target message in Discord → "Copy ID"
    • Channel ID: Right-click on the channel name → "Copy ID"
    • Emoji: Enter the emoji you want Miku to react with (e.g., 💙, 👍, 🎉)
  4. Click "Add Reaction"

    • Miku will add the specified reaction to the message
    • You'll see a success confirmation message

Requirements

  • Discord Developer Mode: You need to enable Developer Mode in Discord to copy message and channel IDs
    • Settings → Advanced → Developer Mode (toggle ON)

Supported Emoji Types

  • Standard Unicode Emoji: 💙, 👍, 🎉, ❤️, etc.
  • Custom Server Emoji: Use the format :emoji_name: for custom Discord emojis

API Endpoint

If you want to integrate this programmatically:

POST /messages/react
Content-Type: multipart/form-data

message_id: <Discord message ID>
channel_id: <Discord channel ID>
emoji: <emoji string>

Example Response

Success:

{
  "status": "ok",
  "message": "Reaction 💙 queued for message 123456789"
}

Error:

{
  "status": "error",
  "message": "Channel 123456789 not found"
}

Troubleshooting

  • "Channel not found": Make sure Miku is in the server that contains that channel
  • "Message not found": Verify the message ID is correct and still exists
  • "Permission denied": Miku needs the "Add Reactions" permission in that channel
  • Invalid emoji: Make sure you're using a valid emoji format

Technical Details

  • The reaction is added asynchronously by the Discord bot
  • The Web UI receives immediate confirmation that the request was queued
  • If the reaction fails (e.g., due to permissions), an error will be logged in the bot logs