微信公号普通事件转化规则
OAC转化微信公号普通事件消息的规则#
微信公号文档:普通事件
通用属性转化详情#
原始XML:#
说明:原始XML里,一般情况下都有几个通用属性ToUserName,FromUserName,CreateTime,MsgId。OA Connector会自动把这些属性进行转化。#
- ToUserName不需要转化
- FromUserName转化为$auths['wechat_openid']
- CreateTime转化为$event['$event_timestamp']
- MsgId转化为$event['$event_uniqueid']
1. 文本消息#
原始XML:#
事件说明:#
OA Connector把此XML转化为事件$oa_message_received
属性说明:#
- MsgType转化为属性$wechat_message_type,值是[text]
- Content转化为属性$wechat_message_content,值是[Content]
- bizmsgmenuid转化为属性$wechat_bizmsgmenuid,值是[bizmsgmenuid]
2. 图片消息#
原始XML:#
事件说明:#
OA Connector把此XML转化为事件$oa_message_received
属性说明:#
- MsgType转化为属性$wechat_message_type,值是[image]
- PicUrl转化为属性$wechat_image_url,值是[PicUrl]
- MediaId转化为属性$wechat_image_media_id,值是[media_id]
3. 语音消息#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_message_received
属性说明:#
- MsgType转化为属性$wechat_message_type,值是[voice]
- MediaId转化为属性$wechat_voice_media_id,值是[media_id]
- Format转化为属性$wechat_voice_format,值是[Format]
- Recognition转化为属性$wechat_voice_recognition,值是[语音识别结果]
4. 视频消息#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_message_received
属性说明:#
- MsgType转化为属性$wechat_message_type,值是[video]
- MediaId转化为属性$wechat_video_media_id,值是[media_id]
- ThumbMediaId转化为属性$wechat_video_thumbnail_id,值是[thumb_media_id]
5. 小视频消息#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_message_received
属性说明:#
- MsgType转化为属性$wechat_message_type,值是[shortvideo]
- MediaId转化为属性$wechat_shortvideo_media_id,值是[media_id]
- ThumbMediaId转化为属性$wechat_shortvideo_thumbnail_id,值是[thumb_media_id]
6. 链接消息#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_message_received
属性说明:#
- MsgType转化为属性$wechat_message_type,值是[link]
- Title转化为属性$wechat_link_title,值是[公众平台官网标题]
- Description转化为属性$wechat_link_description,值是[公众平台官网描述]
- Url转化为属性$wechat_link_url, 值是[url]
7. 地理位置消息(主动上传)#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_location_uploaded
属性说明:#
- 添加一个属性$wechat_location_type, 值固定是manual
- Location_X转化为属性$latitude,值是[23.134521]
- Location_Y转化为属性$longitude,值是[113.358803]
- Scale转化为属性$wechat_location_scale,值是[20]
- Label转化为属性$wechat_location_label, 值是[位置信息]
8. 上报地理位置事件(自动上传)#
用户同意上报地理位置后,每次进入公众号会话时,都会在进入时上报地理位置,或在进入会话后每5秒上报一次地理位置,公众号可以在公众平台网站中修改以上设置。上报地理位置时,微信会将上报地理位置事件推送到开发者填写的URL。
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_location_uploaded
属性说明:#
- 添加一个属性$wechat_location_type, 值固定是auto
- Latitude转化为属性$latitude,值是[23.134521]
- Longitude转化为属性$longitude,值是[113.358803]
- Precision转化为属性$wechat_location_precision,值是[119.385040]
9. 用户关注公号事件#
原始XML:#
事件说明:#
OA Connector把此XML转化为事件$oa_followed
属性说明:#
- 添加一个属性$wechat_follow_source,值是[subscribe_scene]
subscribe_scene说明:#
- OA Connector需要通过 获取用户基本信息API,得到subscribe_scene。
subscribe_scene是用户关注的渠道来源,值如下:#
- ADD_SCENE_SEARCH 公众号搜索,
- ADD_SCENE_ACCOUNT_MIGRATION 公众号迁移,
- ADD_SCENE_PROFILE_CARD 名片分享,
- ADD_SCENE_QR_CODE 扫描二维码,
- ADD_SCENE_PROFILE_LINK 图文页内名称点击,
- ADD_SCENE_PROFILE_ITEM 图文页右上角菜单,
- ADD_SCENE_PAID 支付后关注,
- ADD_SCENE_WECHAT_ADVERTISEMENT 微信广告,
- ADD_SCENE_OTHERS 其他
10. 取消关注公号事件#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_unfollowed
属性说明:#
- 本事件不需要自定义属性
11. 扫描带参数二维码事件:扫码后关注#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_followed
属性说明:#
- 添加一个属性$wechat_follow_source,值固定是ADD_SCENE_QR_CODE
- EventKey转化为属性$wechat_qrcode_scene,值是[SCENE_VALUE]
- Ticket转化为属性$wechat_qrcode_ticket,值是[TICKET]
12. 扫描带参数二维码事件,关注后扫码#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_qrcode_scanned
属性说明:#
- EventKey转化为属性$wechat_qrcode_scene,值是[SCENE_VALUE]
- Ticket转化为属性$wechat_qrcode_ticket,值是[TICKET]
13. 自定义菜单事件:CLICK#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- Event转化为属性$wechat_menu_type,值是[CLICK]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
14. 点击菜单跳转链接时的事件推送:VIEW#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- Event转化为属性$wechat_menu_type,值是[VIEW]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
- MenuId转化为属性$wechat_menu_id, 值是[MenuId]
15.scancode_push:扫码推事件的事件推送#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
- Event转化为属性$wechat_menu_type,值是[scancode_push]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- ScanType转化为属性$wechat_menu_scantype,值是[qrcode]
- ScanResult转化属性$wechat_menu_scanresult,值是[ScanResult]
16. scancode_waitmsg:扫码推事件且弹出“消息接收中”提示框的事件推送#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
- Event转化为属性$wechat_menu_type,值是[scancode_waitmsg]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- ScanType转化为属性$wechat_menu_scantype,值是[qrcode]
- ScanResult转化属性$wechat_menu_scanresult,值是[ScanResult]
17. pic_sysphoto:弹出系统拍照发图的事件推送#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
- Event转化为属性$wechat_menu_type,值是[pic_sysphoto]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- Count转化为属性$wechat_menu_pic_count,值是[Count]
- PicList转化为属性$wechat_menu_photos, 值是[PicList]
18. pic_photo_or_album:弹出拍照或者相册发图的事件推送#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
- Event转化为属性$wechat_menu_type,值是[pic_photo_or_album]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- Count转化为属性$wechat_menu_pic_count,值是[Count]
- PicList转化为属性$wechat_menu_photos, 值是[PicList]
19. pic_weixin:弹出微信相册发图器的事件推送#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
- Event转化为属性$wechat_menu_type,值是[pic_weixin]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- Count转化为属性$wechat_menu_pic_count,值是[Count]
- PicList转化为属性$wechat_menu_photos, 值是[PicList]
20. location_select:弹出地理位置选择器的事件推送#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
- Event转化为属性$wechat_menu_type,值是[location_select]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- Location_X转化为属性$latitude,值是[23]
- Location_Y转化为属性$longitude,值是[113]
- Scale转化属性$wechat_location_scale,值是[Scale]
- Label转化为属性$wechat_location_label,值是[Label]
- Poiname转化为属性$wechat_location_poiname, 值是[Poiname]
21. 点击菜单跳转小程序的事件推送#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_clicked
属性说明:#
- 添加一个属性$wechat_menu_name,值是[微信菜单名称]
- 添加一个属性$wechat_parent_menu_name,值是[微信菜单的父菜单名称],当它没有父菜单,它自己是自己的父菜单
- 添加一个属性$menu_level,值是[一级菜单|二级菜单]
- 添加一个属性$wechat_menu_hashcode,值是整个菜单json的正文做哈希
- Event转化为属性$wechat_menu_type,值是[view_miniprogram]
- EventKey转化为属性$wechat_menu_key,值是[EVENTKEY]
- MenuId转化为属性$wechat_menu_id, 值是[MenuId]
22. 模板消息发送状态的事件推送#
原始XML:#
事件说明:#
- OA Connector把此XML转化为事件$oa_template_msg_received
- 当Event等于TEMPLATESENDJOBFINISH的时候才产生该事件
属性说明:#
- Status转化为属性$wechat_template_msg_status,值是[Status]