Notifications, alerts & webhooks
Stream alerts, repeating messages and webhook announcements with any name and picture.
#Stream alerts
- Open Dashboard → your server → Notifications.
- Press + Add an alert (②) — or click an existing alert (①) to edit it.
- Pick the platform (Kick / Twitch / YouTube, or a feed link) and the streamer, the Discord channel to post in, the style, and an optional role to ping.
- Save. Apera posts the moment they go live. (One alert per channel or account; up to 60.)
On Notifications, add a Kick or Twitch channel (or a feed link) and the Discord channel to post in. Apera posts when the stream goes live, with an optional role ping.
#What to enter, and where the data comes from
| Platform | Type | Alerts for | Data comes from |
|---|---|---|---|
| YouTube | @handle or channel ID (UC…) | New videos & Shorts, live streams | The channel’s public video feed and its /live page |
| Kick | Channel name (e.g. xqc) | Live streams | Kick’s public channel API: title, category, viewers, thumbnail |
| Twitch | Channel name | Live streams | Twitch’s API if you add a Twitch app, otherwise the public decapi.me service |
| TikTok | Username (e.g. khaby.lame) | New videos, live | The public profile page (video count and live room) |
| X / Other | An RSS feed link (e.g. from rss.app) | New posts | The feed itself |
Apera checks every 2 minutes. It never announces a stream that was already running when you added the alert, and one stream is announced once — not every check.
#What the alerts look like
Pick a style for each alert:
- Card (default) — who it is with their picture, platform, category and viewers, the title as a link with a Watch button on its right, and the big stream or video thumbnail.
- Embed — the classic Discord embed with the same details and the buttons under it.
- Plain text — one line and the link; Discord shows its own preview.
Add a ping role to mention it, and a Discord user to give them that role while they are live. A custom message replaces the alert’s first line in every style. The Try Apera button can be switched off at the top of the page.
#Is it working? Status and test
You don’t do anything when you go live — Apera checks on its own every 2 minutes. Each alert on the Notifications page shows what the last check saw: 🔴 Live now, ⚫ Offline, ✅ Watching (uploads) or ⚠ Couldn’t reach the platform, with the time, and 📣 when it last posted. After saving, press Send test alert to post one right away in the chosen style.
#Repeating messages
/notifications automsg-add channel:#general message:… minutes:120 reposts a reminder every two hours.
#Webhook manager
On Webhook manager, write an announcement and send it as any name and picture. You can add a button that gives members a role (roles with staff permissions are never allowed).
Commands in this guide
Next steps
Was this page helpful?
Thanks for telling us!