This Cloudflare Worker is made to monitor a status page for incidents. If there is one, it will post into a Discord server (with optional publishing) and continously update the message with incident updates. This allows you to easily track incidents which may be impacting you right inside of Discord.
Want to see it in action?
We use this in the Cloudflare Discord, come check it out!
There are a few steps to the setup, but it should hopefully be pretty straightforward:
- Clone the repo
- Edit
src/config.ts
to set the status URL, name of the webhook, avatar and publish channel - Authenticate Wrangler with
npx wrangler login
, or set theCLOUDFLARE_ACCOUNT_ID
andCLOUDFLARE_API_TOKEN
environment variables (or put them in.env
) - Put your account ID in
wrangler.toml
(you can get this fromnpx wrangler whoami
) - Create the KV namespace with
npx wrangler kv:namespace create KV
- Put the namespace ID in
wrangler.toml
- Add Discord webhook with
npx wrangler secret put DISCORD_WEBHOOK
- (optional) If you want publishing, you'll also need to add a Discord bot token with
npx wrangler secret put DISCORD_TOKEN
- (optional) If you want publishing, you'll also need to add a Discord bot token with
- Run
npm run publish
:)
You can use the Discord API to automatically publish your webhook alerts to all of your announcement subscribers.
To get setup:
- Create a new or use a pre-existing Discord Application.
- Make note of your application id listed on the
General Information
page you are brought to. You will need this in step 5 to grant your user the correct permissions. - Add a bot to your newly created application by going under
Settings โ Bot
and pressingAdd Bot
. - Copy your
Bot Token
and insert it into your project withwrangler secret put DISCORD_TOKEN
, being careful to not expose it anywhere else. - We now need to add your bot user to the server. Using this feature requires your bot to have the
SEND_MESSAGES
andMANAGE_MESSAGES
permission, so we will need to grant them those permissions. Take the application id you noted in step 2, replacing the application id below and visiting the link in your browser.
https://discord.com/oauth2/authorize?client_id=INSERT-APPLICATION-ID&scope=bot&permissions=10240