接收与回复.docx

请求1.普通消息1 文本消息 1348831860 1234567890123456 2图片消息 1348831860 1234567890123456 3语音消息13572909131234567890123456开启语音识别后的语音XML数据包如下：135729091312345678901234564视频消息135729091312345678901234565小视频消息135729091312345678901234566地理位置消息135177636023.134521113.358803201234567890123456 7链接消息135177636023.134521113.358803201234567890123456 2.时间推送1 关注/取消关注事件1234567892 扫描带参数二维码事件用户未关注时，进行关注后的事件推送1234567893 上报地理位置事件12345678923.137466113.352425119.385040自定义菜单事件5 点击菜单拉取消息时的事件推送1234567896 点击菜单跳转链接时的事件推送123456789回复1. 被动回复1 回复文本消息123456782 回复图片消息123456783 回复语音消息123456784 回复视频消息12345678 5 回复音乐消息123456786 回复图文消息123456782 1客服帐号管理1.1添加客服帐号POST数据示例如下： kf_account: test1test, nickname: 客服1, password: pswmd5,返回说明（正确时的JSON返回结果）： errcode: 0, errmsg: ok,1.2修改客服帐号POST数据示例如下： kf_account: test1test, nickname: 客服1, password: pswmd5,返回说明（正确时的JSON返回结果）： errcode: 0, errmsg: ok,1.3删除客服帐号POST数据示例如下： kf_account: test1test, nickname: 客服1, password: pswmd5,返回说明（正确时的JSON返回结果）： errcode: 0, errmsg: ok,1.4 设置客服帐号的头像开发者可调用本接口来上传图片作为客服人员的头像：http请求方式: POST/FORM/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT返回说明（正确时的JSON返回结果）： errcode: 0, errmsg: ok,1.5 获取所有客服账号开发者通过本接口，获取公众号中所设置的客服基本信息，包括客服工号、客服昵称、客服登录账号。http请求方式: GET/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN返回说明（正确时的JSON返回结果）： kf_list: kf_account: test1test, kf_nick: ntest1, kf_id: 1001 kf_headimgurl: /mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0 , kf_account: test2test, kf_nick: ntest2, kf_id: 1002 kf_headimgurl: /mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0 , kf_account: test3test, kf_nick: ntest3, kf_id: 1003 kf_headimgurl: /mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0 1.6接口的统一参数说明2客服接口-发消息接口调用请求说明http请求方式: POST/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN发送文本消息 touser:OPENID, msgtype:text, text: content:Hello World 发送图片消息 touser:OPENID, msgtype:image, image: media_id:MEDIA_ID 发送语音消息 touser:OPENID, msgtype:voice, voice: media_id:MEDIA_ID 发送视频消息 touser:OPENID, msgtype:video, video: media_id:MEDIA_ID, thumb_media_id:MEDIA_ID, title:TITLE, description: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 发送图文消息 图文消息条数限制在8条以内，注意，如果图文数超过8，则将会无响应。 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 发送图文消息 图文消息条数限制在8条以内，注意，如果图文数超过8，则将会无响应。 touser:OPENID, msgtype:mpnews, mpnews: media_id:MEDIA_ID 发送卡券 touser:OPENID, msgtype:wxcard, wxcard: card_id:123dsdajkasd231jhksad, card_ext: code:,openid:,timestamp:1402057159,signature:017bb17407c8e0058a66d72dcc61632b70f511ad ,请注意，如果需要以某个客服帐号来发消息则需在JSON数据包的后半部分加入customservice参数，例如发送文本消息则改为： touser:OPENID, msgtype:text, text: content:Hello World , customservice: kf_account: test1kftest 上传图文消息内的图片获取URL接口调用请求说明http请求方式: POST/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN调用示例（使用curl命令，用FORM表单方式上传一个图片）：curl -F media=test.jpg /cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN返回说明正常情况下的返回结果为： url: /mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0上传图文消息素材接口调用请求说明http请求方式: POST/cgi-bin/media/uploadnews?access_token=ACCESS_TOKENPOST数据说明POST数据示例如下： articles: thumb_media_id:qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p, author:xxx, title:Happy Day, content_source_url:, content:content, digest:digest, show_cover_pic:1 , thumb_media_id:qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p, author:xxx, title:Happy Day, content_source_url:, content:content, digest:digest, show_cover_pic:0 返回说明返回数据示例（正确时的JSON返回结果）： type:news, media_id:CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ, created_at:1391857799根据分组进行群发POST数据说明POST数据示例如下：图文消息： filter: is_to_all:false, group_id:2 , mpnews: media_id:123dsdajkasd231jhksad , msgtype:mpnews文本： filter: is_to_all:false, group_id:2 , text: content:CONTENT , msgtype:text语音： filter: is_to_all:false, group_id:2 , voice: media_id:123dsdajkasd231jhksad , msgtype:voice图片： filter: is_to_all:false, group_id:2 , image: media_id:123dsdajkasd231jhksad , msgtype:image视频请注意，此处视频的media_id需通过POST请求到下述接口特别地得到：/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKENPOST数据如下（此处media_id需通过基础支持中的上传下载多媒体文件来得到）： media_id: rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ, title: TITLE, description: Description返回将为 type:video, media_id:IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc, created_at:1398848981然后，POST下述数据（将media_id改为上一步中得到的media_id），即可进行发送 filter: is_to_all:false, group_id:2 , mpvideo: media_id:IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc, , msgtype:mpvideo卡券消息： filter: is_to_all:false, group_id:2 , wxcard: card_id:123dsdajkasd231jhksad , msgtype:wxcard返回数据示例（正确时的JSON返回结果）： errcode:0, errmsg:send job submission success, msg_id:34182, msg_data_id: 206227730根据OpenID列表群发POST数据说明POST数据示例如下：图文消息（注意图文消息的media_id需要通过上述方法来得到）： touser: OPENID1, OPENID2 , mpnews: media_id:123dsdajkasd231jhksad , msgtype:mpnews文本： touser: OPENID1, OPENID2 , msgtype: text, text: content: hello from boxer.语音： touser: OPENID1, OPENID2 , voice: media_id:mLxl6paC7z2Tl-NJT64yzJve8T9c8u9K2x-Ai6Ujd4lIH9IBuF6-2r66mamn_gIT , msgtype:voice图片： touser: OPENID1, OPENID2 , image: media_id:BTgN0opcW3Y5zV_ZebbsD3NFKRWf6cb7OPswPi9Q83fOJHK2P67dzxn11Cp7THat , msgtype:image视频：请注意，此处视频的media_id需通过POST请求到下述接口特别地得到：/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKENPOST数据如下（此处media_id需通过基础支持中的上传下载多媒体文件来得到）： media_id: rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ, title: TITLE, description: Description返回将为 type:video, media_id:IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc, created_at:1398848981然后，POST下述数据（将media_id改为上一步中得到的media_id），即可进行发送 touser: OPENID1, OPENID2 , video: media_id:123dsdajkasd231jhksad, title:TITLE, description:DESCRIPTION , msgtype:video卡券： touser: OPENID1, OPENID2 , wxcard: card_id:123dsdajkasd231jhksad msgtype:wxcard返回数据示例（正确时的JSON返回结果）： errcode:0, errmsg:send job submission success, msg_id:34182, msg_data_id: 206227730删除群发POST数据示例如下： msg_id:30124返回数据示例（正确时的JSON返回结果）： errcode:0, errmsg:ok预览接口POST数据说明POST数据示例如下：图文消息（其中media_id与根据分组群发中的media_id相同）： touser:OPENID, mpnews: media_id:123dsdajkasd231jhksad , msgtype:mpnews 文本： touser:OPENID, text: content:CONTENT , msgtype:text语音（其中media_id与根据分组群发中的media_id相同）： touser:OPENID, voice: media_id:123dsdajkasd231jhksad , msgtype:voice 图片（其中media_id与根据分组群发中的media_id相同）： touser:OPENID, image: media_id:123dsdajkasd231jhksad , msgtype:image 视频（其中media_id与根据分组群发中的media_id相同）： touser:OPENID, mpvideo: media_id:IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc, , msgtype:mpvideo 卡券： touser:OPENID, wxcard: card_id:123dsdajkasd231jhksad, card_ext: code:,openid:,timestamp:1402057159,signature:017bb17407c8e0058a66d72dcc61632b70f511ad , msgtype:wxcard 请注意，上述JSON数据中的touser字段都可以改为towxname，这样就可以针对微信号进行预览（而非openID），towxname和touser同时赋值时，以towxname优先。修改后JSON数据如下（以图文消息为例）： 图文消息： towxname:示例的微信号, mpnews: media_id:123dsdajkasd231jhksad , msgtype:mpnews 返回数据示例（正确时的JSON返回结果）： errcode:0, errmsg:preview success, msg_id:34182查询群发消息发送状态POST数据示例如下： msg_id: 201053012返回数据示例（正确时的JSON返回结果）： msg_id:201053012, msg_status:SEND_SUCCESS模板消息接口设置所属行业POST数据示例如下： industry_id1:1, industry_id2:4 获取设置的行业信息返回说明正确调用后的返回示例：primary_industry:first_class:运输与仓储,second_class:快递,secondary_industry:first_class:IT科技,second_class:互联网|电子商务获得模板IDPOST数据示例如下： template_id_short:TM00015 返回码说明在调用模板消息接口后，会返回JSON数据包。正常时的返回JSON数据包示例： errcode:0, errmsg:ok, template_id:Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk 获取模板列表返回说明正确调用后的返回示例： template_list: template_id: iPk5sOIt5X_flOVKn5GrTFpncEYTojx6ddbt8WYoV5s, title: 领取奖金提醒, primary_