Skip to main content

Discord

Discord Bot Requirements​

To send notifications via Discord, a Discord Bot is required. You may use an existing or create a new basic bot.

Scopes​

When you create the install link for your bot, make sure it has the bot scope with at least View Channels and Send Messages permissions. If you would like to send a message as a reply to another message, your bot will also need the Read Message History permission.

Profiles Requirements​

The information required in the recipient profile is different based on the type of message you are sending.

Sending a Direct Message​

To send a message to a user, you'll need to supply the discord profile object with a user_id. This is not the user tag. You can retrieve this value using the Discord API or copying it from a Discord Client in Developer mode. The user you are trying to message must be a member of a server the bot is installed in.

JSON
{
  "message": {
    // Recipient Profile
    "to": {
      "discord": {
        "user_id": "617099137532932107"
      }
    }
  }
}

Sending a Message to a Channel​

To send a message to a channel, you'll need to supply the discord profile object with a channel_id. You can retrieve this value using the Discord API or copying it from a Discord Client in Developer mode. The bot must be installed in the server to send to the channel.

JSON
{
  "message": {
    // Recipient Profile
    "to": {
      "discord": {
        "channel_id": "768866348853383208"
      }
    }
  }
}

Override​

You can use a provider override to replace what we send to Discord's Create Message endpoint. For example, you can choose to an an embed.

JSON
{
  "message": {
    "template": "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
    "to": {
      "discord": {
        "channel_id": "768866348853383208"
      }
    },
    "providers": {
      "discord": {
        "override": {
          "body": {
            "embed": {
              "title": "Hello, Embed!",
              "description": "This is an embedded message."
            }
          }
        }
      }
    }
  }
}