20.8.2 向客服发送消息

使用接口可以向客服人员发送消息，支持文本、图片、文件消息。sender和receiver中有且仅有一个类型为kf。当receiver为kf时，表示向客服发送用户咨询的问题消息。当sender为kf时，表示客服从其他IM工具回复客户，并同步消息到客服的微信上。

向企业号客服发送客服消息的接口如下。

https:// qyapi.weixin.qq.com/cgi-bin/kf/send?access_token=ACCESS_TOKEN
  

向企业号客服发送客服消息时，POST数据示例如下。

文本消息的示例如下。

{
    "sender":{
        "type":"openid",
        "id":"oc7tbuDnDQtL30rGSPP7eobr3ddg"
    },
    "receiver":{
        "type":"kf",
        "id":"fangbei"
    },
    "msgtype":"text",
    "text":{
        "content":"hello!"
    }
}
  

图片消息的示例如下。

{
    "sender":{
        "type":"userid",
        "id":"lisi"
    },
    "receiver":{
        "type":"kf",
        "id":"zhangsan"
    },
    "msgtype":"image",
    "image":{
        "media_id":"MEDIA_ID"
    }
}
  

文件消息的示例如下。

{
    "sender":{
        "type":"userid",
        "id":"lisi"
    },
    "receiver":{
        "type":"kf",
        "id":"zhangsan"
    },
    "msgtype":"file",
    "file":{
        "media_id":"MEDIA_ID"
    }
}
  

语音消息的示例如下。

{
    "sender":{
        "type":"userid",
        "id":"lisi"
    },
    "receiver":{
        "type":"kf",
        "id":"zhangsan"
    },
    "msgtype":"voice",
    "voice":{
        "media_id":"MEDIA_ID"
    }
}
  

上述数据的参数说明如表20-37所示。

表20-37　向企业号客服发送客服消息接口的参数说明

正确提交时，返回的数据示例如下。

{
    "errcode":0,
    "errmsg":"ok"
}