Yunke CLI

yunke-cli（云客 CRM）

通过 omni-cli 的 yunke-crm 插件操作云客 CRM。凭证（~/.omnicli/yunke-crm.json）由 WorkBuddy 连接器经 OAuth 登录流程自动写入，无需手动登录。

前置条件：连接器已安装 omni-cli 并完成 OAuth 登录（yunke-crm.auth.login-web）。首次使用前，用户须先在云枢完成「AI 助手登录」生成 agentapp 凭证，否则登录会返回 access_denied。

所有命令输出统一为 JSON 信封：{ "status": "ok" | "error", "data": ..., "error": "..." }。日期统一用 YYYY-MM-DD，时间戳为毫秒。

命令分类

常用示例

组织架构

查询部门树（顶层部门）：

omni-cli yunke-crm.org.department-tree

按姓名搜索员工：

omni-cli yunke-crm.org.search --keyword "张伟"

报表统计

查询部门员工统计（department_id 留空取默认部门）：

omni-cli yunke-crm.report.employee-statistics --department_id "d001" --start_date "2026-07-01" --end_date "2026-07-31"

设备统计：

omni-cli yunke-crm.report.device-statistics

通话与 ASR

查询通话记录列表（后端每页最多 10 条，需翻页汇总）：

omni-cli yunke-crm.call.log-list --start_date "2026-07-01" --end_date "2026-07-31" --page 1

获取某通通话的 ASR 语音转写：

omni-cli yunke-crm.call.asr-result --call_id "call_xxx"

AI 智能分析

员工 SOP 分析：

omni-cli yunke-crm.ai.sop-analysis --department_id "d001" --start_date "2026-07-01" --end_date "2026-07-31"

客户情绪分析 / 意向分析：

omni-cli yunke-crm.ai.customer-emotion --start_date "2026-07-01" --end_date "2026-07-31"
omni-cli yunke-crm.ai.customer-intention --start_date "2026-07-01" --end_date "2026-07-31"

定位

部门定位（建议先用 org.search 缩小部门范围）：

omni-cli yunke-crm.location.by-department --department_id "d001"

调用规范

• 先看 schema：不确定参数时运行 omni-cli yunke-crm.<cmd> --help 查看参数定义。
• 显式传时间范围：多数查询支持 start_date/end_date，建议显式传入较短范围，不要依赖默认。
• 翻页：列表类命令返回分页信息，pageCount > 当前页 时继续翻页取全再汇总。
• 企业上下文：所有命令以已登录用户所属企业为范围，无需手动传 company_code。

yunke-cli (Yunke CRM) — English

Operate Yunke CRM via the omni-cli yunke-crm plugin. Credentials (~/.omnicli/yunke-crm.json) are written automatically by the WorkBuddy connector through the OAuth login flow — no manual login required.

Prerequisite: The connector has installed omni-cli and completed OAuth login (yunke-crm.auth.login-web). Before first use, the user must complete "AI Assistant login" in Yunshu to generate the agentapp credential, otherwise login returns access_denied.

All commands output a JSON envelope: { "status": "ok" | "error", "data": ..., "error": "..." }. Dates use YYYY-MM-DD; timestamps are milliseconds.

Common Examples

Search employees:

omni-cli yunke-crm.org.search --keyword "Zhang Wei"

Employee statistics for a department:

omni-cli yunke-crm.report.employee-statistics --department_id "d001" --start_date "2026-07-01" --end_date "2026-07-31"

Call records:

omni-cli yunke-crm.call.log-list --start_date "2026-07-01" --end_date "2026-07-31" --page 1

Customer emotion analysis:

omni-cli yunke-crm.ai.customer-emotion --start_date "2026-07-01" --end_date "2026-07-31"

Conventions

• Run omni-cli yunke-crm.<cmd> --help to inspect parameters when unsure.
• Pass explicit, narrow date ranges rather than relying on defaults.
• Paginate list commands until all pages are fetched, then aggregate.
• Commands are scoped to the logged-in user's company; no need to pass company_code.