> ## Documentation Index > Fetch the complete documentation index at: https://sitegpt.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Conversations, messages, tags, and leads > Review support conversations, send user messages, manage tags, and maintain leads from the SiteGPT CLI. 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: ```bash theme={null} sitegpt chatbots list ``` ## Conversations Conversations are visitor chat threads. ```bash theme={null} sitegpt conversations --help ``` ### List conversations ```bash theme={null} sitegpt conversations list --chatbot sitegpt conversations list --chatbot --json sitegpt conversations list --chatbot --status open sitegpt conversations list --chatbot --status resolved sitegpt conversations list --chatbot --mode AI sitegpt conversations list --chatbot --mode AGENT sitegpt conversations list --chatbot --escalated true sitegpt conversations list --chatbot --important true sitegpt conversations list --chatbot --read false sitegpt conversations list --chatbot --query "refund" sitegpt conversations list --chatbot --tag ``` List filters: | Option | Values/default | | ----------------------- | ------------------------------------------ | | `--status ` | `all`, `open`, `resolved`. Default: `all`. | | `--mode ` | `AI` or `AGENT`. | | `--escalated ` | Filter escalated conversations. | | `--important ` | Filter starred conversations. | | `--read ` | Filter read/unread conversations. | | `--lead ` | Filter by linked lead. | | `--query ` | Search conversation/user text. | | `--tag ` | Filter by tag. Repeatable. | | `--include-empty` | Include empty threads. | | `--limit <1-100>` | Default: `50`. | | `--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 ```bash theme={null} sitegpt conversations get --chatbot sitegpt conversations get --chatbot --json ``` The response includes conversation metadata, visitor details, assigned tags, lead information, mode, state, and recent messages. ### Update a conversation ```bash theme={null} sitegpt conversations update --chatbot --title "Pricing question" sitegpt conversations update --chatbot --mode AGENT sitegpt conversations update --chatbot --important true sitegpt conversations update --chatbot --resolved true sitegpt conversations update --chatbot --escalated true sitegpt conversations update --chatbot --mark-read true sitegpt conversations update --chatbot --email visitor@example.com --name "Jane Doe" sitegpt conversations update --chatbot --phone "+15551234567" sitegpt conversations update --chatbot --tag --tag ``` Update fields: | Option | Description | | ------------------------- | ------------------------------------------------------------ | | `--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 ```bash theme={null} sitegpt conversations star --chatbot <chatbot-id> <thread-id> sitegpt conversations unstar --chatbot <chatbot-id> <thread-id> sitegpt conversations resolve --chatbot <chatbot-id> <thread-id> sitegpt conversations unresolve --chatbot <chatbot-id> <thread-id> sitegpt conversations read --chatbot <chatbot-id> <thread-id> sitegpt conversations unread --chatbot <chatbot-id> <thread-id> sitegpt conversations escalate --chatbot <chatbot-id> <thread-id> --message "A human will follow up shortly." sitegpt conversations switch-to-ai --chatbot <chatbot-id> <thread-id> --message "The AI assistant is back online." sitegpt conversations delete --chatbot <chatbot-id> <thread-id> --yes ``` ### Bulk conversation actions ```bash theme={null} sitegpt conversations bulk --chatbot <chatbot-id> --action star <thread-id> <thread-id> sitegpt conversations bulk --chatbot <chatbot-id> --action unstar <thread-id> <thread-id> sitegpt conversations bulk --chatbot <chatbot-id> --action resolve <thread-id> <thread-id> sitegpt conversations bulk --chatbot <chatbot-id> --action unresolve <thread-id> <thread-id> sitegpt conversations bulk --chatbot <chatbot-id> --action mark-read <thread-id> <thread-id> sitegpt conversations bulk --chatbot <chatbot-id> --action mark-unread <thread-id> <thread-id> sitegpt conversations bulk --chatbot <chatbot-id> --action delete <thread-id> <thread-id> --yes ``` Bulk actions: ```text theme={null} star, unstar, resolve, unresolve, mark-read, mark-unread, delete ``` ## Messages Messages are individual entries inside a conversation. ```bash theme={null} sitegpt messages --help ``` ### List messages ```bash theme={null} sitegpt messages list --chatbot <chatbot-id> <thread-id> sitegpt messages list --chatbot <chatbot-id> <thread-id> --limit 200 sitegpt messages list --chatbot <chatbot-id> <thread-id> --cursor <cursor> sitegpt messages list --chatbot <chatbot-id> <thread-id> --json ``` Options: | Option | Values/default | | ------------------- | -------------------- | | `--limit <1-500>` | Default: `100`. | | `--cursor <cursor>` | Continue pagination. | ### Send a visitor message Send into an existing conversation: ```bash theme={null} sitegpt messages send --chatbot <chatbot-id> <thread-id> "Do you offer annual billing?" ``` Start a new conversation by omitting the thread ID: ```bash theme={null} sitegpt messages send --chatbot <chatbot-id> "What can you help me with?" ``` 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 ```bash theme={null} sitegpt messages react --chatbot <chatbot-id> <thread-id> <message-id> POSITIVE sitegpt messages react --chatbot <chatbot-id> <thread-id> <message-id> NEGATIVE sitegpt messages react --chatbot <chatbot-id> <thread-id> <message-id> NEUTRAL ``` ### Edit a message ```bash theme={null} sitegpt messages edit --chatbot <chatbot-id> <thread-id> <message-id> "Updated message text" ``` ## Tags Tags help organize conversations. ```bash theme={null} sitegpt tags list sitegpt tags list --query "sales" sitegpt tags get <tag-id> sitegpt tags add "Sales" sitegpt tags add --title "Billing" sitegpt tags add --id billing --title "Billing" sitegpt tags update <tag-id> --title "Enterprise sales" sitegpt tags delete <tag-id> --yes ``` `tags create` is an alias for `tags add`. Use tag IDs with conversation filters and updates: ```bash theme={null} sitegpt conversations list --chatbot <chatbot-id> --tag <tag-id> sitegpt conversations update --chatbot <chatbot-id> <thread-id> --tag <tag-id> ``` ## Leads Leads are visitor contact records collected by SiteGPT. ```bash theme={null} sitegpt leads --help ``` ### List leads ```bash theme={null} sitegpt leads list --chatbot <chatbot-id> sitegpt leads list --chatbot <chatbot-id> --status open sitegpt leads list --chatbot <chatbot-id> --status archived sitegpt leads list --chatbot <chatbot-id> --important true sitegpt leads list --chatbot <chatbot-id> --query "jane@example.com" ``` 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 ```bash theme={null} sitegpt leads get --chatbot <chatbot-id> <lead-id> sitegpt leads update --chatbot <chatbot-id> <lead-id> --name "Jane Doe" sitegpt leads update --chatbot <chatbot-id> <lead-id> --phone "+15551234567" sitegpt leads update --chatbot <chatbot-id> <lead-id> --important true sitegpt leads update --chatbot <chatbot-id> <lead-id> --archived true ``` ### Quick lead actions ```bash theme={null} sitegpt leads star --chatbot <chatbot-id> <lead-id> sitegpt leads unstar --chatbot <chatbot-id> <lead-id> sitegpt leads archive --chatbot <chatbot-id> <lead-id> sitegpt leads unarchive --chatbot <chatbot-id> <lead-id> sitegpt leads delete --chatbot <chatbot-id> <lead-id> --yes ``` ### Bulk lead actions ```bash theme={null} sitegpt leads bulk --chatbot <chatbot-id> --action archive --lead <lead-id> --lead <lead-id> sitegpt leads bulk --chatbot <chatbot-id> --action unarchive <lead-id> <lead-id> sitegpt leads bulk --chatbot <chatbot-id> --action star <lead-id> <lead-id> sitegpt leads bulk --chatbot <chatbot-id> --action unstar <lead-id> <lead-id> sitegpt leads bulk --chatbot <chatbot-id> --action delete <lead-id> <lead-id> --yes ``` Bulk lead actions: ```text theme={null} archive, unarchive, star, unstar, delete ``` `--yes` is required for bulk delete. ## Full reference * [Conversations](/cli/command-reference#conversations) * [Messages](/cli/command-reference#messages) * [Tags](/cli/command-reference#tags) * [Leads](/cli/command-reference#leads)