Skip to main content

​
Overview

Each agent can connect to multiple messaging channels simultaneously. This guide covers setup for the most popular platforms.

​
WhatsApp

WhatsApp uses the Baileys library for Web-based connections.
1

Open Agent Channels

Navigate to your agent’s Channels tab.
2

Add WhatsApp

Click + Add Channel and select WhatsApp.
3

Scan QR Code

A QR code will appear. Open WhatsApp on your phone, go to Linked Devices, and scan the QR code.
4

Verify Connection

Once scanned, the connection status will change to Connected. Send a test message to verify.
WhatsApp Web sessions can expire. If the agent disconnects, you may need to re-scan the QR code.

​
Telegram

1

Create a Bot

Message @BotFather on Telegram and use /newbot to create a bot. Copy the bot token.
2

Add Telegram Channel

In your agent’s Channels tab, click + Add Channel and select Telegram.
3

Enter Bot Token

Paste the bot token from BotFather.
4

Configure DM Policy

Set the DM policy:
  • Pairing — Users must enter a pairing code
  • Allowlist — Only specific Telegram user IDs
  • Open — Anyone can message the bot

​
Discord

1

Create a Bot Application

Go to the Discord Developer Portal, create a new application, and add a bot.
2

Copy Bot Token

Under the Bot section, copy the bot token.
3

Invite Bot to Server

Generate an invite URL with the required permissions (Send Messages, Read Message History, etc.) and add the bot to your server.
4

Connect in Havoc

In your agent’s Channels tab, click + Add Channel and select Discord, then paste the bot token.

​
Slack

1

Create Slack App

Go to api.slack.com/apps and create a new app.
2

Enable Socket Mode

Enable Socket Mode and generate an app-level token.
3

Add Bot Scopes

Under OAuth & Permissions, add scopes: chat:write, im:history, im:read, im:write.
4

Install to Workspace

Install the app to your workspace and copy the Bot User OAuth Token.
5

Connect in Havoc

Enter the bot token and app-level token in Havoc.

​
Other Channels

ChannelSetup
WebChatBuilt-in — no credentials. Chat directly in the agent’s Workspace tab.
SignalRequires Signal CLI with a registered phone number
iMessageRequires a macOS node with imsg CLI
Google ChatService Account JSON from Google Cloud Console
MattermostServer URL + Bot Token
MS TeamsApp ID, App Secret, Tenant ID (optional for single-tenant) from Azure App Registration
LINEChannel Access Token + Channel Secret from LINE Developers
Feishu/LarkApp ID + App Secret from Feishu open platform

Next: Configure a Provider

Set up AI model providers for your agents.