What a Twitch alert looks like
The preview above is the default alert: a role ping, "is now live on Twitch!", the stream link, then an embed with the stream title, the game, the viewer count and the stream thumbnail. Every part of it can be changed: rewrite the message, rebuild the embed or load a saved template. Variables fill in the live details for you:
- {channel.name}: the streamer name
- {stream.title} and {stream.game.name}: what the stream is about
- {stream.viewers}: the viewer count when the alert is posted
- {stream.url}: the link to the stream
- {ping.roles}: the roles you chose to ping
Set up Twitch notifications in three steps
No Twitch account or API key is needed.
- Add Koya to your Discord server.
- In the dashboard, open Twitch, search the streamer by name and pick the Discord channel for the alerts.
- Choose the roles to ping, adjust the message and save.
Koya posts through a webhook, so it needs the Manage Webhooks permission in that channel. In a forum channel, each stream opens its own post, titled after the stream. Alerts use the name and avatar of your custom bot profile, and Premium can set them per alert.
Only announce the streams that matter (Premium)
With Premium, each Twitch alert can wait for conditions: a required or excluded game, a minimum number of viewers, days of the week, an hour window (server timezone) and a minimum stream uptime. Conditions in the same group must all be met, and separate groups are alternatives: the alert goes out as soon as one group is met. Example for a team server: post if the stream is in Minecraft with at least 20 viewers, or once it has been live for 30 minutes.
What the example rule does at a check| Stream | Game | Viewers | Live for | Alert |
|---|
| A | Minecraft | 35 | 5 min | Posted: the first group is met |
|---|
| B | Just Chatting | 12 | 10 min | Waits, then posted once live for 30 min |
|---|
| C | Minecraft | 8 | 3 min | Waits for 20 viewers or 30 min live, whichever comes first |
|---|
Viewer and uptime conditions are rarely met the second a stream starts, so Koya posts the alert at its next check once they are. Checks run every hour, or every 2 minutes with fast mode.
When the stream ends (Premium)
With Premium, you decide what happens to the alert once the stream is over:
- Leave it as it is.
- Post a new end message, with the VOD link.
- Edit the live alert into an end message, with the VOD link.
- Delete it, so the channel only shows streams that are live.
Premium can also refresh the live alert every 5 minutes with the current title, game and viewers, and publish it automatically in announcement channels so that following servers get it too.
For streamers, teams and fan servers
Announcing your own stream? The free plan is enough: 1 Twitch channel with your message and your ping. A team or a collective can follow 10 channels on Premium, or unlimited on Pro, each with its own Discord channel, roles and conditions. On a fan server, ping a role that members pick for themselves, so only the people who want live alerts get them: let members pick the live ping role.
Free, Premium and Pro for Twitch alerts
What each plan includes for Twitch alerts. Every other limit is on the Premium and Pro limits page.
| Feature | Free | Premium | Pro |
|---|
| Twitch channels | 1 | 10 | unlimited |
|---|
| Go-live alert, message, embed and role pings | Yes | Yes | Yes |
|---|
| Backup check | Every hour | Every 2 minutes | Every 2 minutes |
|---|
| Conditions on game, viewers, schedule and uptime | No | Yes | Yes |
|---|
| End of stream and VOD link | No | Yes | Yes |
|---|
| Auto refresh and auto publish | No | Yes | Yes |
|---|
| Name and avatar per alert | No | Yes | Yes |
|---|
More than Twitch
The same dashboard posts YouTube videos, Kick streams, Bluesky posts, Reddit posts, RSS feeds and Spotify releases, each with its own channel and ping. See all social alert sources.
