商务记录填写
目标
销售输入自然语言后,自动整理并创建商务记录。 如果信息缺失,先提醒补充。 提交前必须让用户确认。
注意:商务记录查询功能已移至 lcrm-search skill,本 skill 仅负责创建商务记录。
脚本入口
- 主脚本:
node scripts/business-record.mjs <action> [options] - 环境变量:
- 必填:LCRM_API_KEY - 可选:LCRM_BASE_URL(默认 https://crm.langcore.net)
目标接口
POST /api/business-records
请求体关键字段:
- 必填:
- customerId 或 leadId(二选一,销售场景优先 customerId) - followUpType(枚举) - contactedPerson - description(去 HTML 后至少 10 个字)
- 可选:
- opportunityId - opportunityStatus - estimatedCloseDate - actualCloseDate - attachments
followUpType 枚举:
微信电话线上会议邮件现场拜访商务活动其他
必须执行的流程
- 解析用户输入,抽取:
- 客户名称 - 联系人名称 - 跟进类型(若无法判断先置空) - 记录内容
- 客户名称转 ID:
- 脚本:node scripts/business-record.mjs find-customer --company-name "<客户名>" --limit 5 - 无结果:告知客户不存在并让用户补充准确名称。 - 多结果:列候选让用户确认唯一客户。
- 联系人校验(建议):
- 脚本:node scripts/business-record.mjs customer-detail --customer-id "<customerId>",检查联系人是否存在。 - 若未命中,不阻断,但提示"联系人未在系统中匹配到,将按文本写入 contactedPerson"。
- 组装 payload 并做本地校验:
- description 长度 >= 10 - followUpType 必须在枚举中
- 提交前确认(强制):
- 输出确认卡片,至少包含: - customerId + 客户名 - contactedPerson - followUpType - description 摘要 - 仅当用户明确回复"确认/提交/是"再执行 POST。
- 提交并回传结果:
- 脚本:node scripts/business-record.mjs create --payload '<JSON>' 或 --payload-file <file> - 成功:返回 id 与关键字段。 - 失败:透出后端错误并给下一步补充建议。
命令示例
node scripts/business-record.mjs create \
--customer-id "<customerId>" \
--follow-up-type "电话" \
--contacted-person "张三" \
--description "已与客户确认POC范围和预算,预计下周提交技术方案。"缺失信息提示模板
当以下字段缺失时,直接向用户追问:
- 缺客户名:
请补充客户名称。 - 缺联系人:
请补充本次对接人姓名。 - 缺跟进类型:
请补充跟进类型(微信/电话/线上会议/邮件/现场拜访/商务活动/其他)。 - 缺记录内容或不足 10 字:
请补充更完整的跟进记录(至少 10 个字)。 - 请求返回报错:
请先完善联系人信息(姓名、电话、角色)后再新增商务记录(此时需要用户前往LCRM系统web端完善联系人信息)。