Discord Mentions and Channels

Posts published from the Social Publisher can now include clickable @role mentions and #channel links when delivered to Discord. This guide explains how the integration works, how to connect your server, and how to use the picker tools in the composer.

Why Mentions Need OAuth

When you type @Co op in the composer, Discord shows it as plain text unless the outgoing message contains the role's snowflake ID (a 19-digit number). Snowflakes aren't part of the role name — they live inside your Discord server's metadata and can only be read by a bot that's a member of the server.

To get those IDs, Gamosy needs to:

1. Install the Gamosy bot into your server via Discord OAuth.
2. Use the bot's REST credentials to fetch your server's roles, text channels, and custom emojis.
3. Cache that "mention library" so the composer's picker is instant.

Once OAuth is connected the picker activates automatically — there is no extra setup.

Connect Your Discord Server

1. Open Social Publisher in your team workspace sidebar.
2. Switch to the Platforms tab.
3. Find the Discord card and click Add to Discord.
4. Discord opens its standard install screen. You'll be asked to:
   • Sign in (if you aren't already).
   • Pick the server you want to install the bot into. Only servers where you have Manage Server permission are listed.
   • Review the permissions the Gamosy bot will receive:
     • View Channels
     • Send Messages
     • Embed Links
     • Attach Files
     • Read Message History
     • Mention Everyone (guarded by an in-app per-post toggle — see below)
     • Use External Emojis
     • Manage Webhooks
5. Click Authorize. Discord redirects you back to Gamosy.
6. On success, the bot appears in your server's member list and the Discord card in Gamosy shows a green "Connected" badge with your server name. The mention picker in the composer activates.

If the install fails, the most common cause is forgetting to pick a server — Discord defaults to the OAuth dialog with no server selected. Just click Add to Discord again and choose your server.

Using the Mention Picker

When Discord is selected as a delivery channel inside the composer, three new toolbar buttons appear above the post body:

• Role — opens a popover listing every role in your server. Click one to insert it (renders as @Role Name in the composer; Discord renders it as a clickable mention with the role's color).
• Channel — opens a popover listing every text channel. Click one to insert it (renders as #channel-name; Discord renders it as a clickable link that jumps users to that channel).
• Emoji — opens a popover with your server's custom emojis. Click one to insert it inline.

Each popover supports keyboard search — start typing to filter. Each Discord card connects to one server; the composer's mention library is sourced from the first connected Discord server. To target a different server, use that server's connection card.

Per-Content-Type AI Defaults

When the AI generates a post from your Steam game data, it follows different mention conventions depending on the content type so your community doesn't get pinged for every routine update:

You can always edit the AI's draft before publishing. The mention picker stays available regardless of content type.

@everyone Safety Toggle

@everyone notifies every member of your Discord server. It's powerful and easy to abuse — Discord servers regularly mute or kick bots that ping @everyone too often.

For that reason @everyone is off by default on every post:

• A dedicated "Mention @everyone" checkbox sits beneath the body field when Discord is a delivery target.
• Ticking it opens a confirmation dialog ("This will notify every member of your-server-name. Are you sure?") so it can't be triggered accidentally.
• The setting is per-post — it doesn't persist into the next composer session.

Use it for: game launch days, major free DLC drops, time-sensitive sales ending within 24h. Avoid it for: patch notes, weekly community recaps, screenshots, anything that can wait.

Adding More Servers

You can install the Gamosy bot into multiple servers (one credential per server):

1. Click Add Another Server on the Discord card.
2. Run through the OAuth flow as before, picking a different server this time.
3. Each connected server appears as its own credential row with its own delete/refresh controls. Each post can be delivered to one or more of them.

There's a soft cap of 25 connected guilds per Gamosy team account. If you need more, contact support.

Refreshing the Mention Library

The cache of roles, channels, and emojis is refreshed automatically:

• Daily auto-refresh — every connected Discord credential is refreshed once a day by the Social Publisher cron (runs at 06:00 UTC). You don't need to do anything.
• Manual refresh — if you just renamed a role or added a new channel and want it to show up in the picker immediately, click the Refresh icon on the Discord card. The library re-fetches within a few seconds.

If the bot is kicked from your server or loses permissions, the next refresh marks the credential inactive and a banner prompts you to Reconnect. Reconnecting just runs the OAuth install again.

Migrating from Webhook-Only

If you connected Discord to the Social Publisher before May 2026, your credential is webhook-only — meaning posts publish fine, but the mention picker is disabled because Gamosy doesn't have a bot in your server.

To enable mentions:

1. Open the Discord card in Platforms and look for the "Upgrade to OAuth" banner.
2. Click Upgrade.
3. Run through the OAuth install flow above — pick the same server your webhook is in.
4. After install, the legacy webhook entry is replaced by the OAuth credential. Any scheduled posts continue to publish without interruption.
5. The mention picker activates on your next visit to the composer.

There's no auto-migration — you have to click Upgrade so you can review the bot permissions and pick which server to install into.