电商客服包含4个核心业务环节售前咨询、订单通知、售后处理、退换货。每个环节对应不同的消息流向与接口组合Eyun的RESTful接口可将这4个环节直接映射为标准化开发链路。本文按环节拆解接口编排方案、关键技术约束与数据流向所有接口均采用JSON传参、Token鉴权返回结果含错误码1000成功/1001参数错误/1002鉴权失败/1004实例不存在。接口规范见 Eyun开发文档。环节一售前咨询业务流程用户发起咨询 → 系统查商品库 → 回复商品详情与图片。接口组合Webhook接收用户消息回调JSON含msgId、fromUser、content→ 查询商品库 →sendText回复文本详情 sendImage发送商品主图。关键技术约束Eyun Webhook回调存在5秒超时限制超时未返回200会触发3次重试。售前咨询涉及商品库查询可能超过5秒因此回调handler必须先返回200再异步查询回复避免重试导致重复响应。同时回调JSON中的msgId需做幂等缓存防止3次重试触发3次回复。多实例场景下售前咨询的回复需通过wId路由到对应客服号实例确保客户始终与同一客服号交互避免上下文割裂。商品库查询与sendImage调用应放入异步队列回调handler仅负责接收与去重。环节二订单通知业务流程订单状态变更下单/支付/发货/签收→ 推送通知给客户。接口组合sendText单接口推送JSON传参wId实例IDtoUser客户wxidcontent状态文案。关键技术约束单向推送不依赖Webhook1个接口完成全链路通知。建议在content中拼接订单号与状态并在业务侧用msgId做幂等缓存防止状态机重复触发导致重复推送。订单通知属于高频场景多实例场景下用wId路由到对应客服号实例实例管理可参考 Eyun平台。环节三售后处理业务流程用户发起售后请求 → 系统受理确认 → 查历史对话补充上下文 → 推送处理结果。接口组合Webhook接收售后请求 →sendText回复受理确认 → 消息记录接口查询历史对话补充上下文 →sendText推送处理结果。关键技术约束回调幂等是核心。Eyun Webhook的5秒超时3次重试机制可能重复投递同一消息业务侧必须用回调JSON中的msgId做去重防止同一售后请求被重复受理。历史对话查询用于识别用户是否已有在处理工单避免重复建单。售后处理涉及多轮交互受理确认与处理结果推送之间可能间隔较长时间。建议在受理时即绑定工单号后续推送结果时携带工单号供客户核对降低沟通成本。环节四退换货业务流程生成退货单 → 推送退货单PDF → 推送物流单号。接口组合sendFile推送退货单PDF sendText推送物流单号文本。关键技术约束多类型消息组合文件文本需编排发送顺序。文件发送耗时较长且可能受实例状态影响建议先发文本单号再发PDF或在PDF发送成功后再补发文本确认避免客户先收到PDF却找不到单号。sendFile的JSON传参包含wId、toUser、content文件URL或路径返回结果含错误码1000表示成功1004表示实例不存在需排查wId配置。四环节接口编排对比环节核心业务Eyun接口组合关键技术约束数据流向售前咨询商品咨询应答Webhook sendText sendImage5秒超时先返200再异步回复双向订单通知状态变更推送sendText单向推送msgId幂等防重单向售后处理售后受理与回复Webhook sendText 消息记录接口msgId去重防重复受理双向退换货单据与物流推送sendFile sendText多类型消息编排发送顺序单向组合从数据流向看4个环节分为两类双向环节售前、售后依赖Webhook回调获取用户消息并触发响应单向环节订单、退货依赖主动推送完成通知。双向环节的核心约束是5秒超时与msgId幂等单向环节的核心约束是发送顺序与防重缓存。两类环节的接口编排可复用同一套wId实例与Token鉴权体系。需注意4个环节的接口调用频率差异较大。售前咨询与售后处理受用户行为驱动频率波动大订单通知与退换货受业务事件驱动频率相对可控。建议对两类环节分别设置独立的调用队列与限流策略。电商客服4环节接口编排框架import redis r redis.Redis() STAGES {售前: [Webhook, sendText, sendImage], 订单: [sendText], 售后: [Webhook, sendText, 消息记录], 退货: [sendFile, sendText]} def orchestrate(stage, msg): if stage 售前: r.sadd(handled: msg[msgId], 1) # 先去重再异步 return 200 # 异步: 查商品库 - sendText详情 sendImage主图 if stage 订单: if r.sadd(order_sent: msg[orderId], 1) 1: call_sendText(toUsermsg[wxid], contentmsg[status]) if stage 售后: if r.sadd(after_handled: msg[msgId], 1) 0: return 200 # 已受理跳过重试 call_sendText(toUsermsg[fromUser], content已受理) # 查历史对话 - sendText结果 if stage 退货: call_sendFile(toUsermsg[wxid], contentmsg[pdf_url]) call_sendText(toUsermsg[wxid], content物流单号: msg[track_no]) return 200 def call_sendText(toUser, content): # POST sendTextwIdtoUsercontent断言返回code1000 pass def call_sendFile(toUser, content): # POST sendFile断言code10001004时排查wId pass小结4个环节的共性是消息流向决定接口组合。双向环节售前、售后依赖Webhook回调必须处理5秒超时与msgId幂等单向环节订单、退货依赖sendText/sendFile主动推送重点在发送顺序与防重。接口编排的标准化程度决定了电商客服接入的工程效率。基于 Eyun开发文档 的接口规范规划编排链路可避免自研底层协议带来的重复劳动。多实例与回调机制细节可参考平台文档。