框架简介
更新日志
准备工作
安装使用
基础支持
接收消息
发送消息
用户管理
自定义菜单
实例演示
多客服功能
智能接口
推广支持
安全性
序
快速开始
接口
链接
定时器
协议
测试
建议
更新日志
2014-11-05:1.4版本发布
这次的版本有大量的新增。
兼容性:
设置菜单Menu::setMenu($menuList)参数结构和返回值重写,不向下兼容。
根目录下新增lanewechat.php:
在项目用需要使用本SDK的地方,只需要include 'lanewechat/lanewechat.php',然后可以直接ClassName::method()调用即可。
安全性升级:
因为SSL爆出高危漏洞,公众平台在2014.11.30起,将关闭SSLv2,SSLv3版本的支持。根据官方实例,LaneWeChat的CURL类中也将使用curl_setopt($curl, CURLOPT_SSLVERSION, 1)
新增语音消息识别
新增高级群发接口:
1 上传图文消息素材
2 根据分组进行群发,可发送图文消息,文本消息,图片消息,语音消息,视频消息。
3 根据OpenID列表群发,,可发送图文消息,文本消息,图片消息,语音消息,视频消息。
4 删除群发
5 事件推送群发结果
新增模板消息接口:
1、主动推送给用户模板消息的接口
2、被动接收微信服务器发送的关于主动推送模板消息的结果通知。
用户管理接口:
1、新增设置备注名。开发者可以通过该接口对指定用户设置备注名,该接口暂时开放给微信认证的服务号。
网页授权接口:
注意:此access_token与基础支持的access_token不同。
1、新增刷新access_token。由于access_token拥有较短的有效期,当access_token超时后,可以使用refresh_token进行刷新,refresh_token拥有较长的有效期(7天、30天、60天、90天),当refresh_token失效的后,需要用户重新授权。
2、新增scope为snsapi_userinfo的模式下(会在网页弹出一个授权框),拉取用户信息的接口。
3、新增检验授权凭证(access_token)是否有效接口
新增多客服功能:
1、新增将消息转发到多客服接口:在接收到用户发送的消息时,调用ResponsePassive::forwardToCustomService($fromusername, $tousername),微信服务器在收到这条消息时,会把这次发送的消息转到多客服系统。用户被客服接入以后,客服关闭会话以前,处于会话过程中,用户发送的消息均会被直接转发至客服系统。
2、新增获取客服聊天记录接口:在需要时,开发者可以通过获取客服聊天记录接口,获取多客服的会话记录,包括客服和用户会话的所有消息记录和会话的创建、关闭等操作记录。利用此接口可以开发如“消息记录”、“工作监控”、“客服绩效考核”等功能。
自定义菜单:
警告:设置菜单Menu::setMenu($menuList)参数结构和返回值重写,自1.4版本起不向下兼容。
注意:所有新增的菜单类型,仅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用户,旧版本微信用户点击后将没有回应,开发者也不能正常接收到事件推送。
1、新增“scancode_push:扫码推事件”类型菜单
用户点击按钮后,微信客户端将调起扫一扫工具,完成扫码操作后显示扫描结果(如果是URL,将进入URL),且会将扫码的结果传给开发者,开发者可以下发消息。
2、新增“scancode_waitmsg:扫码推事件且弹出‘消息接收中’提示框”类型菜单
用户点击按钮后,微信客户端将调起扫一扫工具,完成扫码操作后,将扫码的结果传给开发者,同时收起扫一扫工具,然后弹出“消息接收中”提示框,随后可能会收到开发者下发的消息。
3、新增“pic_sysphoto:弹出系统拍照发图”类型菜单
用户点击按钮后,微信客户端将调起系统相机,完成拍照操作后,会将拍摄的相片发送给开发者,并推送事件给开发者,同时收起系统相机,随后可能会收到开发者下发的消息。
4、新增“pic_photo_or_album:弹出拍照或者相册发图”类型菜单
用户点击按钮后,微信客户端将弹出选择器供用户选择“拍照”或者“从手机相册选择”。用户选择后即走其他两种流程。
5、新增“pic_weixin:弹出微信相册发图器”类型菜单
用户点击按钮后,微信客户端将调起微信相册,完成选择操作后,将选择的相片发送给开发者的服务器,并推送事件给开发者,同时收起相册,随后可能会收到开发者下发的消息。
6、新增“location_select:弹出地理位置选择器”类型菜单
用户点击按钮后,微信客户端将调起地理位置选择工具,完成选择操作后,将选择的地理位置发送给开发者的服务器,同时收起位置选择工具,随后可能会收到开发者下发的消息。
7、新增了以上6种菜单类型、view(点击跳转链接)的菜单类型的被动响应的支持。默认讲点击菜单的事件推送数据发送文本消息返回给用户。开发者请自行修改。
新增语义理解接口
1、如输入“查一下明天从北京到上海的南航机票”,类型为“flight,hotel”,则返回机票信息。
新增推广支持:
1、新增获取二维码接口。二维码分临时二维码和永久二维码。第一步先获取ticket,第二部是拿ticket获取二维码图片。二维码可以保存为文件,也可以展示预览。
2、新增长链接转短链接接口。
新增实例示范:
1、被动响应用户 - 发送图文消息
2、群发图文消息
关于获取用户信息的新亮点 - unionId:
获取用户信息是根据openId获取,同一个微信用户对于不同的公众号,是不同的openId。那问题就来了,如果你有多个公众号,想要共享一份用户数据,可是同一个用户在不同的公众号是不同的openId,我们无法判断是否是同一个用户,现在微信引入了UnionId的概念。
如果开发者有在多个公众号,或在公众号、移动应用之间统一用户帐号的需求,需要前往微信开放平台(open.weixin.qq.com)绑定公众号后,才可利用UnionID机制来满足上述需求。
在绑定了公众号后,我们根据openId获取用户信息的时候,会新增一个字段“unionid”,只要是同一个用户,在不同的公众号用不同的openId获取用户信息的时候unionid是相同的。
此功能不需要新增/修改代码,只需要在微信开放平台绑定公众号就可以了。仍旧使用获取用户信息接口UserManage::getUserInfo($openId);