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