/docs/channels/

Channels

Connect your bot to messaging platforms so users can interact with it where they already are.

Overview

Your bot is always accessible via its web URL, but you can also connect it to messaging channels. Each channel requires you to create a bot or app on the respective platform and paste the credentials into the ClawBlitz dashboard.

You can enable multiple channels at once. The bot maintains separate conversation threads per channel.

Discord

Telegram

WhatsApp

Slack

Discord

Create a Discord bot application and connect it to your ClawBlitz instance. The bot will join your server and respond to messages in channels it has access to.

Step 1: Create a Discord Application

  1. Go to the Discord Developer Portal
  2. Click New Application and give it a name
  3. Navigate to the Bot tab in the left sidebar
  4. Click Reset Token to generate a bot token
  5. Copy the token immediately — you will not be able to see it again

Step 2: Configure Bot Permissions

  1. On the Bot tab, enable the Message Content Intent toggle
  2. Navigate to OAuth2 > URL Generator
  3. Select scopes: bot
  4. Select bot permissions: Send Messages, Read Message History, Read Messages/View Channels
  5. Copy the generated URL and open it in your browser to invite the bot to your server

Step 3: Connect to ClawBlitz

  1. Open the ClawBlitz dashboard
  2. Go to Channels > Discord
  3. Paste your bot token
  4. Click Save
# Token format
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.XXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX

The bot will come online in your Discord server within a few seconds.

Telegram

Telegram bots are created through BotFather, Telegram's official bot management tool.

Step 1: Create a Bot with BotFather

  1. Open Telegram and search for @BotFather
  2. Send the command /newbot
  3. Choose a display name for your bot (e.g., "My ClawBlitz Bot")
  4. Choose a username that ends in bot (e.g., myclawblitz_bot)
  5. BotFather will reply with an HTTP API token — copy it

Step 2: Connect to ClawBlitz

  1. Open the ClawBlitz dashboard
  2. Go to Channels > Telegram
  3. Paste the token from BotFather
  4. Click Save
# Token format
TELEGRAM_TOKEN=1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghi

Once connected, users can find and message your bot directly on Telegram by searching for its username.

WhatsApp

WhatsApp integration uses the WhatsApp Business API through Meta's platform. This requires a Meta Business account and a phone number dedicated to the bot.

Step 1: Set Up Meta Business

  1. Go to Meta Business Suite and create or select a Business account
  2. Navigate to Meta for Developers and create a new app
  3. Select Business as the app type
  4. Add the WhatsApp product to your app

Step 2: Configure WhatsApp

  1. In the WhatsApp section, go to API Setup
  2. Add a phone number for your bot (you can use Meta's test number during development)
  3. Generate a Permanent Access Token under System Users in Business Settings
  4. Note down your Phone Number ID and WhatsApp Business Account ID

Step 3: Configure the Webhook

  1. In the WhatsApp section, go to Configuration
  2. Set the webhook URL to the one displayed in your ClawBlitz dashboard
  3. Use the verify token shown in your dashboard
  4. Subscribe to the messages webhook field

Step 4: Connect to ClawBlitz

  1. Open the ClawBlitz dashboard
  2. Go to Channels > WhatsApp
  3. Paste your access token, Phone Number ID, and Business Account ID
  4. Click Save
# Required credentials
WHATSAPP_ACCESS_TOKEN=EAAxxxxxxxxxxxxxxxxx
WHATSAPP_PHONE_NUMBER_ID=123456789012345
WHATSAPP_BUSINESS_ACCOUNT_ID=987654321098765

Slack

Slack integration uses Socket Mode, which means your bot connects outbound to Slack — no public webhook URL is required. You need both a Bot Token and an App-Level Token.

Step 1: Create a Slack App

  1. Go to api.slack.com/apps
  2. Click Create New App and select From scratch
  3. Name your app and select your workspace

Step 2: Enable Socket Mode

  1. In the left sidebar, go to Socket Mode
  2. Toggle Enable Socket Mode on
  3. When prompted, create an App-Level Token with the connections:write scope
  4. Copy the App-Level Token (starts with xapp-)

Step 3: Configure Bot Permissions

  1. Go to OAuth & Permissions
  2. Under Bot Token Scopes, add:
    app_mentions:read
    channels:history
    chat:write
    im:history
    im:read
    im:write
  3. Go to Event Subscriptions, enable events, and subscribe to:
    app_mention
    message.im
  4. Click Install to Workspace and authorize
  5. Copy the Bot User OAuth Token (starts with xoxb-)

Step 4: Connect to ClawBlitz

  1. Open the ClawBlitz dashboard
  2. Go to Channels > Slack
  3. Paste your Bot Token and App-Level Token
  4. Click Save
# Required tokens
SLACK_BOT_TOKEN=xoxb-xxxxxxxxxxxx-xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx
SLACK_APP_TOKEN=xapp-1-xxxxxxxxxxxx-xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx

Once connected, invite the bot to channels with /invite @YourBotName or message it directly.