These commands help support teams and AI agents inspect what visitors asked, follow up with messages, organize threads with tags, and maintain lead records.
Most commands in this section require a chatbot ID:
Conversations
Conversations are visitor chat threads.
List conversations
List filters:
| Option | Values/default |
|---|
--status <status> | all, open, resolved. Default: all. |
--mode <mode> | AI or AGENT. |
--escalated <boolean> | Filter escalated conversations. |
--important <boolean> | Filter starred conversations. |
--read <boolean> | Filter read/unread conversations. |
--lead <lead-id> | Filter by linked lead. |
--query <text> | Search conversation/user text. |
--tag <tag-id> | Filter by tag. Repeatable. |
--include-empty | Include empty threads. |
--limit <1-100> | Default: 50. |
--cursor <cursor> | Continue pagination. |
Use --json when an agent needs the complete thread ID. Human table output may shorten long IDs for readability.
Get one conversation
The response includes conversation metadata, visitor details, assigned tags, lead information, mode, state, and recent messages.
Update a conversation
Update fields:
| Option | Description |
|---|
--title <title> | Set the conversation title. |
--mode <mode> | AI or AGENT. |
--important <boolean> | Star or unstar the conversation. |
--resolved <boolean> | Resolve or reopen the conversation. |
--escalated <boolean> | Mark escalation state. |
--mark-read <boolean> | Mark read/unread. |
--tag <tag-id> | Replace assigned tags with the provided tag IDs. Repeatable. |
--email <email> | Update visitor email. |
--name <name> | Update visitor name. |
--phone <phone> | Update visitor phone. |
--webhook-url <url> | Update conversation webhook URL. |
--webhook-token <token> | Update conversation webhook token. |
Quick conversation actions
Bulk conversation actions
Bulk actions:
Messages
Messages are individual entries inside a conversation.
List messages
Options:
| Option | Values/default |
|---|
--limit <1-500> | Default: 100. |
--cursor <cursor> | Continue pagination. |
Send a visitor message
Send into an existing conversation:
Start a new conversation by omitting the thread ID:
The CLI sends normal visitor/user messages. Agent and system messages are internal SiteGPT states and are not exposed as public sender options.
React to a message
Edit a message
Tags help organize conversations.
tags create is an alias for tags add.
Use tag IDs with conversation filters and updates:
Leads
Leads are visitor contact records collected by SiteGPT.
List leads
List filters:
| Option | Values/default |
|---|
--status <status> | all, open, archived. Default: all. |
--important <boolean> | Filter starred leads. |
--query <text> | Search name, email, phone, or notes. |
--limit <1-100> | Default: 50. |
--cursor <cursor> | Continue pagination. |
Get and update leads
Quick lead actions
Bulk lead actions
Bulk lead actions:
--yes is required for bulk delete.
Full reference
