Discord Actions

Overview

Use discord to manage messages, reactions, threads, polls, and moderation. You can disable groups via discord.actions.* (defaults to enabled, except roles/moderation). The tool uses the bot token configured for Otto.

Inputs to collect

• For reactions: channelId , messageId , and an emoji .

• For fetchMessage: guildId , channelId , messageId , or a messageLink like https://discord.com/channels/<guildId>/<channelId>/<messageId> .

• For stickers/polls/sendMessage: a to target (channel:<id> or user:<id> ). Optional content text.

• Polls also need a question plus 2–10 answers .

• For media: mediaUrl with file:///path for local files or https://... for remote.

• For emoji uploads: guildId , name , mediaUrl , optional roleIds (limit 256KB, PNG/JPG/GIF).

• For sticker uploads: guildId , name , description , tags , mediaUrl (limit 512KB, PNG/APNG/Lottie JSON).

Message context lines include discord message id and channel fields you can reuse directly.

Note: sendMessage uses to: "channel:<id>" format, not channelId . Other actions like react , readMessages , editMessage use channelId directly. Note: fetchMessage accepts message IDs or full links like https://discord.com/channels/&#x3C;guildId>/&#x3C;channelId>/&#x3C;messageId> .

Actions

React to a message

{ "action": "react", "channelId": "123", "messageId": "456", "emoji": "✅" }

List reactions + users

{ "action": "reactions", "channelId": "123", "messageId": "456", "limit": 100 }

Send a sticker

{ "action": "sticker", "to": "channel:123", "stickerIds": ["9876543210"], "content": "Nice work!" }

• Up to 3 sticker IDs per message.

• to can be user:<id> for DMs.

Upload a custom emoji

{ "action": "emojiUpload", "guildId": "999", "name": "party_blob", "mediaUrl": "file:///tmp/party.png", "roleIds": ["222"] }

• Emoji images must be PNG/JPG/GIF and <= 256KB.

• roleIds is optional; omit to make the emoji available to everyone.

Upload a sticker

{ "action": "stickerUpload", "guildId": "999", "name": "otto_wave", "description": "Otto waving hello", "tags": "👋", "mediaUrl": "file:///tmp/wave.png" }

• Stickers require name , description , and tags .

• Uploads must be PNG/APNG/Lottie JSON and <= 512KB.

Create a poll

{ "action": "poll", "to": "channel:123", "question": "Lunch?", "answers": ["Pizza", "Sushi", "Salad"], "allowMultiselect": false, "durationHours": 24, "content": "Vote now" }

• durationHours defaults to 24; max 32 days (768 hours).

Check bot permissions for a channel

{ "action": "permissions", "channelId": "123" }

Ideas to try

• React with ✅/⚠️ to mark status updates.

• Post a quick poll for release decisions or meeting times.

• Send celebratory stickers after successful deploys.

• Upload new emojis/stickers for release moments.

• Run weekly “priority check” polls in team channels.

• DM stickers as acknowledgements when a user’s request is completed.

Action gating

Use discord.actions.* to disable action groups:

• reactions (react + reactions list + emojiList)

• stickers , polls , permissions , messages , threads , pins , search

• emojiUploads , stickerUploads

• memberInfo , roleInfo , channelInfo , voiceStatus , events

• roles (role add/remove, default false )

• channels (channel/category create/edit/delete/move, default false )

• moderation (timeout/kick/ban, default false )

• presence (bot status/activity, default false )

Read recent messages

{ "action": "readMessages", "channelId": "123", "limit": 20 }

Fetch a single message

{ "action": "fetchMessage", "guildId": "999", "channelId": "123", "messageId": "456" }

{ "action": "fetchMessage", "messageLink": "https://discord.com/channels/999/123/456" }

Send/edit/delete a message

{ "action": "sendMessage", "to": "channel:123", "content": "Hello from Otto" }

With media attachment:

{ "action": "sendMessage", "to": "channel:123", "content": "Check out this audio!", "mediaUrl": "file:///tmp/audio.mp3" }

• to uses format channel:<id> or user:<id> for DMs (not channelId !)

