Web Chat

The built-in web chat channel provides a real-time chat interface directly in the Hybrix dashboard. No external setup required -- it works out of the box.

How it works

The web chat channel uses WebSocket connections for real-time bidirectional communication. When you start the gateway, the chat interface is automatically available at your dashboard URL.

json

{
  "channels": [
    {
      "type": "web",
      "agents": ["Atlas", "Scout"],
      "theme": "auto",
      "showMascot": true,
      "streamResponses": true
    }
  ]
}

Configuration options

Option	Default	Description
theme	auto	Color theme: auto, light, or dark
showMascot	true	Display the agent's pixel mascot in the chat header
streamResponses	true	Stream tokens as they generate (vs. wait for full response)
maxHistory	100	Max messages to display in the chat window
welcomeMessage	null	Custom greeting when the chat opens

Features

Token streaming — Responses appear word-by-word in real time, giving immediate feedback.

Agent switching — When multiple agents are assigned, switch between them mid-conversation.

Markdown rendering — Agent responses render with full Markdown support including code blocks, tables, and links.

Mascot presence — The agent's pixel mascot animates in the chat header, showing its current activity state.

Web chat sessions are stored in memory by default and are lost when the gateway restarts. For persistence, configure a session store in the gateway settings.

← Telegram Org →