> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# argent channels

> Commands for managing messaging channel connections.

## 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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
argent channels test telegram
```

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

### `argent channels enable <platform>`

Enable a disabled channel:

```bash theme={null}
argent channels enable slack
```

### `argent channels disable <platform>`

Disable a channel without removing its configuration:

```bash theme={null}
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:

```bash theme={null}
argent channels pair --platform telegram --user-id 123456789 --session user-jason
```

See [Channel Pairing](/channels/pairing) for details.

## Configuration

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

```json theme={null}
{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456789:ABCdef..."
    }
  }
}
```

<Info>
  After manual config changes, restart the gateway:

  ```bash theme={null}
  argent gateway restart
  ```
</Info>