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

接口调用请求说明

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

各消息类型所需的JSON数据包如下。

一、发送文本消息

{ "touser":"OPENID", "msgtype":"text", "text": { "content":"Hello World" } }

参数	是否必须	说明
access_token	是	调用接口凭证
touser	是	普通用户openid
msgtype	是	消息类型，text
content	是	文本消息内容

使用网页调试工具调试该接口

二、发送图片消息

{ "touser":"OPENID", "msgtype":"image", "image": { "media_id":"MEDIA_ID" } }

参数	是否必须	说明
access_token	是	调用接口凭证
touser	是	普通用户openid
msgtype	是	消息类型，image
media_id	是	发送的图片的媒体ID

使用网页调试工具调试该接口

三、发送语音消息

{ "touser":"OPENID", "msgtype":"voice", "voice": { "media_id":"MEDIA_ID" } }

参数	是否必须	说明
access_token	是	调用接口凭证
touser	是	普通用户openid
msgtype	是	消息类型，voice
media_id	是	发送的语音的媒体ID

使用网页调试工具调试该接口

四、发送视频消息

{ "touser":"OPENID", "msgtype":"video", "video": { "media_id":"MEDIA_ID", "title":"TITLE", "description":"DESCRIPTION" } }

参数	是否必须	说明
access_token	是	调用接口凭证
touser	是	普通用户openid
msgtype	是	消息类型，video
media_id	是	发送的视频的媒体ID
title	否	视频消息的标题
description	否	视频消息的描述

使用网页调试工具调试该接口

五、发送音乐消息

{ "touser":"OPENID", "msgtype":"music", "music": { "title":"MUSIC_TITLE", "description":"MUSIC_DESCRIPTION", "musicurl":"MUSIC_URL", "hqmusicurl":"HQ_MUSIC_URL", "thumb_media_id":"THUMB_MEDIA_ID" } }

参数	是否必须	说明
access_token	是	调用接口凭证
touser	是	普通用户openid
msgtype	是	消息类型，music
title	否	音乐标题
description	否	音乐描述
musicurl	是	音乐链接
hqmusicurl	是	高品质音乐链接，wifi环境优先使用该链接播放音乐
thumb_media_id	是	缩略图的媒体ID

使用网页调试工具调试该接口

六、发送图文消息

图文消息条数限制在10条以内，注意，如果图文数超过10，则将会无响应。

{ "touser":"OPENID", "msgtype":"news", "news":{ "articles": [ { "title":"Happy Day", "description":"Is Really A Happy Day", "url":"URL", "picurl":"PIC_URL" }, { "title":"Happy Day", "description":"Is Really A Happy Day", "url":"URL", "picurl":"PIC_URL" } ] } }

参数	是否必须	说明
access_token	是	调用接口凭证
touser	是	普通用户openid
msgtype	是	消息类型，news
title	否	标题
description	否	描述
url	否	点击后跳转的链接
picurl	否	图文消息的图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80

使用网页调试工具调试该接口