陌陌开发者文档接收风波推送目录1关注/取消关注风波2扫描带参数二维码风波3上报地理位置风波4自定义菜单风波5点击菜单拉取消息时的风波推送6点击菜单跳转链接时的风波推送关注/取消关注风波用户在关注与取消关注公众号时,陌陌会把这个风波推送到开发者填写的URL。便捷开发者给用户下发欢迎消息或则做账号的解绑。陌陌服务器在五秒内收不到响应会断开联接,而且重新发起恳求,总共重试三次关于重试的消息排重,推荐使用FromUserName+CreateTime排重。如果服务器难以保证在五秒内处理并回复,可以直接回复空串,陌陌服务器不会对此作任何处理,而且不会发起重试。推送XML数据包示例:123456789参数说明:参数描述ToUserName开发者微讯号FromUserName发送方账号(一个OpenID)CreateTime消息创建时间(整型)MsgType消息类型,eventEvent风波类型,subscribe(订阅)、unsubscribe(取消订阅)扫描带参数二维码风波用户扫描带场景值二维码时,可能推送以下两种风波:1.假如用户还未关注公众号,则用户可以关注公众号,关注后陌陌会将带场景值关注风波推献给开发者。
2.假如用户早已关注公众号,则陌陌会将带场景值扫描风波推献给开发者。1.用户未关注时,进行关注后的风波推送推送XML数据包示例:123456789参数说明:参数描述ToUserName开发者微讯号FromUserName发送方账号(一个OpenID)CreateTime消息创建时间(整型)MsgType消息类型,eventEvent风波类型,subscribeEventKey风波KEY值,qrscene_为前缀,旁边为二维码的参数值Ticket二维码的ticket,可拿来换取二维码图片2.用户已关注时的风波推送推送XML数据包示例:123456789参数说明:参数描述ToUserName开发者微讯号FromUserName发送方账号(一个OpenID)CreateTime消息创建时间(整型)MsgType消息类型,eventEvent风波类型,SCANEventKey风波KEY值,是一个32位无符号整数,即创建二维码时的二维码scene_idTicket二维码的ticket,可拿来换取二维码图片上报地理位置风波用户同意上报地理位置后,每次步入公众号会话时,就会在步入时上报地理位置,或在步入会话后每5秒上报一次地理位置,公众号可以在公众平台网站中更改以上设置。上报地理位置时,陌陌会将上报地理位置风波推送到开发者填写的URL。推送XML数据包示例:12345678923.137466113.352425
119.385040
参数说明:参数描述ToUserName开发者微讯号FromUserName发送方账号(一个OpenID)CreateTime消息创建时间(整型)MsgType消息类型,eventEvent风波类型,LOCATIONLatitude地理位置经度Longitude地理位置纬度Precision地理位置精度使用网页调试工具调试该插口自定义菜单风波用户点击自定义菜单后,陌陌会把点击风波推献给开发者,请注意,点击菜单弹出子菜单,不会形成上报。点击菜单拉取消息时的风波推送推送XML数据包示例:123456789参数说明:参数描述ToUserName开发者微讯号FromUserName发送方账号(一个OpenID)CreateTime消息创建时间(整型)MsgType消息类型,eventEvent风波类型,CLICKEventKey风波KEY值,与自定义菜单插口中KEY值对应点击菜单跳转链接时的风波推送推送XML数据包示例:123456789参数说明:参数描述ToUserName开发者微讯号FromUserName发送方账号(一个OpenID)CreateTime消息创建时间(整型)MsgType消息类型,eventEvent风波类型,VIEWEventKey风波KEY值,设置的跳转URL开通语音辨识功能用户每次发送语音给公众号时,陌陌会在推送的语音消息XML数据包中,降低一个Recongnition数组。
注:因为顾客端缓存,开发者开启或则关掉语音辨识功能,对新关注者立即生效,对已关注用户须要24小时生效。开发者可以重新关注此账号进行测试。开启语音辨识后的语音XML数据包如下:13572909131234567890123456参数说明:参数描述ToUserName开发者微讯号FromUserName发送方账号(一个OpenID)CreateTime消息创建时间(整型)MsgType语音为voiceMediaID语音消息媒体id,可以调用多媒体文件下载插口拉取该媒体Format语音格式:amrRecognition语音辨识结果,UTF8编码MsgID消息id,64位整型发送被动响应消息对于每一个POST恳求,开发者在响应包(Get)中返回特定XML结构,对该消息进行响应(现支持回复文本、图片、图文、语音、视频、音乐)。请注意,回复图片等多媒体消息时须要预先上传多媒体文件到陌陌服务器,只支持认证服务号。陌陌服务器在五秒内收不到响应会断开联接,而且重新发起恳求,总共重试三次,假如在调试中,发觉用户难以收到响应的消息,可以检测是否消息处理超时。
关于重试的消息排重,有msgid的消息推荐使用msgid排重。风波类型消息推荐使用FromUserName+CreateTime排重。如果服务器难以保证在五秒内处理并回复,必须直接回复空串(是指回复一个空字符串,而不是一个XML结构体中content数组的内容为空,请请勿误会),陌陌服务器不会对此作任何处理,而且不会发起重试。。这些情况下,可以使用客服消息插口进行异步回复。请开发者注意,一旦碰到以下情况,陌陌就会在公众号会话中,向用户下发系统提示“该公众号暂时未能提供服务,请稍后再试”:1、开发者在5秒内未回复任何内容2、开发者回复了异常数据,例如JSON数据等各消息类型须要的XML数据包结构如下。目录1回复文本消息2回复图片消息3回复语音消息4回复视频消息5回复音乐消息6回复图文消息回复文本消息12345678参数是否必须描述ToUserName是接收方账号(收到的OpenID)FromUserName是开发者微讯号CreateTime是消息创建时间(整型)MsgType是textContent是回复的消息内容(换行:在content中才能换行,陌陌顾客端就支持换行显示)回复图片消息12345678参数是否必须说明ToUserName是接收方账号(收到的OpenID)FromUserName是开发者微讯号CreateTime是消息创建时间(整型)MsgType是imageMediaId是通过上传多媒体文件,得到的id。
回复语音消息12345678参数是否必须说明ToUserName是接收方账号(收到的OpenID)FromUserName是开发者微讯号CreateTime是消息创建时间戳(整型)MsgType是语音,voiceMediaId是通过上传多媒体文件,得到的id回复视频消息12345678参数是否必须说明ToUserName是接收方账号(收到的OpenID)FromUserName是开发者微讯号CreateTime是消息创建时间(整型)MsgType是videoMediaId是通过上传多媒体文件,得到的idTitle否视频消息的标题Description否视频消息的描述回复音乐消息12345678参数是否必须说明ToUserName是接收方账号(收到的OpenID)FromUserName是开发者微讯号CreateTime是消息创建时间(整型)MsgType是musicTitle否音乐标题Description否音乐描述MusicURL否音乐链接HQMusicUrl否高质量音乐链接,WIFI环境优先使用该链接播放音乐ThumbMediaId是缩略图的媒体id,通过上传多媒体文件,得到的id回复图文消息123456782
参数是否必须说明ToUserName是接收方账号(收到的OpenID)FromUserName是开发者微讯号CreateTime是消息创建时间(整型)MsgType是newsArticleCount是图文消息个数,限制为10条以内Articles是多条图文消息信息,默认第一个item为大图,注意,假若图文数超过10,则将会无响应Title否图文消息标题Description否图文消息描述PicUrl否图片链接,支持JPG、PNG格式,较好的疗效为大图360*200,小图200*200Url否点击图文消息跳转链接发送客服消息出自陌陌公众平台开发者文档当用户主动发消息给公众号的时侯(包括发送信息、点击自定义菜单、订阅风波、扫描二维码风波、支付成功风波、用户维权),陌陌将会把消息数据推献给开发者,开发者在一段时间内(目前更改为48小时)可以调用客服消息插口,通过POST一个JSON数据包来发送消息给普通用户,在48小时内不限制发送次数。此插口主要用于客服等有人工消息处理环节的功能,便捷开发者为用户提供愈发优质的服务。插口调用恳求说明http恳求形式:POSTCESS_TOKEN各消息类型所需的JSON数据包如下。
发送文本消息{"touser":"OPENID","msgtype":"text","text":{"content":"HelloWorld"}}参数是否必须说明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","thumb_media_id":"MEDIA_ID","title":"TITLE","description":"DESCRIPTION"}}参数是否必须说明access_token是调用插口账簿touser是普通用户openidmsgtype是消息类型,videomedia_id是发送的视频的媒体IDthumb_media_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":"HappyDay","description":"IsReallyAHappyDay","url":"URL","picurl":"PIC_URL"},{"title":"HappyDay","description":"IsReallyAHappyDay","url":"URL","picurl":"PIC_URL"}]}}参数是否必须说明access_token是调用插口账簿touser是普通用户openidmsgtype是消息类型,newstitle否标题description否描述url否点击后跳转的链接图文消息的图片链接,支持JPG、PNG格式,较好的疗效picurl否为大图640*320,小图80*80中级群发插口在公众平台网站上,为订阅号提供了每晚一条的群发权限,为服务号提供每月(自然月)4条的群发权限。而对于个别具备开发能力的公众号营运者,可以通过中级群发插口,实现更灵活的群发能力。
请注意:1、对于认证订阅号,群发插口每晚可成功调用1次,这次群发可选择发送给全部用户或某个分组;2、对于认证服务号尽管开发者使用中级群发插口的每日调用限制为100次,并且用户每月只能接收4条,无论在公众平台网站上,还是使用插口群发,用户每月只能接收4条群发消息,少于4条的群发将对该用户发送失败;3、具备陌陌支付权限的公众号,在使用群发插口上传、群发图文消息类型时,可使用标签加入外链;4、开发者可以使用预览插口校对消息款式和排版,通过预览插口可发送编辑好的消息给指定用户校准疗效。上传图文消息素材【订阅号与服务号认证后均可用】接口调用恳求说明http恳求形式:POSTPOST数据说明POST数据示例如下:{"articles":[{"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p","author":"xxx","title":"HappyDay","content_source_url":"www.qq.com","content":"content","digest":"digest","show_cover_pic":"1"},{"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p","author":"xxx","title":"HappyDay","content_source_url":"www.qq.com","content":"content","digest":"digest","show_cover_pic":"0"}]}参数是否必须说明Articles是图文消息,一个图文消息支持1到10条图文图文消息缩略图的media_id,可以在基础支持-上传thumb_media_id是多媒体文件插口中获得author否图文消息的作者title是图文消息的标题content_source_url否在图文消息页面点击“阅读原文”后的页面content是图文消息页面的内容,支持HTML标签digest否图文消息的描述show_cover_pic否是否显示封面,1为显示,0为不显示返回说明返回数据示例(正确时的JSON返回结果):{"type":"news","media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ","created_at":1391857799}参数说明媒体文件类型,分别有图片(image)、语音(voice)、type视频(video)和缩略图(thumb),次数为news,即图文消息Media_id媒体文件/图文消息上传后获取的惟一标示created_at媒体文件上传时间错误时陌陌会返回错误码等信息,请依照错误码查询错误信息:全局返回码说明依照分组进行群发【订阅号与服务号认证后均可用】接口调用恳求说明http恳求形式:POSTPOST数据说明POST数据示例如下:图文消息(注意图文消息的media_id须要通过上述方式来得到):{"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"}语音(注意此处media_id需通过基础支持中的上传下载多媒体文件来得到):{"filter":{"is_to_all":false"group_id":"2"},"voice":{"media_id":"123dsdajkasd231jhksad"},"msgtype":"voice"}图片(注意此处media_id需通过基础支持中的上传下载多媒体文件来得到):{"filter":{"is_to_all":false"group_id":"2"},"image":{"media_id":"123dsdajkasd231jhksad"},"msgtype":"image"}视频请注意,此处视频的media_id需通过POST恳求到下列插口非常地得到:=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是用于设定图文消息的接收者用于设定是否向全部用户发送,值为true或false,选is_to_all否择true该消息群发给所有用户,选择false可依照group_id发送给指定群组的用户群发到的分组的group_id,出席用户管理中用户分组接Group_id否口,若is_to_all值为true,可不填写group_idMpnews是用于设定正式发送的图文消息Media_id是用于群发的消息的media_id群发的消息类型,图文消息为mpnews,文本消息为text,msgtype是语音为voice,音乐为music,图片为image,视频为videoTitle否消息的标题description否消息的描述Thumb_media_id是视频缩略图的媒体ID返回说明返回数据示例(正确时的JSON返回结果):{"errcode":0,"errmsg":"sendjobsubmissionsuccess","msg_id":34182}参数说明媒体文件类型,分别有图片(image)、语音(voice)、type视频(video)和缩略图(thumb),图文消息为newserrcode错误码errmsg错误信息msg_id消息ID请注意:在返回成功时,意味着群发任务递交成功,并不意味着此时群发早已结束,所以,仍有可能在后续的发送过程中出现异常情况引起用户未收到消息,如消息有时会进行初审、服务器不稳定等。
据悉,群发任务通常须要较长的时间才会全部发送完毕,请耐心等待。错误时陌陌会返回错误码等信息,请依照错误码查询错误信息:全局返回码说明按照OpenID列表群发【订阅号不可用,服务号认证后可用】接口调用恳求说明http恳求形式:POSTPOST数据说明POST数据示例如下:图文消息(注意图文消息的media_id须要通过上述方式来得到):{"touser":["OPENID1","OPENID2"],"mpnews":{"media_id":"123dsdajkasd231jhksad"},"msgtype":"mpnews"}文本:{"touser":["OPENID1","OPENID2"],"msgtype":"text","text":{"content":"hellofromboxer."}}语音:{"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恳求到下列插口非常地得到:=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"}参数是否必须说明填写图文消息的接收者,一串OpenID列表,OpenID最少touser是个,最多10000个mpnews是用于设定正式发送的图文消息media_id是用于群发的图文消息的media_id群发的消息类型,图文消息为mpnews,文本消息为text,msgtype是语音为voice,音乐为music,图片为image,视频为videotitle否消息的标题description否消息的描述thumb_media_id是视频缩略图的媒体ID返回说明返回数据示例(正确时的JSON返回结果):{"errcode":0,"errmsg":"sendjobsubmissionsuccess","msg_id":34182}参数说明媒体文件类型,分别有图片(image)、语音(voice)、type视频(video)和缩略图(thumb),次数为news,即图文消息errcode错误码errmsg错误信息msg_id消息ID请注意:在返回成功时,意味着群发任务递交成功,并不意味着此时群发早已结束,所以,仍有可能在后续的发送过程中出现异常情况引起用户未收到消息,如消息有时会进行初审、服务器不稳定等。
据悉,群发任务通常须要较长的时间才会全部发送完毕,请耐心等待。错误时陌陌会返回错误码等信息,请依照错误码查询错误信息:全局返回码说明删掉群发【订阅号与服务号认证后均可用】接口调用恳求说明http恳求形式:POSTPOST数据说明POST数据示例如下:{"msg_id":30124}参数是否必须说明msg_id是发送出去的消息ID请注意,只有早已发送成功的消息能够删掉删掉消息只是将消息的图文详情页失效,早已收到的用户,还是能在其本地听到消息卡片。另外,删掉群发消息只能删掉图文消息和视频消息,其他类型的消息一经发送,难以删掉。返回说明返回数据示例(正确时的JSON返回结果):{"errcode":0,"errmsg":"ok"}参数说明errcode错误码errmsg错误信息错误时陌陌会返回错误码等信息,请依照错误码查询错误信息:全局返回码说明预览插口【订阅号与服务号认证后均可用】开发者可通过该插口发送消息给指定用户,在手机端查看消息的款式和排版。插口调用恳求说明http恳求形式:POSTPOST数据说明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群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,msgtype音乐为music,图片为image,视频为videoMedia_id用于群发的消息的media_idcontent发送文本消息时文本的内容返回说明返回数据示例(正确时的JSON返回结果):{"errcode":0,"errmsg":"sendjobsubmissionsuccess","msg_id":34182}参数说明errcode错误码errmsg错误信息msg_id消息ID查询群发消息发送状态【订阅号与服务号认证后均可用】接口调用恳求说明http恳求形式:POSTS_TOKENPOST数据说明POST数据示例如下:{"msg_id":"201053012"}参数说明msg_id群发消息后返回的消息id返回说明返回数据示例(正确时的JSON返回结果):{"msg_id":201053012,"msg_status":"SEND_SUCCESS"}参数说明msg_id群发消息后返回的消息idmsg_status消息发送后的状态,SEND_SUCCESS表示发送成功风波推送群发结果因为群发任务递交后,群发任务可能在一定时间后才完成,为此,群发插口调用时,仅会给出群发任务是否递交成功的提示,若群发任务递交成功,则在群发任务结束时,会向开发者在公众平台填写的开发者URL(callbackURL)推送风波。
推送的XML结构如下(发送成功时):1394524295198810080755参数说明ToUserName公众号的微讯号FromUserName公众号群发助手的微讯号,为mphelperCreateTime创建时间的时间戳MsgType消息类型,此处为eventEvent风波信息,此处为MASSSENDJOBFINISHMsgID群发的消息ID群发的结构,为“sendsuccess”或“sendfail”或“err(num)”。但sendsuccess时,也有可能因用户拒收公众号的消息、系统错误等诱因引起少量用户接收失败。err(num)是初审失败的具体缘由,可能的情况如下:Statuserr(10001),//涉嫌广告err(20001),//涉嫌政治err(20004),//涉嫌社会err(20002),//涉嫌淫秽err(20006),//涉嫌违规犯罪err(20008),//涉嫌欺诈err(20013),//涉嫌版权err(22000),//涉嫌互推(相互宣传)err(21000),//涉嫌其他TotalCountgroup_id下粉丝数;或则openid_list中的粉丝数过滤(过滤是指特定地区、性别的过滤、用户设置拒收的过滤,用户接收FilterCount已超4条的过滤)后,打算发送的粉丝数,原则上,FilterCount=SentCount+ErrorCountSentCount发送成功的粉丝数ErrorCount发送失败的粉丝数模板消息插口模板消息仅用于公众号向用户发送重要的服务通知,只能用于符合其要求的服务场景中,如信用卡刷q版知,商品订购成功通知等。
不支持广告等营销类消息以及其它所有可能对用户导致恐吓的消息。关于使用规则,请注意:、所有服务号都可以在功能->添加功能插件处见到申请模板消息功能的入口,1但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限;2、需要选择公众帐号服务所处的2个行业,每月可修改1次所选行业;3、在所选择行业的模板库中选用已有的模板进行调用;4、每个帐号可以同时使用15个模板。5、当前每位模板的日调用上限为100000次【2014年11月18日将插口调用频度从默认的日10000次提高为日100000次,可在MP登陆后的开发者中心查看】。关于插口文档,请注意:1、模板消息调用时主要须要模板ID和模板中各参数的形参内容;2、模板中参数内容必须以".DATA"结尾,否则视为保留字;3、模板保留符号"{{}}"。目录1设置所属行业2获得模板ID3发送模板消息4风波推送设置所属行业设置行业可在MP中完成,每月可更改行业1次,帐号仅可使用所属行业中相关的模板,为便捷第三方开发者,提供通过插口调用的方法来更改帐号所属行业,具体如下:插口调用恳求说明http恳求形式:POST_TOKENPOST数据说明POST数据示例如下:{"industry_id1":"1","industry_id2":"4"}参数说明参数是否必须说明industry_id1是公众号模板消息所属行业编号industry_id2是公众号模板消息所属行业编号行业代码查询主行业副行业代码IT科技互联网/电子商务1IT科技IT软件与服务2IT科技IT硬件与设备3IT科技电子技术4IT科技通讯与营运商5IT科技网路游戏6金融业建行7金融业基金|理财|信托8金融业保险9餐饮餐饮10饭店旅游饭店11饭店旅游旅游12运输与仓储快件13运输与仓储货运14运输与仓储仓储15教育培训16教育高校17政府与公共事业学术科研18政府与公共事业警察19政府与公共事业博物馆20政府与公共事业公共事业|非赢利机构21医药护理医药医疗22医药护理护理美容23医药护理保健与卫生24交通工具车辆相关25交通工具摩托车相关26交通工具列车相关27交通工具客机相关28房地产建筑29房地产物管30消费品消费品31商业服务法律32商业服务会展33商业服务中介服务34商业服务认证35商业服务审计36文体娱乐传媒37文体娱乐体育38文体娱乐娱乐休闲39彩印彩印40其它其它41获得模板ID从行业模板库选择模板到帐号后台,获得模板ID的过程可在MP中完成。
为便捷第三方开发者,提供通过插口调用的方法来更改帐号所属行业,具体如下:插口调用恳求说明http恳求形式:POSTaccess_token=ACCESS_TOKENPOST数据说明POST数据示例如下:{"template_id_short":"TM00015"}参数说明参数是否必须说明模板库中模板的编号,有“TM**”和“OPENTMTM**”template_id_short是等方式返回码说明在调用模板消息插口后,会返回JSON数据包。正常时的返回JSON数据包示例:{"errcode":0,"errmsg":"ok","template_id":"Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk"}发送模板消息插口调用恳求说明http恳求形式:POSTACCESS_TOKENPOST数据说明POST数据示例如下:{"touser":"OPENID","template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY","url":";,"topcolor":"#FF0000","data":{"first":{"value":"恭喜你选购成功~","color":"#173177"},"keynote1":{"value":"饼干","color":"#173177"},"keynote2":{"value":"39.8元","color":"#173177"},"keynote3":{"value":"2014年9月16日","color":"#173177"},"remark":{"value":"欢迎再度订购~","color":"#173177"}}}返回码说明在调用模板消息插口后,会返回JSON数据包。
正常时的返回JSON数据包示例:{"errcode":0,"errmsg":"ok","msgid":200228332}风波推送在模版消息发送任务完成后,陌陌服务器会将是否送达成功作为通知,发送到开发者中心中填写的服务器配置地址中。1、送达成功时,推送的XML如下:1395658920200163836参数说明参数说明ToUserName公众号微讯号FromUserName接收模板消息的用户的openidCreateTime创建时间MsgType消息类型是风波Event风波为模板消息发送结束MsgID消息idStatus发送状态为成功2、送达因为用户拒收(用户设置拒绝接收公众号消息)而失败时,推送的XML如下:1395658984200163840参数说明参数说明ToUserName公众号微讯号FromUserName接收模板消息的用户的openidCreateTime创建时间MsgType消息类型是风波Event风波为模板消息发送结束MsgID消息idStatus发送状态为用户拒绝接收3、送达因为其他诱因失败时,推送的XML如下:1395658984200163840参数说明参数说明ToUserName公众号微讯号FromUserName接收模板消息的用户的openidCreateTime创建时间MsgType消息类型是风波Event风波为模板消息发送结束MsgID消息idStatus发送状态为发送失败(非用户拒绝)