用途:There There CLI 让用户在终端管理 There There 客服工单,每个 There There API 端点都有对应命令,适合工单分诊、回复客户、搜索工单和批量处理。
安装与认证:先运行 there-there --version 检查是否已安装;未安装则执行 composer global require spatie/there-there-cli,并确保 Composer 全局 bin 目录在 PATH 中(composer global config bin-dir --absolute)。使用 there-there login 登录(会提示输入 API token),there-there logout 退出。API token 来自工作区设置 https://there-there.app/settings/api-tokens。若命令返回 401,说明 token 无效或过期,需重新登录。
主要能力:get-me 返回用户与工作区信息;list-tickets 列出工单,支持按状态、渠道、标签、指派人、日期范围过滤,支持 --filter-assigned-to-me、--filter-unassigned、排序与分页(--page、--per-page);show-ticket 查看工单及消息和活动;update-ticket-status、update-ticket-assignee、update-ticket-team 修改状态、指派人和团队;add-tag-to-ticket、remove-tag-from-ticket 管理标签;reply-to-ticket 回复、forward-ticket 转发、add-note-to-ticket 添加内部备注;list-ticket-activities 列出活动;list-tags、list-channels、list-members、list-contacts、show-contact 查询工作区资源。
搜索:list-tickets 支持两种搜索。--q 为语义搜索,基于 AI 嵌入按含义匹配主题、摘要和消息内容,结果按相关度排序,需工作区启用 AI,否则返回 422;--filter-search 为全文关键词搜索,覆盖工单主题、消息和联系人信息。两者可与其他过滤条件组合;使用 --q 且未指定 --sort 时按相关度排序,指定 --sort 时以显式排序为准。
输出与限制:所有命令输出 JSON。资料未提供价格、平台支持范围或速率限制等信息。使用前需具备 There There 工作区与有效 API token。