该技能通过 wecom-cli 操作企业微信智能表格,完成客户数据的新增、查询、更新、删除,触发场景包括新增客户、添加客户、录入客户、查询客户、客户列表、更新客户信息、修改客户状态、删除客户、CRM 等。
首次使用需配置 CRM 表:先确认 memory 中是否已有配置,没有则向用户索取 CRM 智能表格链接,再用 wecom-cli doc smartsheet_get_sheet 与 smartsheet_get_fields 发现子表和字段,并将 URL、sheet_id、字段 schema 保存到 memory 文件 crm-config.md。
主要操作为:查询客户使用 smartsheet_get_records,返回记录及 record_id;新增客户使用 smartsheet_add_records,支持批量,一次最多 500 条;更新客户使用 smartsheet_update_records,必须携带 key_type 为 CELL_VALUE_KEY_TYPE_FIELD_TITLE,仅传需修改字段;删除客户使用 smartsheet_delete_records,支持批量最多 500 条,删除不可逆。
字段写入格式由字段类型决定:TEXT 用 text 格式,SINGLE_SELECT 用选项文本,PHONE_NUMBER 直接传字符串,USER 传 userid。更新和删除前必须先查询获取 record_id;创建时间、编辑时间、创建人、编辑人字段不可更新;SINGLE_SELECT 选项文本须精确匹配。辅助命令包括重新查表结构和通过 contact get_userlist 获取 userid。
限制:删除不可逆,需确认 record_id;更新不带 key_type 会导致字段标题无法识别;PHONE_NUMBER 不能使用文本格式;USER 字段在 CLI 中为 userid,webhook 中为 user_id。其余功能与收费信息暂未提供。