argent channels

Overview

The argent channels commands manage connections to messaging platforms like Telegram, Discord, WhatsApp, Slack, Signal, and iMessage.

Commands

`argent channels list`

List all configured channels and their status:

argent channels list

Output:

Channels:
  telegram   connected   @my_argent_bot
  discord    connected   ArgentBot#1234
  whatsapp   disconnected (session expired)
  slack      disabled

`argent channels add <platform>`

Add a new channel connection:

argent channels add telegram
argent channels add discord
argent channels add whatsapp
argent channels add slack
argent channels add signal
argent channels add imessage

The CLI walks through platform-specific setup steps (API tokens, bot creation, QR code scanning, etc.).

`argent channels remove <platform>`

Remove a channel configuration:

argent channels remove whatsapp

This removes the channel from your config and disconnects it. Channel message history is not deleted.

`argent channels test <platform>`

Test a channel connection:

argent channels test telegram

Verifies the token/credentials are valid and the connection can be established.

`argent channels enable <platform>`

Enable a disabled channel:

argent channels enable slack

`argent channels disable <platform>`

Disable a channel without removing its configuration:

argent channels disable slack

The channel stops receiving/sending messages but the config is preserved.

`argent channels pair`

Manually pair a channel user to an agent session:

argent channels pair --platform telegram --user-id 123456789 --session user-jason

See Channel Pairing for details.

Configuration

Channel changes are written to ~/.argentos/argent.json under the channels key. You can also edit this file directly.

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456789:ABCdef..."
    }
  }
}

After manual config changes, restart the gateway:

argent gateway restart

On this page