使用接口可以向客服人员发送消息,支持文本、图片、文件消息。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"}