Chat Bridges

Chat bridges connect Hefty to external messaging platforms, allowing users to interact with the AI agent through those platforms. Each bridge creates dedicated conversations in Hefty that appear in the Conversations sidebar — so messages from Telegram, Discord, Email, and other platforms are relayed into Hefty and processed just like any other conversation.

Supported Platforms

The list of supported platforms is populated dynamically from the backend, so the available bridges may vary depending on your Hefty deployment. The known platform types are:

Common Configuration

To set up any bridge, open the Chat Bridges dialog from User Menu → Chat Bridges, select the platform tab, and fill in the configuration fields. Each bridge type exposes different settings defined by the backend. Common configuration fields include:

• Bot token / API key — the credential used to authenticate with the platform. Shown as a masked password field with a show/hide toggle.
• Webhook URL — the endpoint the platform sends events to (for platforms that use webhooks).
• Channel / group IDs — identifiers for the specific channels or groups the bridge should listen to.
• Other platform-specific settings — additional fields may appear depending on the bridge type.

Bridge Conversations

Each active bridge generates conversations in Hefty automatically. Messages received from external platforms are relayed through the bridge and processed by the AI agent just like direct messages.

Bridge conversations appear in the Conversations sidebar with a source badge that indicates the platform of origin:

• TG — Telegram
• DC — Discord
• EM — Email

Bridge conversations behave like any other conversation in Hefty: they can be opened, browsed, and resumed. Messages from external users are relayed through the bridge and appear with their original sender information, so you always know who said what.

Security Considerations