# 客服消息介绍
当用户和公众号产生特定动作的交互时（具体动作列表请见下方说明），微信将会把消息数据推送给开发者，开发者可以在一段时间内调用客服接口，通过POST一个JSON数据包来发送消息给普通用户。此接口主要用于客服等有人工消息处理环节的功能，方便开发者为用户提供更加优质的服务。
目前允许的动作列表如下（公众平台会根据运营情况更新该列表，不同动作触发后，允许的客服接口）
- 用户发送信息
- 点击自定义菜单（仅有点击推事件、扫码推事件、扫码推事件且弹出“消息接收中”提示框这3种菜单类型是会触发客服接口的）
- 关注公众号
- 扫描二维码
- 支付成功
# 客服消息下发规则：
| 场景 | 下发额度 | 额度有效期 |
|---|---|---|
| 用户发送消息 | 5条 | 48小时 |
| 点击自定义菜单 | 3条 | 1分钟 |
| 关注公众号 | 3条 | 1分钟 |
| 扫描二维码 | 3条 | 1分钟 |
| 支付成功 | 无限制 | 48小时 |
特别说明：在用户点击菜单消息时，触发的是点击菜单事件，对应场景2点击自定义菜单的消息规则，不会产生用户发送消息场景的客服消息下发额度。
此外，为了帮助公众号使用不同的客服身份服务不同的用户群体，客服接口进行了升级，开发者可以管理客服账号，并设置客服账号的头像和昵称。该能力针对所有拥有客服接口权限的公众号开放。
以及，请开发者注意，本接口中所有使用到 media_id 的地方，现在都可以使用素材管理中的永久素材 media_id 。
# 客服消息接口列表
# 客服管理
| 接口名称 | 英文名 | 请求路径 |
|---|---|---|
| 添加客服账号 | addkfaccount | /customservice/kfaccount/add |
| 获取所有客服账号 | getkflist | /cgi-bin/customservice/getkflist |
| 获取在线客服列表 | getonlinekflist | /cgi-bin/customservice/getonlinekflist |
| 修改客服账号 | updatekfaccount | /customservice/kfaccount/update |
| 删除客服账号 | delkfaccount | /customservice/kfaccount/del |
| 设置客服头像 | uploadkfheadimg | /customservice/kfaccount/uploadheadimg |
| 邀请绑定客服账号 | invitekfworker | /customservice/kfaccount/inviteworker |
# 会话控制
| 接口名称 | 英文名 | 请求路径 |
|---|---|---|
| 创建会话 | createkfsession | /customservice/kfsession/create |
| 获取客服会话列表 | getkfsessionlist | /customservice/kfsession/getsessionlist |
| 获取客户会话状态 | getkfsession | /customservice/kfsession/getsession |
| 获取未接入会话列表 | getwaitcase | /customservice/kfsession/getwaitcase |
| 关闭会话 | closeSession | /customservice/kfsession/close |
# 客服消息
| 接口名称 | 英文名 | 请求路径 |
|---|---|---|
| 获取聊天记录 | getMsgList | /customservice/msgrecord/getmsglist |
| 发送客服消息 | sendCustomMessage | /cgi-bin/message/custom/send |
| 客服输入状态 | typing | /cgi-bin/message/custom/typing |