微信企业号开发之如何接收消息(1)
当前位置:点晴教程→知识管理交流
→『 技术文档交流 』
将应用设置在回调模式时,企业可以通过回调URL接收员工回复的消息,以及员工关注、点击菜单、上报地理位置等事件。 在接收到事件后,企业可以发送被动响应消息,实现员工与企业的互动。 注意,企业在接收消息,以及发送被动响应消息时,消息体都以AES方式加密,以保证传输的安全。具体可参考'建立连接'中的'回调模式'一节。 一、关注与取消关注 员工在关注企业号时,首先要与企业通讯录中的帐号绑定;如果企业开启了二次验证,那么在绑定成功后还需要经过企业的验证,才可以关注成功。 1、员工与通讯录中的帐号绑定 员工关注企业号时,会根据员工的微信号、微信绑定的手机或邮箱,与企业通讯录的帐号匹配。如果匹配到,则绑定成功;否则会提示员工输入手机号或邮箱,验证成功后再与企业通讯录中的帐号匹配。注意,员工的微信版本需要在5.4以上,目前仅支持iOS、Android两个平台。 2、二次验证 企业在开启二次验证时,必须填写企业二次验证页面的url。当员工绑定通讯录中的帐号后,会收到一条图文消息,引导员工到企业的验证页面验证身份,企业在员工验证成功后,调用如下接口即可让员工关注成功。
Http请求方式: GET https://qyapi.weixin.qq.com/cgi-bin/user/authsucc?access_token=ACCESS_TOKEN&userid=USERID
管理员须拥有userid对应员工的管理权限。
3、关注/取消关注事件的推送 员工关注、取消关注企业号的事件,会推送到每个应用在管理端设置的URL;特别的,默认企业小助手可以用于获取整个企业号的关注状况。(以下假设该URL为http://api.3dept.com)。
Http请求方式: POST http://api.3dept.com/?signature=ASDFQWEXZCVAQFASDFASDFSS×tamp=13500001234&nonce=123412323
二、接收普通消息 普通消息是指员工向企业号应用发送的消息,包括文本、图片、语音、视频、地理位置等类型。
三、接收事件 事件是指员工在企业号上的某些操作行为,比如关注、上报地理位置、点击菜单等。(关注事件请参考’关注与取消关注’) 1、菜单事件推送 员工点击自定义菜单后,微信会把点击事件推送给企业。请注意,点击菜单弹出子菜单,不会产生上报。
2、上报地理位置事件 员工同意上报地理位置后,每次在进入应用会话时都会上报一次地理位置,或在进入应用会话后每5秒上报一次地理位置。企业可以在管理端修改应用的以上 设置。上报地理位置时,微信会将此事件推送到企业应用在管理端设置的URL(以下假设该URL为http://api.3dept.com)。
Http请求方式: POST http://api.3dept.com/?signature=ASDFQWEXZCVAQFASDFASDFSS×tamp=13500001234&nonce=123412323
四、被动响应消息 企业响应的消息同样应该经过加密,并带上msg_signature、timestamp、nonce及密文,以下是标准的回包:
以下是各类型消息的明文XML结构:
该文章在 2014/12/2 0:45:08 编辑过 |
关键字查询
相关文章
正在查询... |