Live Alerts
This guide will walk you through the process of setting up Twitch live alerts for your Discord server.
What are Live Alerts?
Live alerts display notification messages in a specified channel in your Discord server when the chosen user goes live on Twitch. These messages can be automatically updated or removed when the stream ends.
The Live Alerts List Page
Select the Live Alerts tab from the sidebar in the web dashboard.
Afterwards, you will be presented with the list screen. In my example screenshot, I have one alert setup for my own stream.
the + button can be used to add a new alert. Clicking on an existing alert will take you to edit the alert.
The number next to the Alerts title denotes how many alerts you have and your maximum allowed alerts (in this example, 1 out of 25). This limit can be increased if needed by contacting me.
Adding a new alert
Click the + button to add a new alert.
The alert builder is setup into sections to make it easy to follow the steps required to create one.
Section 1 - Channel & Message
This section just contains the Twitch username of the channel you want to shout out, and the custom message you want to use.
The channel name box will let you know if the username you entered was correct or not. If the user doesn’t exist, it will show an error. You can also confirm you have the right user by checking the preview in Step 5 has the same profile picture as the user you are intending to add.
The custom message box allows you to specify the message that is sent in the Discord message for the live alert. Note that this will not be used in the embed, just the message itself, and can be left empty if you just want the live embed and no custom message.
There are some parameters you can use that will be replaced by their values when the alert is sent, and also in the preview in Step 5.
Note
Available Parameters You can use the following parameters in your custom message (typing the first open brace will present an autocomplete list)
| Parameter | Description |
|---|---|
{{ChannelName}} | The Twitch username |
{{GameName}} | The game being played |
{{Title}} | The stream title |
{{url}} | The stream URL |
Use @ to mention any of your Discord roles and : to add your custom server emotes. Start typing and it will search and display a list.
Section 2 - Alert Options
These options allow you to set the behaviour for when the channel goes offline, and also if you want to use a custom Discord embed in place of the default link preview.
| Option | Description |
|---|---|
| Auto Delete | If this is enabled, when the channel goes offline the whole alert message will be deleted. Note that this sometimes causes Discord to leave the channel the message is in as unread even after the message is removed. |
| Auto Update | If this is enabled, when the channel goes offline the message will get |
| Enable Embed | Enables a custom embed to be used in place of the default Discord link preview. |
Section 3 - Conditions
This section may be a bit more complex and is completely optional. It allows you to specify conditions that must be met for the alert to be sent (such as only sending alerts if the streamer is streaming in a specific category - in the below example image, we only send live alerts if the streamer is playing either Euro Truck Simulator 2 or American Truck Simulator)
The Condition Mode specifies if it requires only one of the conditions to be met (OR), or if it requires all conditions to be met (AND).
There are currently 4 kinds of conditions that can be used:
1. Category
This is the condition we use in the example image above. It allows you to specify any number of Twitch categories (it will search as you type so you can pick the right one), and will only send the alert if the streamer is playing one of the specified categories.
2. Time (UTC)
This is a condition that allows you to only send the alert if a user goes live within a specific timeframe (so say you only wanted an alert if they go live between 5PM and 10PM).
3. Title
This condition allows you to only send the alert based on the title of the stream. You can check if it contains certain phrases, exactly equels a phrase, or exactly does NOT equal a phrase.
4. Language
This condition allows you to only send the alert if the streamer has their stream tagged in a specific language. For example, you could set en if you have a streamer that sometimes streams in English and sometimes in another language but your community is only English speaking - this will then filter out their streams if it is not an English stream.
Section 4 - Webhook & Delivery Channel
This section allows you to configure where the live alert is sent, and how it is sent.
The first option in this section is a Discord channel. If you are using a webhook, this channel will NOT be used but IS still required to be set as a fallback if the webhook is no longer available. So if you intend to use a webhook, you can (if you like) just pick any channel from this list, it is pretty unlikely it will ever be used.
The second option is saved/global webhooks. These webhooks can be configured in your Guild settings and be re-used across multiple live alerts, this is the recommended way to configure webhooks.
The third option is alert specific webhooks - this can be used to setup a webhook that is only for this alert, so you can customise them per streamer.
Creating Webhooks
You can see a guide on creating webhooks in Discord on the Guild Configuration -> Webhooks page.
Section 5 - Preview & Save
This section contain the save button, but also a preview of what your message will look like when it is sent. When you change options in your alert, this preview will update automatically. It properly supports previewing the webhooks, and both the url preview and custom embeds. When you are happy with all your settings, hit Save and your alert will be created!
