🖨️Receiving webhooks

Receiving webhooks is an important part of your bot if you want to reliably offer voting rewards to your users. Discords.com offers both voting and review webhooks.

Setting up webhooks

Webhooks can be set up on your bot's edit page, which you can find on your user profile. Go to Discords.com, navigate to the bots section, log in (if you haven't already), click on your profile picture in the top right corner, scroll down and you'll see a list of your bots.

Webhook URL

The webhook URL is the address where we will POST the webhook to. Make sure that a webserver is running on the other site that allows POST requests to be received.

If you only want notifications when someone votes, you can put in a Discord webhook URL, make sure not to remove the authorization key from the URL as it is necessary.

Webhook Secret

This is a secret value only your server and Discords.com should know. We will send that value along as an Authorization header so that you can verify the request came from us.

We are currently working on integrating HMAC encryption for those of you who will want better authentication in the future. Join our Discord server to get the latest development updates.

---

Sample webhook responses

// Regular upvote
{
  "user": "254287885585350666",
  "bot": "621352902656524288",
  "query": {
    "cast": "/bots/bot/621352902656524288/vote"
  },
  "engine": "IridiumNode-v16.18.1",
  "type": "vote"
}

// Premium upvote
{
  "user": "254287885585350666",
  "bot": "621352902656524288",
  "query": {
    "cast": "/bots/bot/621352902656524288/vote"
  },
  "engine": "IridiumNode-v16.18.1",
  "type": "premium_vote"
}

// Review
{
  "user": "254287885585350666",
  "bot": "621352902656524288",
  "stars": 5,
  "content": "This is some sample content",
  "engine": "IridiumNode-v16.18.1",
  "type": "review"
}