《微信公众平台入门到精通》Vol.7

《微信公众平台入门到精通》Vol.72013-04-27又是出差忙碌的一周，今天刚到南京帮公司的活动撑场子，应酬到凌晨才回到酒店，不想再找借口，还是熬夜写个吧，先把几个事情说下。特别鸣谢：微商通weixin.st5.com（微信号：st5com）提供自定义菜单模式体验！1、公益培训收费是让希望大家认真学习，免费的东西很多人不懂得珍惜，我们并不做商业化探索，也不靠这个赚钱，更不缺钱，我个人有在参与收费的企业内部培训，但是这个公益培训各位真想多了，如果持怀疑态度的可以退订ZTalk，因为你并不了解青龙老贼这个人，也不信任ZTalk，再忍受我天天一个人的表演多没意思。2、雅安爱心捐款已经圆满结束，非常感谢大家的热心参与，WeMedia联盟共收到51316条回复，善款将捐献给壹基金，我们这几天就会与对方联系，即时将公示捐款凭证。3、我不是天使投资人，这次南京路演活动是公司（传媒梦工场）组织的，我是以点评嘉宾的身份参与，有朋友想要分享路演项目，昨天只有三个，一个做公务员考试网，一个做微信营销全案策划，一个做大学生兼职平台，今天有10个，我会分享给大家。第七章公众平台开发模式介绍从今天开始教程进入高级阶段，请大家认真、专心，还有执着，我会很耐心的在后台回复每个人的提问，但是如果真觉得学不下去的可以考虑用一些现成的第三方平台，但是肯定不如自己开发来的个性化。一、开发模式简介点击公众平台后台导航的“高级功能”就可以进入，该页面有两个模式选择，分别为“编辑模式”和“开发模式”，如下图：默认两个模式都是关闭状态，两种模式不能同时开启，点击开发模式区域进入开发模式设置页面，如下图：1.模式总开关。只有“成为开发者”后才可以开启，这里要注意的是由于编辑模式和开发模式不能同时开启，使用开发模式前应先关闭编辑模式。2.api接口文档。点击后可以查看目前所有开放的接口使用详细说明，包括开发用的SDK包。（SDK，SoftwareDevelopmentKit的缩写，中文即“软件开发工具包”。广义上指辅助开发某一类软件的相关文档、范例和工具的集合。）3.成为开发者。点击后会出现接口配置页面，用来绑定自己服务器上的程序接口与微信接口通讯，具体的操作将在第九章介绍。二、api接口文档简介首先来了解下微信开发模式有那些接口，清楚微信接口能做什么不能做什么有利于自己的产品设计，可以考虑自己的产品如何结合如何规划。由于微信本身是一个通讯工具，它所有的api接口都是基于一问一答的通讯机制，因此它的接口文档分为消息推送（用户在公众平台上行发送的消息）和消息回复（响应用户上行消息反馈下发回复的消息），本教程除了目前已经公布的接口外，还将剧透一部分将要开放的接口，比较特殊的消息下发接口属于最高级别接口，大部分开发者是拿不到的，所以不介绍了。消息推送（即公众账号能接收到的用户消息请求）1、文本消息此类消息即用户向公众账号输入文本发送消息，是公众平台接收到最多的消息，也是最重要的搜索、互动请求，因为语音识别还不成熟，图片无法识别，地理位置用的场景也不多。接口获取到的消息格式：这里先说下XML数据格式，它不仅是一种非常适合web传输的格式，还具有强大的数据索引、排序、查找、相关一致性等特点，有些网站甚至拿XML来做数据库，比如射手网，它结构非常简单，看起来有点像html，可读性比较强，微信开发接口的消息传递主要在用这个。有些人会觉得很头大，其实不理解也没关系，只要搞清楚它每次传输给你的有那些数据，你怎么获取这些数据就可以了。文本消息的数据字段：ToUserName：开发者微信号（公众账号ID）FromUserName：发送方帐号（微信用户的OPENID，每个微信用户与每个公众账号是唯一的，不同公众账号同个用户OPENID是不同的）CreateTime：消息创建时间MsgType：消息类型（文本消息为text）Content：消息内容MsgId：消息的ID号2、图片消息用户使用图片上传发送消息，应用场景：账号注册、随手拍活动征集、现场微信照片墙。接口获取到的消息格式：图片消息与文本消息数据不同：MsgType：消息类型为imagePicUrl：图片链接，该图片保存在微信的服务器上，可以通过远程抓取图片程序保存到本地。3、地理位置消息微信将LBS当作一个交互信息进行传递，比较常见的微信用户之间发送地理位置告知目的地所在，公众号里发送地理位置搜索周边人、商家、信息等。接口获取到的消息格式：地理位置消息与文本消息数据不同：MsgType：消息类型为locationLocation_X、Location_Y、Scale：地理位置的经纬度和地图缩放比例，用于第三方地图接口的应用，搜索周边需要用到Label：地理位置文字信息，如某某城市某某路某某号，如果以城市为单位查询直接拿这个就可以。4、链接消息微收藏、印象笔记等用来保存微信里图文消息的应用就是使用的这个接口，用户将链接发送到该公众账号，公众账号通过链接抓取网页内容然后收藏保存。接口获取到的消息格式：链接消息与文本消息数据不同：MsgType：消息类型为linkTitle：消息标题Description：消息描述Url：链接地址5、语音消息（未开放）这个消息接口并不在公开文档上，但事实上有不少微信应用已经在使用，比如路况电台，不全面开放的原因我个人猜测是因为微信自己的语音识别还不理想，未来肯定会开放，想象一下对公众账号说句话后台就能给反馈信息多方便的功能。接口获取到的消息格式：语音消息与文本消息数据不同：MsgType：消息类型为voiceMediaId：语音消息媒体id，可以调用相应接口获取内容Format：语音类型，如amr，speex，wav等，目前是使用的speex。6、视频消息（未开放）这个消息接口也不在公开文档上，结构跟语音消息差不多。接口获取到的消息格式：视频消息与文本消息数据不同：MsgType：消息类型为videoMediaId：视频消息媒体id，可以调用相应接口获取内容ThumbMediaId：视频消息缩略图id，可以调用相应接口获取内容7、事件推送这个接口很重要，目前只开放了用户关注、用户退订，还有自定义菜单按钮相应的功能，部分测试的有用户打开公众号提醒和自动发送地理位置。也就是用户不发送任何内容也可以捕捉用户行为做出回复。接口获取到的消息格式：事件推送与文本消息数据不同：MsgType：消息类型为eventEvent：事件内容，subscribe(订阅)、unsubscribe(取消订阅)、CLICK(自定义菜单点击事件)EventKey：当用户事件为点击自定义菜单时，返回事件KEY值，与自定义菜单接口中KEY值对应。很多人在问如何知道用户退订的，其实就是这个消息接口，另外3月26日后将用户关注消息也从文本消息改为了事件推送。消息回复（即公众账号在接收到用户消息后下发回复消息）消息回复需要注意的一点是从接收用户发送的消息，到服务器响应返回消息，有效时间只有5秒钟，超时的话用户是无法接收到回复消息的。1、回复文本消息文字阅读要比其他方式的阅读成本低，所以能用文本的地方咱们就尽量用文本。接口下发的消息格式：回复文本消息的数据字段：ToUserName：发送方帐号（微信用户的OPENID，每个微信用户与每个公众账号是唯一的，不同公众账号同个用户OPENID是不同的）FromUserName：开发者微信号（公众账号ID）CreateTime：回复消息创建时间MsgType：回复消息类型（文本消息为text）Content：回复消息内容（长度不超过2048字节）FuncFlag：设置为1的时候，自动星标刚才接收到的消息，适合活动统计使用2、回复图片消息（未开放）这是个未公开的接口，现在使用开发模式最苦逼的就是没法回复图片，还不如编辑模式，啥都能回复！接口下发的消息格式：与回复文本消息的数据字段的不同：MsgType：回复消息类型为imageMediaId：图片的id，需要通过其他接口上传图片获得上传图片限制：1MB，支持JPG格式3、回复语音消息（未开放）这是个未公开的接口，语音消息展现形式跟音乐消息还是不一样的，也不会出现某些安卓版微信无法播放音乐消息的情况。接口下发的消息格式：与回复文本消息的数据字段的不同：MsgType：回复消息类型为voiceMediaId：语音的id，需要通过其他接口上传语音获得上传语音限制：1MB，播放长度不超过60s，支持AMR格式4、回复视频消息（未开放）这是个未公开的接口，和图片消息差不多。接口下发的消息格式：与回复文本消息的数据字段的不同：MsgType：回复消息类型为videoMediaId：视频的id，需要通过其他接口上传视频获得ThumbMediaId：缩略图的id，通过上传图片（80*80）得到id视频限制：10MB，支持MP4格式缩略图限制：64KB，支持JPG格式5、回复音乐消息很多人问我为什么可以播放音乐，没什么秘密，就是用这个接口了。接口下发的消息格式：与回复文本消息的数据字段的不同：MsgType：回复消息类型为musicTitle：音乐标题，我经常是放歌名Description：音乐描述，我经常是放歌手名字MusicUrl：音乐链接，支持MP3、WMV、AAC等在线音乐格式HQMusicUrl：高质量音乐链接，WIFI环境优先使用该链接播放音乐，可以和上面的一样。6、回复图文消息开发模式里最喜欢的就是这个了，比如可以用多图文消息做个欢迎菜单，可以做图文历史文章查询。接口下发的消息格式：与回复文本消息的数据字段的不同：MsgType：回复消息类型为newsArticleCount：图文消息个数，限制为10条以内，这个必须准确，有多少条图文消息就得填写多少，不然会出错。Articles：多条图文消息信息，默认第一个item为大图，每个item的结构完全一样，每个item表示一条图文消息。Title：图文消息标题Description：图文消息描述PicUrl：图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80。Url：点击图文消息跳转链接，这个链接可以是自己网站链接，但是记得申请白名单，不然出现警告提示用户一般不会点击进去。其他消息接口这些接口都未对外开放，看看就行，如果在写教程中途官方开放了，我也会写进。1、用户信息接口（未开放）公众平台获取关注用户的信息。接口请求地址：接口返回信息：subscribe：用户是否订阅该公众号标识，值为0时，拉取不到其余信息openid：用户的标识，对当前公众号唯一nickname：用户的昵称sex：用户的性别，值等于1时为男性，值等于2时为女性city：用户所在城市language：用户的语言，简体中文为zh_CN2、媒体文件上传接口（未开放）上传图片、语音、视频等文件，获取media_id，media_id可复用。接口请求地址：接口返回信息：type：媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb）media_id：媒体文件上传后获取的唯一标识created_at：媒体文件上传时间3、媒体文件获取接口（未开放）通过media_id获取图片、语音、视频等文件。接口请求地址：、拉取关注接口（未开放）拉取公众账户关注用户列表。接口请求地址：接口返回信息：total：关注该公众账号的总用户数count：拉取的OPENID个数，最大值为10000data：列表数据，OPENID的列表next_openid：下一次拉取的关注用户的偏移值--------------------------------------关于