Skip to content

index.md

Latest commit

 

History

History
75 lines (56 loc) · 3.21 KB

index.md

File metadata and controls

75 lines (56 loc) · 3.21 KB

Channels

Connect your Hexis agent to messaging platforms. Each channel runs as an adapter that bridges the platform to RabbitMQ, where the agent processes messages.

Channel Comparison

Channel Library Connection Auth Docker Profile
Discord discord.py WebSocket Bot token active
Telegram python-telegram-bot Long polling Bot token active
Slack slack-bolt Socket Mode / HTTP Bot + App token active
Signal aiohttp SSE stream Phone number + sidecar active + signal
WhatsApp aiohttp Webhook Meta Business API active
iMessage aiohttp Polling (2s) BlueBubbles server macOS only
Matrix matrix-nio Sync loop Access token active

Capabilities Matrix

Capability Discord Telegram Slack Signal WhatsApp iMessage Matrix
Direct messages Yes Yes Yes Yes Yes Yes Yes
Group messages Yes Yes Yes Yes Yes No Yes
Threads Yes Yes (forums) Yes No No No Yes
Reactions Yes Yes Yes Yes Yes Yes (tapback) Yes
Media Yes Yes Yes Yes Yes Yes Yes
Typing indicator Yes Yes No-op No No-op Yes Yes
Edit messages Yes Yes Yes No No No Yes
Max message length 2,000 4,096 4,000 8,000 4,096 20,000 65,536

General Setup Pattern

All channels follow the same pattern:

  1. Configure credentials -- hexis channels setup <channel>
  2. Start the channel worker -- included in docker compose --profile active up -d
  3. Verify -- hexis channels status

See Channels Setup guide for the general pattern and tips.

Architecture

Platform API  <-->  Channel Adapter  <-->  RabbitMQ  <-->  Agent Loop

Each adapter implements the ChannelAdapter ABC from channels/base.py, providing:

  • start(on_message) -- connect and listen for inbound messages
  • stop() -- disconnect gracefully
  • send(channel_id, text, reply_to, thread_id) -- send a message
  • capabilities -- declares supported features via ChannelCapabilities dataclass

Adapters run in the channel worker container, maintaining persistent connections to platform APIs and routing messages through RabbitMQ to the agent's conversation loop.

Choosing a Channel

  • Easiest setup: Discord or Telegram (bot token only, no external services)
  • Enterprise: Slack (Socket Mode works behind firewalls)
  • Privacy-focused: Signal or Matrix (self-hosted, encrypted)
  • Mobile: WhatsApp or iMessage (phone-based messaging)
  • Self-hosted: Matrix (bring your own homeserver)

Related