Discord

Send messages to Discord channels and fetch mentions

Actions

Get Last Mention Get the most recent message that mentions the Discord bot in a channel

Send Text Message Send a text message to a Discord channel

Instructions

To set up Discord integration:

Go to the Discord Developer Portal (https://discord.com/developers/applications)
Click New Application and give it a name
Go to OAuth2 → URL Generator:
- Under Scopes, select bot
- Under Bot Permissions, select View Channels, Send Messages, and Read Message History
- Copy the generated URL and open it in a new tab to invite the bot to your server
Go to the Bot section:
- Click Add Bot (if not already added)
- Uncheck the Public Bot option
- Under Token, click Reset Token then Copy to get your bot token
Paste the Bot Token in the Bot Token field below

Get Last Mention

Component key: discord.getLastMention

The Get Last Mention component fetches recent messages from a Discord channel and returns the latest one that mentions your bot.

Use Cases

Command polling: Retrieve the most recent mention command in a channel
Manual workflows: Pull latest bot mention on demand in a workflow step
Mention auditing: Inspect the latest mention payload before replying

Configuration

Channel: Discord channel to search for mentions
Since: Optional date string lower-bound for mentions (only mentions at or after this time are considered). Supports expressions. Accepted formats include ISO 8601 (recommended) and Go’s default timestamp format (e.g. 2026-03-16 04:17:08.750328135 +0000 UTC).

Output

The payload includes:

channel_id: Channel queried
mention: Full message payload for the latest bot mention (when found)

Output channels:

found: Emitted when a matching mention is found
notFound: Emitted when no matching mention is found

Notes

Requires the bot permission Read Message History in the selected channel
Only non-bot-authored messages are considered
Datetimes without timezone in Since are interpreted as UTC

Example Output

{
  "data": {
    "channel_id": "1381731186335651880",
    "mention": {
      "author": {
        "bot": false,
        "id": "98432147091234567",
        "username": "pedro"
      },
      "channel_id": "1381731186335651880",
      "content": "\u003c@1372980427293554709\u003e can you run /deploy?",
      "guild_id": "1381731029892325376",
      "id": "1381731283190517770",
      "mentions": [
        {
          "bot": true,
          "id": "1372980427293554709",
          "username": "superplane-bot"
        }
      ],
      "timestamp": "2026-03-10T15:04:05.000Z"
    }
  },
  "timestamp": "2026-03-10T15:04:05.000Z",
  "type": "discord.getLastMention.result"
}

Send Text Message

Component key: discord.sendTextMessage

The Send Text Message component sends a message to a Discord channel.

Use Cases

Notifications: Send notifications about workflow events or system status
Alerts: Alert teams about important events or errors
Updates: Provide status updates on long-running processes

Configuration

Channel: Select the Discord channel to send the message to
Content: Plain text message content (max 2000 characters)
Embed Title: Optional title for a rich embed
Embed Description: Optional description for a rich embed
Embed Color: Hex color code for the embed (e.g., #5865F2)
Embed URL: Optional URL to link from the embed title

Output

Returns metadata about the sent message including message ID, channel ID, and author information.

Notes

Either content or embed (title/description) must be provided
The Discord bot must be installed and have permission to post to the selected channel
Supports Discord’s rich embed formatting for visually appealing messages

Example Output

{
  "data": {
    "author": {
      "bot": true,
      "id": "1111111111111111111",
      "username": "Webhook"
    },
    "channel_id": "9876543210987654321",
    "content": "Hello from SuperPlane",
    "id": "1234567890123456789",
    "timestamp": "2026-01-16T12:00:00.000Z"
  },
  "timestamp": "2026-01-16T17:56:16.680755501Z",
  "type": "discord.message.sent"
}