• mediaUrl supports local files (file:///path/to/file ) and remote URLs (https://... )

• Optional replyTo with a message ID to reply to a specific message

{ "action": "editMessage", "channelId": "123", "messageId": "456", "content": "Fixed typo" }

{ "action": "deleteMessage", "channelId": "123", "messageId": "456" }

Threads

{ "action": "threadCreate", "channelId": "123", "name": "Bug triage", "messageId": "456" }

{ "action": "threadList", "guildId": "999" }

{ "action": "threadReply", "channelId": "777", "content": "Replying in thread" }

Pins

{ "action": "pinMessage", "channelId": "123", "messageId": "456" }

{ "action": "listPins", "channelId": "123" }

Search messages

{ "action": "searchMessages", "guildId": "999", "content": "release notes", "channelIds": ["123", "456"], "limit": 10 }

Member + role info

{ "action": "memberInfo", "guildId": "999", "userId": "111" }

{ "action": "roleInfo", "guildId": "999" }

List available custom emojis

{ "action": "emojiList", "guildId": "999" }

Role changes (disabled by default)

{ "action": "roleAdd", "guildId": "999", "userId": "111", "roleId": "222" }

Channel info

{ "action": "channelInfo", "channelId": "123" }

{ "action": "channelList", "guildId": "999" }

Channel management (disabled by default)

Create, edit, delete, and move channels and categories. Enable via discord.actions.channels: true .

Create a text channel:

{ "action": "channelCreate", "guildId": "999", "name": "general-chat", "type": 0, "parentId": "888", "topic": "General discussion" }

• type : Discord channel type integer (0 = text, 2 = voice, 4 = category; other values supported)

• parentId : category ID to nest under (optional)

• topic , position , nsfw : optional

Create a category:

{ "action": "categoryCreate", "guildId": "999", "name": "Projects" }

Edit a channel:

{ "action": "channelEdit", "channelId": "123", "name": "new-name", "topic": "Updated topic" }

• Supports name , topic , position , parentId (null to remove from category), nsfw , rateLimitPerUser

Move a channel:

{ "action": "channelMove", "guildId": "999", "channelId": "123", "parentId": "888", "position": 2 }

• parentId : target category (null to move to top level)

Delete a channel:

{ "action": "channelDelete", "channelId": "123" }

Edit/delete a category:

{ "action": "categoryEdit", "categoryId": "888", "name": "Renamed Category" }

{ "action": "categoryDelete", "categoryId": "888" }

Voice status

{ "action": "voiceStatus", "guildId": "999", "userId": "111" }

Scheduled events

{ "action": "eventList", "guildId": "999" }

Moderation (disabled by default)

{ "action": "timeout", "guildId": "999", "userId": "111", "durationMinutes": 10 }

Bot presence/activity (disabled by default)

Set the bot's online status and activity. Enable via discord.actions.presence: true .

Discord bots can only set name , state , type , and url on an activity. Other Activity fields (details, emoji, assets) are accepted by the gateway but silently ignored by Discord for bots.

How fields render by activity type:

• playing, streaming, listening, watching, competing: activityName is shown in the sidebar under the bot's name (e.g. "with fire" for type "playing" and name "with fire"). activityState is shown in the profile flyout.

• custom: activityName is ignored. Only activityState is displayed as the status text in the sidebar.

• streaming: activityUrl may be displayed or embedded by the client.

Set playing status:

{ "action": "setPresence", "activityType": "playing", "activityName": "with fire" }

Result in sidebar: "with fire". Flyout shows: "Playing: with fire"

With state (shown in flyout):

{ "action": "setPresence", "activityType": "playing", "activityName": "My Game", "activityState": "In the lobby" }

Result in sidebar: "My Game". Flyout shows: "Playing: My Game (newline) In the lobby".

Set streaming (optional URL, may not render for bots):

{ "action": "setPresence", "activityType": "streaming", "activityName": "Live coding", "activityUrl": "https://twitch.tv/example" }

Set listening/watching:

{ "action": "setPresence", "activityType": "listening", "activityName": "Spotify" }

{ "action": "setPresence", "activityType": "watching", "activityName": "the logs" }

Set a custom status (text in sidebar):

{ "action": "setPresence", "activityType": "custom", "activityState": "Vibing" }

Result in sidebar: "Vibing". Note: activityName is ignored for custom type.

Set bot status only (no activity/clear status):

{ "action": "setPresence", "status": "dnd" }

Parameters:

• activityType : playing , streaming , listening , watching , competing , custom

• activityName : text shown in the sidebar for non-custom types (ignored for custom )

• activityUrl : Twitch or YouTube URL for streaming type (optional; may not render for bots)

• activityState : for custom this is the status text; for other types it shows in the profile flyout

• status : online (default), dnd , idle , invisible

Discord Writing Style Guide

Keep it conversational! Discord is a chat platform, not documentation.

Do

• Short, punchy messages (1-3 sentences ideal)

• Multiple quick replies > one wall of text

• Use emoji for tone/emphasis 🦞

• Lowercase casual style is fine

• Break up info into digestible chunks

• Match the energy of the conversation

Don't

• No markdown tables (Discord renders them as ugly raw | text | )

• No ## Headers for casual chat (use bold or CAPS for emphasis)

• Avoid multi-paragraph essays

• Don't over-explain simple things

• Skip the "I'd be happy to help!" fluff

Formatting that works

• bold for emphasis

• code for technical terms

• Lists for multiple items

quotes for referencing

• Wrap multiple links in <> to suppress embeds

Example transformations

❌ Bad:

I'd be happy to help with that! Here's a comprehensive overview of the versioning strategies available:

Semantic Versioning

Semver uses MAJOR.MINOR.PATCH format where...

Calendar Versioning

CalVer uses date-based versions like...

✅ Good:

versioning options: semver (1.2.3), calver (2026.01.04), or yolo (latest forever). what fits your release cadence?