Discord Bot API Integrations

Overview#

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.

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}`,
      },
    })
  },
})

Choose an API to Connect with Discord Bot API#

1
-
12
of
1000+
apps by most popular

HTTP / Webhook

Get a unique URL where you can send HTTP or webhook requests

Node

Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.

Python

Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.

Schedule

Trigger workflows on an interval or cron schedule.

Data Stores

Use Pipedream Data Stores to manage state throughout your workflows.

Google Sheets

With Google Sheets, you can create, edit, and collaborate wherever you are

Airtable

Looks like a spreadsheet, acts like a database.

Telegram Bot

Telegram is a cloud-based instant messaging and voice over IP service

Slack

Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.

Formatting

Pre-built actions to make formatting and manipulating data within your workflows easier.

GitHub

Where the world builds software. Millions of developers and companies build, ship, and maintain their software on GitHub—the largest and most advanced development platform in the world.

Filter

Specify a condition that your workflow must meet and whether you'd like to proceed or end workflow execution.

a b c d e f g h i j k l m n o p q r s t u v w x y z #

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:

Create a new Discord Developer Application
Within your new application, create a Bot
Define the permissions you'd like the bot to have access to
If your bot will need to list other members of a guild, make sure to enable the Server Members Intent toggle on the Bot configuration page
Open the OAuth URL generator tool under the OAuth2 menu
Select the bot auth scope
Copy and paste the URL into a new window
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.

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.