Apera DocsBeta

Notifications, alerts & webhooks

Stream alerts, repeating messages and webhook announcements with any name and picture.

Open in dashboard 6 sections

#Stream alerts

  1. Open Dashboard → your server → Notifications.
  2. Press + Add an alert (②) — or click an existing alert (①) to edit it.
  3. 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.
  4. 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

PlatformTypeAlerts forData comes from
YouTube@handle or channel ID (UC…)New videos & Shorts, live streamsThe channel’s public video feed and its /live page
KickChannel name (e.g. xqc)Live streamsKick’s public channel API: title, category, viewers, thumbnail
TwitchChannel nameLive streamsTwitch’s API if you add a Twitch app, otherwise the public decapi.me service
TikTokUsername (e.g. khaby.lame)New videos, liveThe public profile page (video count and live room)
X / OtherAn RSS feed link (e.g. from rss.app)New postsThe feed itself
💡
Tip

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

#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