messages_send
messages_send
Section titled “messages_send”Category: messages
Send a plain-text message to a Discord channel.
When to use
Section titled “When to use”- Reply to user request like “send X to #channel”.
- Programmatic announcements without rich layout.
When NOT to use
Section titled “When NOT to use”- Rich layout (containers, sections, media galleries) → use
components_v2_send. - High-volume delivery → use
webhooks_execute(avoids bot rate limit).
| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Target channel ID |
content | string | yes | Message text content (max 2000 chars). |
tts | boolean | no | Text-to-speech, default false |
Returns
Section titled “Returns”\{message_id, channel_id, jump_url, timestamp\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
message_id | string | yes | Discord message ID |
channel_id | string | yes | Discord channel ID (snowflake) |
jump_url | string | yes | |
timestamp | string | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | no |