SkyKoiSKYKOIDocs
Docs/Channels/Channel Setup

Channel Setup

How channels will work when additional platforms are enabled.

💡Channel setup through the SkyKoi dashboard is **coming soon**. The information below describes how the channel system works and how it will be exposed in the dashboard.

Each channel has specific setup requirements. SkyKoi will automate most of the configuration, but some channels require manual steps (like providing tokens or scanning QR codes).

WhatsApp

WhatsApp uses the WhatsApp Web protocol via Baileys. Setup will require scanning a QR code from your phone:

  • •1. In the SkyKoi dashboard, go to Agent → Channels → Add WhatsApp
  • •2. A QR code is displayed for WhatsApp Web pairing
  • •3. Open WhatsApp on your phone → Linked Devices → Link a Device → Scan the QR
  • •4. The Gateway establishes the WhatsApp Web session
  • •5. Configure DM policy (pairing, allowlist, open) and group settings

⚠️Only one WhatsApp Web session per phone number. If you pair with SkyKoi, existing WhatsApp Web sessions on other devices will be disconnected.

Telegram

  • •1. Create a bot via [@BotFather](https://t.me/BotFather) on Telegram
  • •2. Copy the bot token
  • •3. In the SkyKoi dashboard, go to Agent → Channels → Add Telegram
  • •4. Paste the bot token
  • •5. Configure DM policy and group settings

Discord

  • •1. Create a Discord application at [discord.com/developers](https://discord.com/developers)
  • •2. Create a Bot user and copy the token
  • •3. Generate an invite URL with the required permissions
  • •4. Invite the bot to your server(s)
  • •5. In the SkyKoi dashboard, paste the bot token and configure guild/channel permissions

Slack

  • •1. Create a Slack app at [api.slack.com](https://api.slack.com/apps)
  • •2. Enable Socket Mode and generate an App-Level Token (xapp-...)
  • •3. Add the Bot Token Scopes needed (chat:write, channels:history, etc.)
  • •4. Install the app to your workspace and copy the Bot User OAuth Token (xoxb-...)
  • •5. In the SkyKoi dashboard, paste both tokens

Channel Configuration

When channels are enabled, SkyKoi will translate your dashboard settings into the corresponding channel configuration. For example:

json
{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+15555550123"],
      "groups": { "*": { "requireMention": true } }
    },
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC...",
      "dmPolicy": "allowlist",
      "allowFrom": ["tg:123456789"]
    }
  }
}
NextTools Overview →