微信小程序客服

顾客点小程序里的「联系客服」按钮进入微信客服会话，发的消息由 AI 回复；转人工后在后台「对话」里接待，回复会发回顾客的微信。

第一步：在后台「渠道」页接入。 填小程序的 AppID 和 AppSecret（微信公众平台 → 开发 → 开发管理 → 开发设置）。保存前会实际向微信换一次 access_token，填错会直接提示原因。我们用 stable_token 接口取令牌，不会让你自己服务器正在用的令牌失效。

第二步：配置消息推送。 微信公众平台 → 开发 → 开发管理 → 开发设置 → 消息推送，启用后照「渠道」页给出的内容填写：

提交时微信会来校验地址，成功后渠道状态变成「运行中」。小程序开了 IP 白名单的，要把渠道页显示的服务器 IP 加进去。

第三步：在小程序里放按钮。

<button open-type="contact" session-from="{{userToken}}">联系客服</button>

session-from 里放你服务器签发的 user_token（格式见 识别登录顾客），AI 就知道顾客是哪位会员，可以查订单；不放就按匿名顾客处理。令牌只在顾客进入会话时校验一次，建议 exp 给 1 小时以上。

说明：

• 顾客发消息后 48 小时内可以回复他（微信的规定），超过就要等顾客再发消息。发不出去的回复在「对话」里标红并写明原因。
• 目前处理文字消息和小程序卡片；图片、语音会记在对话里给座席看，AI 接待时会请顾客改用文字描述。
• 在渠道里填了「商品页路径」（如 pages/goods/detail?id={id}）时，AI 推荐的商品会另外发小程序卡片，{id} 换成商品的 external_id。商品要有 JPG 或 PNG 图片才发卡片。
• 同一顾客 24 小时内首次进入客服会话时发一次欢迎语，可以在渠道里关掉；内容用「机器人设置」里的欢迎语。
• 微信客服消息里不支持 Markdown，AI 会用纯文本回答。