微信公众平台开发 - 客服接口

发送客服消息

当用户主动发消息给公众号的时候(包括发送信息、点击自定义菜单、订阅事件、扫描二维码事件、支付成功事件、用户维权),微信将会把消息数据推送给开发者,开发者在一段时间内(目前修改为48小时)可以调用客服消息接口,通过POST一个JSON数据包来发送消息给普通用户, 在48小时内不限制发送次数。此接口主要用于客服等有人工消息处理环节的功能,方便开发者为用户提供更加优质的服务。

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

若发送对象在48小时内没有给公众号发送消息,系统会返回错误。注意Http Status依然返回200,这点不符合Restful精神啊

image

发送文本消息

{
    “touser”:”OPENID”,
    “msgtype”:”text”,
    “text”:
    {
         “content”:”Hello World”
    }
}

发送图片消息,其他媒体类型发送同图片

发送图片消息前先调用文件上传接口获得mediaId。图片格式必须为jpg类型
{
“touser”:”OPENID”,
“msgtype”:”image”,
“image”:
{
“media_id”:”MEDIA_ID”
}
}
注意事项:

  • 只有认证服务号才可以上传多媒体文件到微信服务器
  • 多媒体文件会在发送到微信服务器后3天后自动删除
  • 上传的多媒体文件有格式和大小限制
    1. 图片(image): 1M,支持JPG格式
    2. 语音(voice):2M,播放长度不超过60s,支持AMR\MP3格式
    3. 视频(video):10MB,支持MP4格式
    4. 缩略图(thumb):64KB,支持JPG格式

参考文档:微信公众平台开发文档