Before you start, have the Twitch login name, YouTube channel or RSS feed URL ready. Kick alerts are unavailable on the hosted bot, so use Twitch, YouTube or RSS.
1. Turn on Social Feeds
Open the dashboard, pick the server, go to Services and turn on the Social & Patches switch.
Permissions you need
- The bot needs View Channel, Send Messages and Embed Links in each channel a feed posts to.
- Adding or changing feeds needs Edit on Social & Patches in your dashboard role. Owners have it. Managers have it by default.
2. Create the alert channels
Open the Setup tab and run Create / repair channels. Skip this if you already have a channel for alerts.
What it creates
It makes a "📡 Social Alerts" category with #patches, #streams and #creator-posts. Everyone can read and only the bot can post. Running it again keeps what exists. See Set it up.
3. Pick the kind of feed
Open the New Feed tab and choose a tile: Twitch Streamer, YouTube Channel or Generic RSS / Atom.
What each tile asks for
- Twitch Streamer takes the streamer's login name, such as "ninja".
- YouTube Channel takes a channel ID (UC...), an @handle or a youtube.com channel URL. A handle or URL is resolved when you save.
- Generic RSS / Atom takes any RSS 2.0 or Atom feed URL (https://...).
The Kick Streamer tile will not work on the hosted bot.
4. Choose where it posts and who gets pinged
Under Channel, thread or forum, pick the channel. To ping roles, pick them under Ping roles (optional).
Threads, forums and pings
- Threads get each item as a reply. Forums get one new post per item.
- Allow @everyone and @here is off by default.
- In an announcement channel, Publish to followers crossposts each item (Discord allows 10 per hour per channel).
5. Write the message
Leave Message text (optional) blank to use the default, or write your own with placeholders such as {display_name}, {title} and {url}. The Discord preview updates as you type.
The default message and keyword filters
- The Twitch default is "{role_mention} 🔴 {display_name} is live".
- Send an embed is on by default.
- For Twitch you can also choose what happens When the stream ends and set a Live role.
- The keyword filters Only post if it mentions and Never post if it mentions ignore case. An exclude match always wins.
6. Save the feed
Click Create Subscription.
When it starts posting
- A new feed does not post its backlog. The first check marks the newest item as seen, and posting starts with the next new item.
- Twitch feeds are checked every 120 seconds. YouTube and RSS feeds are checked every 900 seconds. You can change this in Poll interval (seconds).
- The bot looks for due feeds every 30 seconds.
7. Check that it works
On the Overview tab, press Test (posts for real) on your feed. The newest item that passes your keyword filters posts in the channel at once.
The feed's history and what to do if nothing posts
- A Twitch feed has an item only while the streamer is live. With no item, nothing is posted and the dashboard says "Source returned no items" for the feed.
- History lists the feed's last 100 items, Test posts included. An item that never reached Discord is marked "not posted".
- A feed that fails 5 checks one after another switches itself off and shows its last error. Fix the cause, usually the channel or the bot's permissions, then press Reset. Press Skip to current first if you want to avoid a backlog of old items.