hoziron-cli channel

Manage channel integrations — Slack, Discord, Telegram, Microsoft Teams, and more.

Synopsis

hoziron-cli channel <subcommand> [options]

Subcommands

A channel's identity is its id (unique, operator-chosen — e.g. claims-webhook), not its kind (the adapter type, e.g. webhook). kind is not required to be unique: multiple channels of the same kind (two separate webhooks pushing different workflow events, say) are supported. setup defaults id to kind unless --id is passed explicitly.

hoziron-cli channel list

$ hoziron-cli channel list
ID                   KIND         STATUS       AGENT
claims-webhook       webhook      Connected    claims-agent
fnol-webhook         webhook      Connected    fnol-agent
slack                slack        Disabled     (none)

hoziron-cli channel setup

Interactive wizard for configuring a channel.

The wizard only knows how to fully wire up discord, telegram, slack, and mqtt — the channels whose secret field(s) it collects and stores in the vault. Any other channel kind (teams, webhook, whatsapp, matrix, ...) is rejected by the wizard rather than silently writing a config field the channel's adapter doesn't recognize; configure those directly via POST /channels (see the console's New Channel form or reference/api/channels.md), storing any secret first with hoziron-cli vault set <NAME> and referencing that name from the channel's *_env config field.

hoziron-cli channel setup [kind] [--id <id>]

Examples

# Interactive picker
$ hoziron-cli channel setup
Available channels:
  1) discord
  2) slack
  3) telegram
  4) mqtt

Select channel [1-4]: 2

# Direct setup
$ hoziron-cli channel setup slack
Setting up channel 'slack' (kind: slack)

Bot token (xoxb-...): ********
App-level token (xapp-...): ********
Default agent ID (leave blank to skip):
Channel 'slack' configured and active.

# A second channel of the same kind — pass --id explicitly
$ hoziron-cli channel setup slack --id support-slack
Setting up channel 'support-slack' (kind: slack)
...
Channel 'support-slack' configured and active.

# Unsupported kind
$ hoziron-cli channel setup teams
Error: Channel 'teams' isn't supported by the interactive setup wizard yet.
Supported channels: discord, telegram, slack, mqtt. Configure other channel
types directly via POST /channels (see the console's New Channel form),
storing any secret in the vault first with `hoziron-cli vault set <NAME>`
and referencing that name from the channel's `*_env` field.

channel setup POSTs straight to the real channel-administration API — the channel is created and its adapter started immediately, not written to config.toml for a later restart to pick up (Issue #1188 / #1214).

hoziron-cli channel enable / disable

$ hoziron-cli channel enable claims-webhook
Channel 'claims-webhook' enabled

$ hoziron-cli channel disable slack
Channel 'slack' disabled

Enabling/disabling takes effect immediately — the underlying adapter is started or stopped live, not just flagged in storage for the next restart.

Supported Channels

Hoziron ships around 40 channel adapters. channel setup only drives the four below end to end today; every other kind needs POST /channels directly (console New Channel form, or the raw API) plus hoziron-cli vault set for any secret.

See Also

• agent.md — Agents that respond on channels
• reference/api/channels.md — the full channel-administration API (create/update/delete, kind list)