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

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

接口调用请求说明

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

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

目录

[隐藏]

• 1 发送文本消息
• 2 发送图片消息
• 3 发送语音消息
• 4 发送视频消息
• 5 发送音乐消息
• 6 发送图文消息

发送文本消息

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

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

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

发送图片消息

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

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

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

发送语音消息

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

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

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

发送视频消息

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

参数是否必须说明access_token是调用接口凭证touser是普通用户openidmsgtype是消息类型，videomedia_id是发送的视频的媒体IDtitle否视频消息的标题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是普通用户openidmsgtype是消息类型，musictitle否音乐标题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是普通用户openidmsgtype是消息类型，newstitle否标题description否描述url否点击后跳转的链接picurl否图文消息的图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80

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