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

# Channels

> Manage your WhatsApp and messaging channels

Channel commands let you list, connect, disconnect, and monitor the health of messaging channels linked to your Zeplo account.

## zeplo channels list

List all channels connected to your account. Displays each channel's ID, name, type, and current connection status.

```bash theme={null}
zeplo channels list
```

### Examples

```bash theme={null}
# List all connected channels
zeplo channels list

# Example output:
# ID              NAME             TYPE       STATUS
# ch_3a7f1b       Sales WhatsApp   whatsapp   connected
# ch_9d2e4c       Support Line     whatsapp   disconnected
```

## zeplo channels connect

Connect a new WhatsApp channel to your account. This launches an interactive wizard that walks you through linking a WhatsApp Business account via QR code scan.

```bash theme={null}
zeplo channels connect
```

### Examples

```bash theme={null}
# Start the channel connection wizard
zeplo channels connect

# Follow the on-screen prompts to scan the QR code
# with your WhatsApp Business app
```

## zeplo channels disconnect

Disconnect a channel from your account. The channel's ID is required. Disconnecting stops all message sending and receiving on that channel, but existing conversation history is preserved.

```bash theme={null}
zeplo channels disconnect <channel-id>
```

### Arguments

| Argument | Required | Description |
| - | - | - |
| `<channel-id>` | Yes | The ID of the channel to disconnect (e.g. `ch_3a7f1b`) |

### Examples

```bash theme={null}
# Disconnect a specific channel
zeplo channels disconnect ch_3a7f1b
```

## zeplo channels health

Check the health and connectivity status of a channel. Returns information about uptime, last heartbeat, and any active warnings or errors.

```bash theme={null}
zeplo channels health <channel-id>
```

### Arguments

| Argument | Required | Description |
| - | - | - |
| `<channel-id>` | Yes | The ID of the channel to check (e.g. `ch_3a7f1b`) |

### Examples

```bash theme={null}
# Check the health of a channel
zeplo channels health ch_3a7f1b

# Example output:
# Channel: Sales WhatsApp (ch_3a7f1b)
# Status: healthy
# Last heartbeat: 2026-05-05T14:32:01Z
# Uptime (24h): 99.98%
# Warnings: none
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.