Sophon Docs
Getting Started

Connect a Channel

Add WhatsApp, Telegram, Slack, or any supported channel.

WebChat (Built-in)

WebChat is always available at http://localhost:8080/chat — no setup needed.

Adding a Channel

Via Dashboard

  1. Navigate to Channels
  2. Click Add Channel
  3. Select the channel type
  4. Follow the setup wizard
  5. Test the connection
  6. Activate

Telegram Example

  1. Create a bot with @BotFather on Telegram
  2. Copy the bot token
  3. In Sophon Dashboard, add a Telegram channel
  4. Paste the token
  5. Test and activate

WhatsApp Example

  1. In Sophon Dashboard, add a WhatsApp channel
  2. A QR code appears
  3. Scan with WhatsApp on your phone
  4. Connection established

Supported Channels

ChannelSetup Method
WebChatBuilt-in (always available)
WhatsAppQR code pairing
TelegramBot token
SlackOAuth or Socket Mode
DiscordBot token or OAuth
EmailIMAP/SMTP credentials
TeamsAzure Bot registration
Signalsignal-cli bridge
MatrixHomeserver URL + token
SMSTwilio credentials

Detailed Setup Guides

For step-by-step instructions with configuration references and troubleshooting, see the Channels section:

  • Telegram — BotFather setup, token configuration
  • Discord — Developer Portal, Gateway Intents, invite URL
  • Slack — App manifest, Socket Mode, scopes
  • WhatsApp — Meta Business API, webhook setup
  • Email — IMAP/SMTP, provider-specific settings
  • Teams — Azure Bot registration
  • Signal — signal-cli REST bridge
  • Matrix — Homeserver access token
  • SMS — Twilio webhook configuration

Channel Routing

Each channel can be routed to a specific agent. Configure routing in the channel settings or via channels.json.