Skip to main content

Notifications (Discord)

Easel can send a message to your Discord whenever players are online in your game. The message will include a link to your game, so that players can click it and join your game immediately, which can help you grow your playerbase and keep your game active. A lot of people keep Discord open all day, so this is a great way to reach your players immediately when there is someone else online to play with.

Discord notification example

How it works​

  1. Every minute, Easel counts the number of players currently online in your game (excluding private parties).
  2. Whenever the count changes, Easel sends a message to your Discord, as long as enough time has passed since the last message.
  3. Players see the message, click the link and join your game!
tip

Advertise your Discord server in your game, and encourage your players to join it so that they can get notified when other players are online.

What is a webhook?​

To be able to post messages to your Discord, Easel uses a webhook. A webhook is a URL that external services like Easel can publish messages to. Discord will then post those messages to the channel you configure.

The URL looks something like this:

https://discord.com/api/webhooks/1234567789012345678/aBcdeFghiJklmNopQrsTuvwYzABCdEFgHIjKLmNOpQRStUVwX_AbCdEfgh_aBcDeFGH_

The URL is quite long because it contains a secret token that authorizes Easel to post messages to your Discord channel. Make sure to keep your webhook URL secret, and do not share it with anyone you do not trust.

tip

When you make a webhook in Discord, you can configure the profile picture and name of the webhook. This helps your players easily recognize the messages from your game in Discord.

Setting up a Discord Webhook​

Go to Discord and create a webhook using the following instructions:

  1. In your server settings, go to Integrations and click Create Webhook.
  2. Give your webhook a name, a profile picture and select the channel you want messages to be sent to.
  3. Copy the Webhook URL.

Now go to Easel and set up the webhook:

  1. Open the Easel editor
  2. Find the game you want to set up messages for and click the cog icon to open its game settings.
  3. Switch to the Notifications tab
  4. Paste the webhook URL you copied from Discord into the Webhook URL field.
  5. Click Save to save your changes.

To test your new webhook, enter your game. After about 1 minute, you should see a message in your Discord server.

Cooldown period​

In order to avoid spamming your Discord channel, Easel will wait for a cooldown period before sending another message whenever the player count changes. The cooldown period is as follows:

  • When the player count increases: 1 minute between messages
  • When the player count decreases: 5 minutes between messages

What about other messaging platforms?​

At this time, only Discord is supported for notifications. If you would like support for other platforms like Slack, Zulip or Discourse, please let us know!