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 Connect Channel > 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 Connect Channel > 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 Connect Channel > Discord and 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
SignalRequires Signal CLI with a registered phone number
iMessageRequires a macOS node with imsg CLI
Google ChatGoogle Workspace service account
MattermostPlugin installation in your Mattermost server
MS TeamsPlugin installation via the Havoc MS Teams plugin
LINEChannel access token from LINE Developers

Next: Configure a Provider

Set up AI model providers for your agents.