discord-send-message

Discord Send Message

Send messages to Discord channels using the Discord API v10. This skill supports plain text messages, formatted markdown content, and embeds.

When to Use This Skill

Use this skill when the user wants to:

• Send a message to a Discord channel
• Post a notification or announcement
• Send formatted text with markdown
• Post embeds with rich content
• Reply to or interact with Discord programmatically

Prerequisites

• DISCORD_BOT_TOKEN environment variable must be set
• Bot must be a member of the target server
• Bot must have "Send Messages" permission in the target channel
• Valid Discord channel ID (18-19 digit snowflake ID)

Instructions

When the user requests to send a Discord message:

1. Validate Requirements

   • Confirm DISCORD_BOT_TOKEN is set in environment
   • Verify channel ID is provided (18-19 digit number)
   • Check that message content is not empty

2. Prepare the Message

   • Extract the message content from user request
   • Format any markdown if needed (Discord supports markdown)
   • For embeds, structure as JSON with title, description, color, fields, etc.

3. Make the API Request Use the following curl command structure:

   curl -X POST "https://discord.com/api/v10/channels/{CHANNEL_ID}/messages" \
     -H "Authorization: Bot ${DISCORD_BOT_TOKEN}" \
     -H "Content-Type: application/json" \
     -d '{"content": "Your message here"}'
   

   Replace:

   • {CHANNEL_ID} with the actual channel ID
   • "Your message here" with the actual message content

4. Handle Response

   • Success (200): Message sent successfully, return message ID
   • 401 Unauthorized: Invalid bot token
   • 403 Forbidden: Missing permissions or bot not in server
   • 404 Not Found: Channel doesn't exist or bot can't see it
   • 400 Bad Request: Invalid message content

5. Report Results

   • Confirm message was sent successfully
   • Provide the message ID for reference
   • If error occurs, explain the issue clearly