MediaHooks

MediaHooks is Raptor's centralized notification system for third-party media platforms. Currently, it supports YouTube, Twitch, and Bluesky, allowing you to keep your community informed the moment new content is released.

Features

• Notifications: Raptor will notify your server when a new video is uploaded or a stream goes live.
• Custom Templates: Full control over the wording and format of your announcements.

Getting Started

To manage your MediaHooks, navigate to your server's dashboard and select MediaHooks from the sidebar.

YouTube Notifications

1. Resolve Channel: Paste a YouTube Channel URL, ID (starts with UC), or Handle (e.g., @handle) into the input box and click Resolve.
2. Select Channel: Choose the Discord channel where you want the notification to be posted.
3. Customize (Optional): Set a friendly name and a custom message template. If you set a custom template, it must include {video_url}.
4. Subscribe: Click the subscribe button.

YouTube Placeholders:

• {video_title}: The title of the new video.
• {video_url}: The direct link to the video (required in custom templates).

Twitch Notifications

1. Resolve Streamer: Enter the Twitch username (e.g., shroud) or URL and click Resolve.
2. Select Channel: Choose the Discord channel for "Now Live" alerts.
3. Customize (Optional): Set a custom message template. If you set one, it must include {url}.
4. Subscribe: Click subscribe. Raptor will now monitor the streamer's status.

Twitch Placeholders:

• {streamer}: The display name of the streamer.
• {url}: The link to the Twitch channel (required in custom templates).

Bluesky Notifications

1. Resolve User: Enter the Bluesky handle (e.g., bsky.app) or profile URL and click Resolve.
2. Select Channel: Choose the Discord channel for new post alerts.
3. Customize (Optional): Set a custom message template. If you set one, it must include {url}.
4. Subscribe: Click subscribe. Raptor will listen to the Bluesky firehose for new posts.

Bluesky Placeholders:

• {handle}: The handle of the Bluesky user.
• {url}: The link to the new Bluesky post (required in custom templates).
• {text}: The text content of the Bluesky post.

Announcement Templates

Templates allow you to customize how the bot announces new content. If left blank, Raptor uses a clean default message that always includes a link.

Custom templates must include the media link placeholder:

Subscriptions without the required placeholder are rejected (API returns 400). This ensures every announcement includes a clickable link.

Example Template:HEY @everyone! New stream: {url}

Permissions

Managing MediaHooks requires Editor or Admin access to the server dashboard.