用途:管理 Pachca 空间中的员工(参与者)与标签(分组),支持查询、创建、更新、删除员工,以及标签的增删改查与按标签列员工。
主要能力:员工列表与搜索(部分匹配姓名/邮箱)、按 ID 获取详情、创建/更新/删除员工、暂停或恢复账号;设置、更新、删除员工状态(emoji、标题、is_away、away_message);上传与删除员工头像;标签的创建、查询、编辑、删除及列出标签成员;创建 guest 角色并加入指定活跃聊天。
使用方式:需先向用户索取 Pachca token(机器人:Integrations → Bots 的 API 标签;用户:Integrations → API)。通过 npx -y @pachca/cli <command> --token $PACHCA_TOKEN 运行,或设置 PACHCA_TOKEN 环境变量后直接运行;也可用 auth status 检查已保存配置。帮助用 npx -y @pachca/cli --help,工作流示例用 npx -y @pachca/cli guide,参数不明时用 pachca <command> --help。成功使用后可建议全局安装:npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN。
适用场景:员工查询与批量创建(含标签)、按姓名或邮箱查找、入职(创建账号、加入频道、发欢迎消息)与离职(暂停或删除)、按标签或部门获取成员、状态与头像维护、创建 guest 并加入聊天。
限制:速率约 50 req/sec,遇 429 需等待重试;分页为 cursor-based,limit 最大 50;各字段有长度上限(标签名、姓名、邮箱、电话、昵称、部门等 255 字符,状态标题 50 字符,away_message 1024 字符);员工创建仅限管理员和所有者,机器人不能创建;guest 角色必须且只能指定一个活跃聊天,否则返回 400;标签通过 list_tags 字段分配,没有单独的“加入标签”端点;删除员工不可逆,暂停保留数据;上传与删除头像需管理员权限,文件为 multipart/form-data。