Discord

Create and manage community interactions with bots and webhooks.

Using the Discord API with Trigger.dev

You can use Trigger.dev with any existing Node SDK or even just using fetch. Using io.runTask makes your Discord background job resumable and appear in our dashboard.

Use io.runTask() and the official SDK or fetch.

Use our HTTP endpoint to subscribe to webhooks

Example code using Discord

Below are some working code examples of how you can use Discord with Trigger.dev. These samples are open source and maintained by the community, you can copy and paste them into your own projects.

Create a Discord bot and send a message to a channel.A job that is triggered by a Discord webhook.

1
import nacl from "tweetnacl";
2
import { TriggerClient } from "@trigger.dev/sdk";
3
const verifyRequestSignature = async (request: Request): Promise<any[]> => {
4
  const body = await request.text();
5
  const jsonBody = JSON.parse(body);
6
  const signature = request.headers.get("x-signature-ed25519");
7
  const timestamp = request.headers.get("x-signature-timestamp");
8
  const discordKey = process.env.DISCORD_APPLICATION_KEY;
9
  if (!discordKey || !signature || !timestamp) return [false, jsonBody];
10
  return [
11
    nacl.sign.detached.verify(
12
      Buffer.from(timestamp + body),
13
      Buffer.from(signature, "hex"),
14
      Buffer.from(discordKey, "hex")
15
    ),
16
    jsonBody,
17
  ];
18
};
19

20
const discord = client.defineHttpEndpoint({
21
  id: "discord",
22
  source: "discord.com",
23
  icon: "discord",
24
  // This is only needed for APIs like Discord which don't setup the webhook until you pass the test
25
  respondWith: {
26
    // Don't trigger runs if they match this filter
27
    skipTriggeringRuns: true,
28
    filter: {
29
      method: ["POST"],
30
    },
31
    handler: async (request) => {
32
      const success = await verifyRequestSignature(request);
33
      // If Discord signature and timestamp don't match, return 401
34
      if (!success[0]) return new Response("Unauthorized", { status: 401 });
35
      // If successful, get the Interaction Type sent by Discord of the request
36
      const { type } = success[1];
37
      // If it's type 1, it's a PING from discord, just respond with the type as is
38
      if (Number(type) === 1)
39
        return new Response(JSON.stringify({ type }), {
40
          headers: { "Content-Type": "application/json" },
41
        });
42
      // If it's type 2, it's a Slash Command from Discord, respond with what you want to be replied
43
      if (Number(type) === 2)
44
        return new Response(
45
          JSON.stringify({
46
            type: 4,
47
            data: {
48
              content: `Hello, New!`,
49
            },
50
          }),
51
          { headers: { "Content-Type": "application/json" } }
52
        );
53
      // If not either of the above types, just return a 400
54
      return new Response(JSON.stringify({ error: "bad request" }), {
55
        status: 400,
56
      });
57
    },
58
  },
59
  verify: async (request) => {
60
    const success = await verifyRequestSignature(request);
61
    if (success[0]) return { success: success[0] };
62
    return { success: false, reason: "Failed ed25519 verification" };
63
  },
64
});
65

66
// A job that runs when the HTTP endpoint is called from Discord
67
client.defineJob({
68
  id: "http-discord",
69
  name: "HTTP Discord",
70
  version: "1.0.0",
71
  enabled: true,
72
  // Create a trigger from the HTTP endpoint
73
  trigger: discord.onRequest(),
74
  run: async (request, io, ctx) => {
75
    const body = await request.json();
76
    await io.logger.info(`Body`, body);
77
  },
78
});