Guides— v2.8.0

How to use Squan's 53 built-in tools and 17 messaging platforms

53 Built-in Tools

Every agent has instant access to all tools. No plugins, no configuration — just describe the task.

Messaging Gateway

Talk to your Squan agents from 17 messaging platforms — Telegram, Discord, Slack, and more.

Architecture

Platform (Telegram, Discord, …)
  → Gateway Adapter
    → Router
      → Squan Agent
        → Response back to platform

Setup (General Pattern)

  1. 1Go to Settings → Gateway
  2. 2Pick a platform
  3. 3Enter credentials (bot token, API key, etc.)
  4. 4Toggle enabled
  5. 5Start chatting from that platform

Platform Credentials

Telegram

Credentials: Bot Token

How: Message @BotFather on Telegram, /newbot

Discord

Credentials: Bot Token + App ID

How: discord.com/developers → New Application

Slack

Credentials: Bot Token + App Token

How: api.slack.com → Create App → Socket Mode

WhatsApp

Credentials: Access Token + Phone ID

How: Meta Business Suite → WhatsApp → API Setup

Signal

Credentials: API URL + Phone Number

How: Run signal-cli-rest-api Docker container

Matrix

Credentials: Homeserver URL + Access Token

How: Create bot account on your Matrix server

Mattermost

Credentials: Server URL + Access Token

How: System Console → Bot Accounts

Teams

Credentials: App ID + Password + Tenant ID

How: Azure Portal → Bot Channels Registration

Email

Credentials: IMAP/SMTP credentials

How: Use any email provider's IMAP/SMTP settings

WeChat

Credentials: App ID + Secret + Token

How: WeChat Official Account Platform

WeCom

Credentials: Corp ID + Secret + Agent ID

How: WeCom Admin Console

DingTalk

Credentials: App Key + Secret + Robot Code

How: DingTalk Open Platform

Feishu / Lark

Credentials: App ID + Secret + Verification Token

How: Feishu Open Platform

LINE

Credentials: Channel Access Token + Secret

How: LINE Developers Console

QQBot

Credentials: App ID + Secret

How: QQ Bot Open Platform

iMessage

Credentials: Server URL + Password

How: Install BlueBubbles on a Mac

IRC

Credentials: Server + Port + Nickname + Channels

How: Just need an IRC server address

Slash Commands — available from any platform

CommandDescription
/agentsList all active agents
/projectsList all registered projects
/new <task>Dispatch a new agent with a task
/switch <id>Switch to a different agent session
/statusCheck status of the current agent
/stopStop the current agent
/disconnectDisconnect from the gateway
/helpShow available commands

Example Conversation

You (Telegram)

/new Fix the login page CSS on mobile

Squan

✅ Agent bee-alpha dispatched! Working on: Fix the login page CSS on mobile

You

Also make the font bigger on the header

Squan

Agent bee-alpha received your message. Working...

Squan

✅ Done! Fixed mobile CSS and increased header font size. Files changed: src/pages/Login.css

You

/status

Squan

🟢 bee-alpha — Done (2 files changed, 45s)

Tips & Best Practices

Get the most out of tools and the messaging gateway

Tools are automatic

Agents discover all 53 tools without any configuration. Just describe the task and the agent picks the right tools.

MCP extends beyond

Your MCP extensions from Settings still work alongside built-in tools. Built-in tools cover common cases; MCP handles the rest.

Gateway is optional

You don't need to use messaging platforms. The desktop app works standalone — the gateway is just a convenience layer.

One agent per channel

Each platform channel or DM gets its own agent session. Multiple channels can run agents in parallel.

Access control

Use allowedUsers in gateway settings to restrict who can dispatch agents from messaging platforms.

Ready to try it?

Download Squan v2.8.0 to get all 53 tools and 17 messaging platform integrations out of the box.

Download SquanGitHub Repository