docs(discord): document sendMessage mediaUrl and to format

- Add example for sendMessage with media attachment (file:// and https://)
- Clarify that sendMessage uses 'to: channel:<id>' not 'channelId'
- Document replyTo parameter for replying to specific messages
- Add mediaUrl to inputs section
This commit is contained in:
Peter Steinberger
2026-01-03 11:05:09 +00:00
parent f47c7ac369
commit daa1460502
2 changed files with 20 additions and 1 deletions

View File

@@ -12,11 +12,14 @@ Use `discord` to manage messages, reactions, threads, polls, and moderation. You
## Inputs to collect
- For reactions: `channelId`, `messageId`, and an `emoji`.
- For stickers/polls: a `to` target (`channel:<id>` or `user:<id>`). Optional `content` text.
- For stickers/polls/sendMessage: a `to` target (`channel:<id>` or `user:<id>`). Optional `content` text.
- Polls also need a `question` plus 210 `answers`.
- For media: `mediaUrl` with `file:///path` for local files or `https://...` for remote.
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.
## Actions
### React to a message
@@ -116,6 +119,21 @@ Use `discord.actions.*` to disable action groups:
}
```
**With media attachment:**
```json
{
"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
```json
{
"action": "editMessage",