35CRM

概述

本技能已整合所有子技能功能，提供 CRM 平台的完整 API 操作能力。

平台信息

• 平台名称: 互联网+AI时代平台型CRM

模块覆盖

所有模块的接口路径和 viewId 映射见 [module_config.json](references/module_config.json)，包含：

• viewIdMap：模块名 → 新增表单 viewId
• listPathMap：模块名 → 列表查询接口路径
• insertPathMap：模块名 → 新增接口路径

支持的模块（31 个）

参考文档

基础文档（通用）

复杂模块文档（有特殊字段/枚举）

快速开始

信息收集

使用 AskUserQuestion 工具一次性收集凭据参数：

AskUserQuestion({
  questions: [
    { header: "平台地址", question: "CRM 平台的 base_url 是什么？", options: [{ label: "在下方输入平台地址", description: "例如 https://crm.example.com" }] },
    { header: "Token",    question: "API Token (PAT) 是什么？", options: [{ label: "在下方输入 Token", description: "在下方粘贴 Token 字符串" }] },
  ]
})

认证参数

认证方式：使用 Token (PAT) 认证，无需账号密码。详见 [authentication.md](references/authentication.md)。

脚本工具

命令行用法示例

# 验证 Token
python scripts/crm_login.py 
  --base-url https://xxx 
  --token xxx

# 查询任意模块列表（module_id 从 module_config.json 获取）
python scripts/crm_query.py 
  --base-url https://xxx 
  --token xxx 
  --module-id competitor

# 新增任意模块数据（viewId 从 module_config.json 获取）
python scripts/crm_form_submit.py 
  --base-url https://xxx 
  --token xxx 
  --view-id CompetitorAdd 
  --data '{"name":"测试竞争对手"}'

# 生成日报
python scripts/generate_reports.py day 
  --base-url https://xxx 
  --token xxx --emp-id xxx

通用操作流程

查询列表

1. 收集 base_url 和 token
2. 从 module_config.json 获取模块的 listPathMap 路径
3. 调用 scripts/crm_query.py 或使用 crm_query.py 中的 query() 函数
4. 通用参数见 [enums.md](references/enums.md)

新增数据

1. 收集 base_url 和 token
2. 从 module_config.json 获取模块的 viewIdMap 和 insertPathMap
3. 调用 scripts/crm_form_submit.py 加载模板
4. 提交数据

重要：技能目录规范

⚠️ 技能目录仅包含定义文件，不含任何用户数据或运行结果

• 所有查询结果、生成的报告、临时文件，必须保存到 workspace 或用户指定目录
• 禁止将任何运行输出写入 skills/crm-uniproud-api/ 及其子目录