Connecting Uptime Robot to Discord without third party services - brainboxdotcc/tutorials-and-howto GitHub Wiki
This tutorial will guide you through how to connect uptime robot to discord, providing nice looking notifications via a webhook without any third party services.
There are many other ways to do this with third party services, most commonly by using a simple discord.js bot, or by using a service such as Pushbullet. If you don't feel the need for any such extra system in the way which you either need to pay for or maintain, then read on. This tutorial is for you.
Difficulty Level | Easy |
Reading Time | Five minutes |
Version | 1.0 |
Prerequisites |
• Discord server with manage webhooks permission • Pro account with Uptime Robot • Some services you want monitored, and reported to discord channels! |
Firstly, you must create a webhook in discord. I chose to give mine the icon of the uptime robot service, and the nickname "Uptime Robot", but you can choose whatever icon and name you like. What's important here is that we copy the url on this page and save it, as we'll need it in the next step.
To make uptime robot talk to discord, you must now set up the webhook as alert contacts in the settings. Go into your settings on uptime robot and add two new alert contacts, both of type 'webhook'. Call one "Discord (up, green)
" and the other "Discord (down, red)
".
Note that we create two webhook alerts, one for up events and one for down events. This is because one of them has a duration field we can use and the other does not, and we want our down events to have a red border on the embed, and the up events to have a green border.
Be sure to fill in the following details:
This alert contact sends an embed with a red border and no duration field.
Field | Value |
---|---|
URL To Notify | Enter your discord webhook URL, but place ?z& on the end of the webhook URL. This ensures it's unique so we can have two of them, one for up and one for down |
Send As JSON | Check this Box |
Send default variables as form parameters | Uncheck this box |
Enable Notifications For | Only Down Events |
Get SSL expiration reminder notifications | Uncheck this, if available in your plan |
{
"content": "",
"embeds": [
{
"author": {
"name": "Sporks Service Status",
"url": "<enter the url of your system>"
},
"title": "Service Status Announcement",
"url": "<enter the url of your system>",
"description": "Service ***monitorFriendlyName*** is ***alertTypeFriendlyName***",
"color": 16711680,
"fields": [ { "name": "Details", "value": "*alertDetails*"}
]
}
]
}
This alert contact sends a discord embed with a green border and a duration field.
Field | Value |
---|---|
URL To Notify | Enter your discord webhook URL, followed by ? only. Discord requires a webhook to end with & or ? for some reason. |
Send As JSON | Check this Box |
Send default variables as form parameters | Uncheck this box |
Enable Notifications For | Only Up Events |
Get SSL expiration reminder notifications | Uncheck this, if available in your plan |
{
"content": "",
"embeds": [
{
"author": {
"name": "Sporks Service Status",
"url": "<enter the url of your system>"
},
"title": "Service Status Announcement",
"url": "<enter the url of your system>",
"description": "Service ***monitorFriendlyName*** is ***alertTypeFriendlyName***",
"color": 65280,
"fields": [ { "name": "Details", "value": "*alertDetails*"},
{
"name": "Duration",
"value": "*alertDuration*",
"inline": true
}
]
}
]
}
Once entered these will look similar to the screenshot below:
Once you have created these alert contacts you need to go into each monitor event in turn within your dashboard on uptime robot, and assign both alert contacts to the monitor as shown below:
If you want, you can give it a test by creating a test monitor of type "keyword", pointing to www.google.com and looking for, for example 'sausages' on the homepage. This will always fail, and can be toggled to 'keyword not found' to test that both the up and down events fire on discord as you expect:
If you see events in discord, as above, then all is working, and you're done. You've now successfully set up uptime robot to push events to discord without third party software in between. Enjoy!