Documentation

Operate SocialWire confidently.

A concise guide to installation, creator tracking, templates, controls and integrations.

Installation

Use /invite as the public installation page or /add as the direct bot authorization shortcut. Discord performs guild selection and permission approval.

Dashboard authentication

The control panel uses Discord OAuth with the identify guilds scopes. It is separate from the bot installation route.

Dashboard

Visit /dashboard to manage servers. A guild only appears if the authenticated user has Manage Server or Administrator access and SocialWire is currently in that guild.

Creator tracking

The creator registry supports Twitch, YouTube, TikTok and X/Twitter. Each target stores its destination channel and optional mention role. TikTok can use separate live and video channels.

Notification templates

Templates support platform/event overrides and variables including {creator}, {platform}, {event}, {url}, {title}, {description} and {guild}.

Server controls

Pause all guild notifications instantly, choose an audit channel, define a default mention role and configure timezone-aware quiet hours.

Outgoing webhooks

Webhook endpoints can receive selected delivery events. If a secret is configured, SocialWire signs payloads using HMAC-SHA256 so your service can verify authenticity.

Health & diagnostics

The public /health route reports process uptime, Discord connection state and queue snapshot data. The Status page consumes this endpoint automatically.