Gateway › What is Gateway?

What is Gateway?

Overview

The gateway is the layer that connects the bus to the chat platform you’re using, plus an adapter specific to that platform. Receiving and sending run separately, so one half dying can’t pretend to be healthy.

Configuration

On the web app Integrations page, Gateways card, click Create (or Edit) on the platform row, fill Bot token (Slack also App token) and Owner user id; it is saved only after the platform check passes; then click Enable. Credentials are stored by agent-hub.

If no adapter can be selected, you’ll see:

FATAL: no usable gateway adapter (active gateway: telegram)

Switch gateway

Web app Monitor → Gateway card → Switch…, or Enable another row on Integrations. Switching doesn’t touch tokens or stored data — switching back shows the same bindings, topics, and people. Messages queued for the old platform are skipped (logged).

Platform comparison

PlatformGroupTopicThreadConnection
Telegramgrouptopicreplylong-poll getUpdates
DiscordserverchannelthreadDiscord Gateway websocket
SlackworkspacechannelthreadSocket Mode
Webhookgroup_idtopic_idthread_idSigned HTTP

Platform-specific setup

  • Telegram — Bot token and allowlist
  • Discord — Intents, permissions, and slash commands
  • Slack — Manifest and Socket Mode
  • Webhook — Connect your own systems

Integrations page (web app)

On the Integrations page of the web app, you can:

  • Create / edit credentials for each platform
  • Enable the gateway you want active
  • See which gateway is enabled (Status column) and whether its credentials are valid (Configured column)