Skip to content
KotboKotbo Docs

Discord commands & relays (bridges)

On Discord, the Channel links module manages your communication bridges and relays messages between channels in real time.

Section titled “Slash commands for managing links”

You can administer your bridges straight from Discord using Kotbo’s slash commands.

To list the active links on your server and get their unique IDs:

+/link list
Section titled “1. Link two local channels”

To connect two channels on your current server:

+/link salonsalon-source:#salon-Asalon-cible:#salon-Bdirection:Bidirectionnelmode:Webhook
Section titled “2. Link a remote server directly (staff)”

If you are an administrator on both servers, use the ID of the target server and channel:

+/link directsalon-source:#salon-localserveur-cible:TARGET_SERVER_IDsalon-cible:TARGET_CHANNEL_ID

3. Linking by invitation (Server A — initiating)

Section titled “3. Linking by invitation (Server A — initiating)”

To offer a link to a third-party administrator, generate a link code:

+/link invitesalon:#salon-localdirection:Bidirectionnelmode:Webhookinvitation-serveur:Vrai

The bot returns a unique code (for example A1B2C3D4) to pass on to the recipient.

4. Accept a link invitation (Server B — target)

Section titled “4. Accept a link invitation (Server B — target)”

To accept another server’s request using the invitation code you received:

+/link acceptcode:INVITATION_CODEsalon:#salon-local-cible
Section titled “5. Remove an active link”

To break a channel bridge using its ID (which you can find with /link list):

+/link removeid:LINK_ID

How the relay works on Discord

Section titled “How the relay works on Discord”

Webhook mode (mirror)

Section titled “Webhook mode (mirror)”
  • Clean rendering: Kotbo creates a temporary webhook in the target channel. The relayed message appears under the original author’s real username and avatar.
  • Natural experience: for users in the receiving channel, it looks just like a normal conversation, with a small BOT badge next to the username indicating the relay.

Embed mode

Section titled “Embed mode”
  • The message is wrapped in a coloured embed sent under Kotbo’s name.
  • It explicitly names the originating server and author in its header.

Advanced synchronisation

Section titled “Advanced synchronisation”

When the matching options are enabled on the dashboard, Kotbo mirrors these actions live on Discord:

  • Message edits: editing a message on one side instantly updates the copy on the other.
  • Message deletions: deleting a message also removes the relayed message in the remote channel.
  • Attachments: images and documents are transferred and hosted so they display in the target channel.
  • Reactions: adding an emoji reaction is synchronised if the bot has the necessary permissions on both servers.

Required Discord permissions

For Webhook (mirror) mode and attachment relaying to work correctly, make sure Kotbo’s role has the Manage Webhooks (MANAGE_WEBHOOKS) and Attach Files (ATTACH_FILES) permissions in the channels involved, on both servers.