Discord Bot

Use this app to interact with the Discord API using a bot in your account

Integrate the Discord Bot API with the HTTP / Webhook API

Setup the Discord Bot API trigger to run a workflow which integrates with the HTTP / Webhook API. Pipedream's integration platform allows you to integrate Discord Bot and HTTP / Webhook remarkably fast. Free for developers.

Add Role with Discord Bot API on New Requests from HTTP / Webhook API
HTTP / Webhook + Discord Bot
 
Try it
Create Channel Invite with Discord Bot API on New Requests from HTTP / Webhook API
HTTP / Webhook + Discord Bot
 
Try it
Create DM with Discord Bot API on New Requests from HTTP / Webhook API
HTTP / Webhook + Discord Bot
 
Try it
Create Guild Channel with Discord Bot API on New Requests from HTTP / Webhook API
HTTP / Webhook + Discord Bot
 
Try it
Delete Channel with Discord Bot API on New Requests from HTTP / Webhook API
HTTP / Webhook + Discord Bot
 
Try it
New Message in Channel from the Discord Bot API

Emit new event for each message posted to one or more channels

 
Try it
New Requests from the HTTP / Webhook API

Get a URL and emit the full HTTP event on every request (including headers and query parameters). You can also configure the HTTP response code, body, and more.

 
Try it
New Requests (Payload Only) from the HTTP / Webhook API

Get a URL and emit the HTTP body as an event on every request

 
Try it
New event when the content of the URL changes. from the HTTP / Webhook API

Emit new event when the content of the URL changes.

 
Try it
New Guild Member from the Discord Bot API

Emit new event for every member added to a guild

 
Try it
Add Role with the Discord Bot API

Assign a role to a user. Remember that your bot requires the MANAGE_ROLES permission. See the docs here

 
Try it
Create Channel Invite with the Discord Bot API

Create a new invite for the channel. See the docs here

 
Try it
Send any HTTP Request with the HTTP / Webhook API

Send an HTTP request using any method and URL. Optionally configure query string parameters, headers, and basic auth.

 
Try it
Create DM with the Discord Bot API

Create a new DM channel with a user. See the docs here and here

 
Try it
Send GET Request with the HTTP / Webhook API

Send an HTTP GET request to any URL. Optionally configure query string parameters, headers and basic auth.

 
Try it

Overview of Discord Bot

The Pipedream Discord app enables you to build event-driven workflows that interact with the Discord API. When you authorize the Pipedream app's access to your guilds, you can use Pipedream workflows to perform common Discord actions, or write your own code against the Discord API.

Getting Started

To use the Discord Bot integration, you'll need to create a Discord bot and add that bot to your server(s). Watch the 4 minute video below for a short tutorial:

  1. Create a new Discord Developer Application
  2. Within your new application, create a Bot
  3. Define the permissions you'd like the bot to have access to
  4. Open the OAuth URL generator tool under the OAuth2 menu
  5. Select the bot auth scope
  6. Copy and paste the URL into a new window
  7. Accept the permissions to install the bot on your server

Not sure if you need to use the Discord or the Discord Bot integration for your workflow? Here's are the general similarities and differences:

Discord and Discord Bot actions and triggers can both:

  • Listen to events on Discord channels, guilds, etc.
  • Perform actions like sending messages, managing channels, and members

However the Discord integration will perform actions with the official Pipedream Discord bot.

Using the Discord Bot integration will use a custom bot instead, with it's own name and photo.

New Messages in Channel

Create this source here.

This event source emits events each time a new message is delivered to a Discord channel. By default, it emits an event for every message.

When you create this source, you'll be prompted to connect your Discord Bot token (press Connect Account and then New to add your token). The source will use that token to list the guilds / channels that bot has access to.

We use Discord's API to poll for new messages in this channel once a minute, by default, but you can increase this to run up to once every 15 seconds, if you'd like.

The first time this source runs, it fetches up to the last 100 messages sent to your channel and stores the ID of the last message delivered to that channel. The next time the source runs, it polls your channel for messages sent after that ID.

By default, this event source is configured to emit an event for every new message in the channel. For example, if 5 messages are sent to the channel in one minute, the source will emit 5 events, one for each message. You can set the source to batch the events the source collects and emit them as a single event by setting the Emit messages as a single event parameter to true.

Emit messages as a single event

In this example, the source would emit a single event: an array of 5 messages.

Message content is empty or missing

If you've successfully authenticated your Discord Bot to Pipedream, but the incoming message data including content, embeds and attachments are empty; then your bot needs to apply for access to this messaging data.

At the time of writing, Discord only requires bots in 100 or more servers to apply for this access.

You can request for this approval in the Discord Developer Portal.

Connect Discord Bot

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
import { axios } from "@pipedream/platform"
export default defineComponent({
  props: {
    discord_bot: {
      type: "app",
      app: "discord_bot",
    }
  },
  async run({steps, $}) {
    return await axios($, {
      url: `https://discord.com/api/users/@me`,
      headers: {
        "Authorization": `Bot ${this.discord_bot.$auth.bot_token}`,
      },
    })
  },
})

Connect HTTP / Webhook

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
export default defineComponent({
  props: {
    http: {
      type: "http_request",
      default: {
        method: "GET",
        url: "http://api.open-notify.org/iss-now.json",
      }
    }
  },
  async run({steps, $}) {
    return await this.http.execute()
  },
})

Community Posts

A Look at Pipedream
A Look at Pipedream
I'm going to build a workflow that will search Twitter every hour for a keyword. It will take the results, format them nicely, and then email it.
Building a Traffic-Based Workflow in Pipedream
Building a Traffic-Based Workflow in Pipedream
Normally I don't like to blog about stuff that isn't generally available to all, but as it will be available sometime soon, I decided to go ahead anyway. And I built something really cool I want to share so that's another reason to talk about this now!