看板读数据，操作发起写入。客服在当前会员会话里填写表单、确认提交，SRICH CHAT 服务端调用买方提供的 HTTPS 接口。买方负责验证权限、归属与业务规则，最终修改也发生在买方系统。

接口约定

运营按站点和操作配置地址、钥匙、表单字段。POST 携带 request_id、action、user_id、fields、人工客服 agent、conversation_code 和 Unix 秒 time。

AI 员工调用时使用员工能力规定的 actor，不能假装是人工客服；具体字段见员工能力契约。

表单控件决定值类型：文字是字符串，数字与金额是整数，金额用最小单位，开关为布尔值，日期是 YYYY-MM-DD，日期时间是 Unix 秒。前端校验通过不代表业务授权通过，买方仍须再验证。

成功、拒绝、未知必须分开

{"code":"OK","msg":"已完成指定操作"}

业务拒绝仍使用 HTTP 200，但 code 非 OK，msg 说明原因。接口应在 8 秒内回复，慢任务在自己的系统调度。

非 200、超时、坏 JSON 或没有 code，都不能猜成成功。超时可能已经执行，只是回复没有回来。客服系统不会自动补发这种写操作；人工确认后重试同一次操作沿用原 request_id。

去重是你们必须完成的一半

把 request_id 与业务处理结果持久记录，重复请求返回原结果，不再重复生效。去重记录与业务写入需要在你们自己的事务与并发控制下正确组合，不能只做一次“先查有没有”的内存判断。

客服系统先留操作审计再发请求，但网络与数据库不是一个跨系统原子操作；双方都不能仅凭这一步宣称 exactly-once。

验收三件事

正常一次成功；同编号再次请求得到相同结果且业务只执行一次；明确拒绝显示真实原因。再模拟断连、慢响应与并发重复，检查账本或业务记录。

操作审计给客服和运营看，不当作会员聊天消息。模板、按钮与表单的高自由度配置，不会替代这条执行边界。

产品与对接入口

本文为 2026-09-22 整理的公开说明；功能使用取决于已部署版本、配置和对接情况。接口实现以对应版本的帮助中心契约为准。