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

# Conversations

> List, view, and reply to WhatsApp conversations from the command line

Conversation commands let you browse active conversations, inspect message history, and send replies without switching away from the terminal. Use these commands for quick triage, customer support workflows, or integrating with scripts.

## zeplo conversations list

List conversations in the current project. By default, only open conversations are shown.

```bash theme={null}
zeplo conversations list [--status <status>] [--assigned-to <userId>]
```

### Options

| Flag | Description |
| - | - |
| `--status <status>` | Filter by conversation status. Accepted values: `open`, `resolved`, `closed` |
| `--assigned-to <userId>` | Filter by the user ID of the assigned team member |

### Examples

```bash theme={null}
# List all open conversations (default)
zeplo conversations list

# List resolved conversations
zeplo conversations list --status resolved

# List conversations assigned to a specific team member
zeplo conversations list --assigned-to user_abc123

# Combine filters to find open conversations assigned to you
zeplo conversations list --status open --assigned-to user_abc123

# List all conversations regardless of status
zeplo conversations list --status open
zeplo conversations list --status resolved
zeplo conversations list --status closed
```

## zeplo conversations show

Display the message history for a specific conversation. Use `--watch` to keep the command running and stream new messages as they arrive.

```bash theme={null}
zeplo conversations show <id> [--watch]
```

### Arguments

| Argument | Description |
| - | - |
| `<id>` | The conversation ID to display |

### Options

| Flag | Description |
| - | - |
| `--watch` | Stream new messages in real-time. The command stays running until you press `Ctrl+C` |

### Examples

```bash theme={null}
# Show the message history of a conversation
zeplo conversations show conv_xyz789

# Watch a conversation for new messages in real-time
zeplo conversations show conv_xyz789 --watch

# List conversations first to find the ID, then open it
zeplo conversations list
# Then view the conversation
zeplo conversations show conv_xyz789
```

## zeplo conversations reply

Send a reply to an existing conversation. The message is sent on behalf of the authenticated user.

```bash theme={null}
zeplo conversations reply <id> <text>
```

### Arguments

| Argument | Description |
| - | - |
| `<id>` | The conversation ID to reply to |
| `<text>` | The reply message text |

### Examples

```bash theme={null}
# Reply to a conversation
zeplo conversations reply conv_xyz789 "Thank you for reaching out. We are looking into this."

# Reply to a conversation from a script with a canned response
CONV_ID=conv_xyz789
zeplo conversations reply "$CONV_ID" "Your order has been updated. Please allow 24 hours for changes to reflect."

# Quick triage: list, read, and reply
zeplo conversations list
zeplo conversations show conv_xyz789
zeplo conversations reply conv_xyz789 "Got it, I will escalate this to our engineering team."
```


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