Skip to content
Skip to content

Channels

Channels allow your AI agents to communicate with users across multiple messaging platforms simultaneously. ClawHQ supports seven channels, five of which can be configured entirely through self-service setup, while two require administrator assistance.

Supported Channels

ClawHQ integrates with the following messaging platforms. Each channel operates independently, meaning you can connect as many or as few as your workflow requires.

ChannelSetup TypeConnection Method
TelegramSelf-serviceBot token
DiscordSelf-serviceBot token
SlackSelf-serviceBot OAuth token
Microsoft TeamsSelf-serviceApp ID + password + tenant ID
WebchatSelf-serviceAuto-configured
WhatsAppAdmin-assistedQR code pairing
SignalAdmin-assistedPhone number registration

Self-Service Channel Setup

The five self-service channels can be connected directly from the Channels page in your dashboard. Click Connect Channel, select the platform, and follow the instructions below.

Telegram

  1. Open Telegram and search for @BotFather.
  2. Send the /newbot command and follow the prompts to name your bot.
  3. BotFather will provide an API token. Copy it.
  4. Return to ClawHQ, select Telegram, and paste the token into the Bot Token field.
  5. Click Connect. ClawHQ will verify the token by calling the Telegram getMe endpoint.
Tip: You can customise your Telegram bot's profile picture and description directly through BotFather using the /setuserpic and /setdescription commands.

Discord

  1. Go to the Discord Developer Portal at discord.com/developers and create a new application.
  2. Navigate to the Bot section and click Add Bot.
  3. Copy the bot token from the Bot page.
  4. Under Privileged Gateway Intents, enable Message Content Intent.
  5. Generate an invite link under OAuth2 > URL Generator with the bot scope and Send Messages / Read Message History permissions.
  6. Invite the bot to your server using the generated URL.
  7. In ClawHQ, select Discord and paste the bot token. ClawHQ verifies the connection by calling users/@me.

Slack

  1. Visit api.slack.com and click Create New App. Choose From scratch.
  2. Under OAuth & Permissions, add the following bot token scopes: chat:write, channels:history, channels:read, and app_mentions:read.
  3. Install the app to your workspace and copy the Bot User OAuth Token (starts with xoxb-).
  4. In ClawHQ, select Slack and paste the bot token. ClawHQ verifies it by calling auth.test.
  5. Invite the bot to any channels where it should respond using /invite @YourBot.

Microsoft Teams

  1. Register a new application in the Azure Portal.
  2. Note the Application (client) ID and Directory (tenant) ID.
  3. Under Certificates & secrets, create a new client secret and copy the value.
  4. Enable the Microsoft Teams channel in the Bot Framework registration.
  5. In ClawHQ, select Microsoft Teams and enter the App ID, client secret, and Tenant ID.

Webchat

Webchat is the simplest channel to set up. It is automatically configured when your ClawHQ instance is provisioned. Navigate to Channels > Webchat to find your embed script, which you can paste into any website's HTML to display a chat widget. ClawHQ verifies the webchat connection by performing a gateway health check.

Admin-Assisted Channels

WhatsApp and Signal require additional verification steps that must be coordinated with the ClawHQ support team.

WhatsApp

WhatsApp can be connected by scanning a QR code displayed directly in the ClawHQ dashboard. Navigate to Channels > WhatsApp and a pairing QR code will appear. Scan it with your WhatsApp app to link your number. If you encounter issues, you can request admin-assisted setup through the support system.

Signal

Signal requires a dedicated phone number to be registered with the Signal service. Because this process involves phone number verification and cannot be completed entirely within the dashboard, please contact support to arrange Signal channel setup.

Connection Test

Every channel includes a Test Connection button that performs a real API verification against the platform. This is not a simple ping; ClawHQ calls the platform's own identity endpoint to confirm the credentials are valid and the bot is reachable.

  • Telegram — Calls getMe to verify the bot token and retrieve the bot's username.
  • Discord — Calls users/@me to confirm the bot token and fetch the bot's identity.
  • Slack — Calls auth.test to validate the OAuth token and confirm workspace access.
  • Webchat — Performs a gateway health check to ensure the chat endpoint is responsive.
  • Teams / WhatsApp / Signal — Validates the stored credentials and confirms the service is active.

Channel Status History

Each channel maintains a timeline of events including connections, disconnections, health check results, and configuration changes. You can view this history by clicking the Status History button on any channel card. The timeline displays events in reverse chronological order with timestamps and event details. ClawHQ also calculates an uptime percentage for each channel based on the ratio of healthy time to total elapsed time since the channel was first connected.

Per-Channel Agent Routing

By default, every channel routes incoming messages to any available agent (the Any Agent setting). You can override this by selecting a specific agent from the dropdown on each channel card. This is useful when you want different agents to handle different platforms — for example, a sales-focused agent on your website webchat and a technical support agent on Discord.

Agent routing can be changed at any time without disconnecting the channel. See the Agents documentation for more on configuring agent behaviour.

Reconnect

If a channel becomes disconnected due to a token expiration, network issue, or platform outage, you do not need to re-enter credentials. Click the Reconnect button on the disconnected channel card. ClawHQ will attempt to re-establish the connection using the previously saved credentials. If the credentials have been revoked or changed on the platform side, you will be prompted to enter new ones.

Channel Message Preview

Each connected channel card includes an expandable Recent Messages section. Click the expand arrow to see the last five messages received on that channel, including the sender name, message content, and timestamp. This provides a quick way to verify that your bot is receiving and processing messages without navigating to the full Chat view.

Channel Ordering & Priority

You can drag and drop channel cards to reorder them. The first channel in the list receives a Primary badge, indicating it is your main communication channel. Channel ordering is a visual organisational tool and does not affect message routing or processing priority.

Channel Branding

For the Webchat channel, you can customise the display name and avatar that appear in the chat widget. Navigate to the channel settings and update the Display Name and Avatar fields. For other platforms (Telegram, Discord, Slack, Teams), branding is controlled through the respective platform's bot settings. ClawHQ provides instructions for each platform in the channel configuration panel.

Warning: Disconnecting a channel will stop all message processing for that platform immediately. Any in-flight messages may be lost. If you need to temporarily pause a channel, consider removing the agent assignment instead.

Next Steps