公众号客服完整闭环
公众号客服页面整合客服账号、在线状态、会话控制、聊天记录和输入状态。
前置条件
- 当前账号必须是公众号
app_type=2。 - 公众号已开通客服能力。
- 客服微信号满足微信绑定规则。
- 公众号消息服务器和回调配置正常。
客服账号管理
支持:
- 查询微信侧客服账号和在线状态。
- 邀请微信号绑定客服。
- 修改客服昵称。
- 上传客服头像。
- 删除客服账号。
客服账号实时保存在微信,不创建本地账号副本。邀请后需要被邀请人按微信流程确认,页面显示的邀请状态以微信返回为准。
会话控制
支持三类会话视图:
- 客服当前会话。
- 未接入等待会话。
- 指定用户的会话状态。
管理动作:
- 选择公众号和客服账号。
- 从等待队列选择用户创建会话。
- 客服完成服务后关闭会话。
- 刷新会话状态确认微信侧结果。
创建和关闭会话是微信实时操作,不维护本地会话副本。
聊天记录查询
聊天记录按微信接口要求使用时间范围、起始位置和数量查询。记录不落本地副本。
注意:
- 微信限制单次查询时间范围和数量。
- 返回内容类型可能包含文本、图片、小程序卡片等。
- 历史记录保存周期以微信规则为准。
- 客服聊天记录含用户数据,只授予客服主管或审计角色。
输入状态
客服在回复前可向用户显示“正在输入”。操作需要公众号、用户 OpenID、客服账号和微信允许的输入状态值。
输入状态是短时效果,不表示消息已经发送,也不应由定时任务长时间维持。
权限
| 能力 | 权限 |
|---|---|
| 客服账号查看 | wxmp:wxkefu:index |
| 邀请账号 | wxmp:wxkefu:add |
| 修改昵称和头像 | wxmp:wxkefu:edit |
| 删除账号 | wxmp:wxkefu:del |
| 查看会话 | wxmp:wxkefu:session:index |
| 创建/关闭会话 | wxmp:wxkefu:session:manage |
| 查看聊天记录 | wxmp:wxkefu:record:index |
| 设置输入状态 | wxmp:wxkefu:typing |
完整操作流程
邀请客服 → 客服确认绑定 → 检查在线状态 → 查看等待用户 → 创建会话 → 查询聊天记录 → 设置输入状态并回复 → 关闭会话。
常见问题
邀请后列表没有客服
确认被邀请微信号已完成确认,并刷新微信实时列表。
无法创建会话
确认用户位于等待队列、客服账号有效且当前会话数量没有达到微信限制。
聊天记录为空
缩短时间范围,检查起止时间戳和分页位置,并确认公众号具备记录查询权限。
输入状态失败
确认用户当前处于允许客服回复的会话窗口,并使用微信实际客服账号。