Log in

Post, react and read Discord messages from your bot

The Discord power-ups let your bot do more in your Discord server than reply to the person who asked. It can post in other channels, react to messages, start threads and forum posts, and read what's been said.

Power-upWhat the bot can do
Discord Send MessagePost a message to a channel or thread, optionally as a reply to a message.
Discord Add ReactionReact to a message with an emoji, such as ✅ or 👀.
Discord Create ThreadStart a thread in a text channel (optionally from a message), or a new post in a forum channel.
Discord Get Channel HistoryRead up to 100 messages from a channel at a time, and page back to older ones.

Example uses: react with ✅ when the bot has answered a question, move a long support conversation into its own thread, log a bug report as a post in your #bugs forum, post a heads-up in #support when someone needs a person, or answer "What was discussed in #general today?"

🚨

Connect the Discord channel first

The Discord power-ups use your bot's Discord connection, so they need the Discord channel, which is included on the Standard, Pro and Enterprise plans. Set it up before adding them. Until you do, the power-up's settings page shows Discord channel not setup.

Before you start

  • Who can do this: team owners and admins.
  • Your bot is connected to your server through the Discord channel.
  • The bot's role can see the channels you want it to use, and has the Discord permissions for each power-up: Send Messages (and Send Messages in Threads) to post, Add Reactions to react, Create Public Threads to start threads (forum posts only need Send Messages), and Read Message History to read history. Bots added with the Gateway transport ask for all of these when you click Add to Discord, but a channel's own permission settings can still take them away.

Steps

  1. Open your bot, go to the Power-ups tab and click New power-up.
  2. Choose the Discord power-up you want and click Create power-up. Add each one you need separately.
  3. Edit the Power-up name and Description. The description tells the bot when to use it. For example:
    • Discord Send Message: "When a user asks to talk to a person, post a short summary of their problem in #support."
    • Discord Add Reaction: "React with ✅ to the user's message once you have answered their question."
    • Discord Create Thread: "When a user reports a bug, create a post in the bugs forum with the steps they described."
    • Discord Get Channel History: "Use this to read recent messages in a channel when the user asks what's been discussed there."
  4. For Discord Send Message, Discord Create Thread and Discord Get Channel History, optionally choose a Channel under Channel settings. If you do, the bot can only use that channel. Leave it blank to let the bot choose a channel by name or ID. Discord Create Thread also lists forum channels.
    Discord get channel history settings with the power-up name, description and an optional Channel dropdown
  5. Click Save.

The bot's normal replies already go to the conversation it's in, so you don't need Discord Send Message for that. Use it to post somewhere else.

Messages the bot posts can mention people and roles, but never ping @everyone or @here. Messages longer than Discord's 2,000-character limit are split into several messages.

Check it works

In Discord, @mention your bot and try each power-up you added:

  • "Post 'Testing' in #general." The message should appear in #general.
  • "React to my message with a thumbs up." A 👍 should appear on your message.
  • "Start a thread called Test thread." A new thread should appear in the channel.
  • "What was discussed in #general today?" The bot should reply with a summary of that channel.

You can also open View details on the power-up call in the dashboard to see what the bot sent and what Discord returned.

Troubleshooting

The bot says it doesn't have permission

The bot's role is missing the Discord permission for that action in that channel. In Discord, open the channel's Edit Channel > Permissions, select the bot's role, and allow the permission named in Before you start. Then try again.

The bot posts to the wrong channel

Choose a fixed Channel in the power-up settings, or name the channel in the Description.

The bot can't post in a forum channel

Forum channels hold posts, not messages. Use Discord Create Thread to start a new post there. A new forum post always needs an opening message.

The bot can't react with a custom emoji

The bot can only use custom emoji from servers it is in. Standard emoji always work.

Last updated