菜单

企业微信预置用户属性和预置事件

预置用户属性


属性英文变量名属性显示名属性值类型是否使用维度字段是否默认展示属性值示例或说明备注
外部联系人相关属性
$mp_unionid公众号/小程序用户 unionid字符串FALSETRUE示例值:ozynqsulJFCZ2z1aYeS8h-nuasdAAA关于返回的unionid,如果是第三方应用调用该接口,则返回的unionid是该第三方服务商所关联的微信开发者帐号下的unionid。
也就是说,同一个企业客户,企业自己调用,与第三方服务商调用,所返回的unionid不同;不同的服务商调用,所返回的unionid也不同
$wecom_{corpid}_external_user_id{企业简称} 企业微信外部联系人 ID字符串FALSETRUE示例值:
woAJ2GCAAAXtWyujaWJHDDGi0mACHAAA

$wecom_{corpid}_external_user_name{企业简称} 企业微信外部联系人用户名字符串FALSETRUE示例值:李四
$wecom_{corpid}_external_user_follow_corp_name{企业简称} 企业微信外部联系人跟进公司名称字符串FALSETRUE

$wecom_{corpid}_external_user_avatar_url{企业简称} 企业微信外部联系人头像地址字符串FALSETRUE示例值:
http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0
第三方不可获取
$wecom_{corpid}_external_user_gender{企业简称} 企业微信外部联系人性别数值TRUETRUE示例值:0
外部联系人性别 0-未知 1-男性 2-女性
维度字典
$wecom_{corpid}_external_user_group_ids

{企业简称} 企业微信外部联系人所在群聊 ID


listfalsetrue["0001","0002"]

触发事件

$WeComExternalExitChat

$WeComExternalJoinChat

$WeComGroupCreate

$WeComGroupDisband

$wecom_{corpid}_external_user_group_names{企业简称} 企业微信外部联系人所在群聊名称listfalsetrue["销售客服群1","销售客服群2"]

触发事件

$WeComExternalExitChat

$WeComExternalJoinChat

$WeComGroupCreate

$WeComGroupDisband

$WeComGroupNameChange

$wecom_{corpid}_external_user_type{企业简称} 企业微信外部联系人类型数值TRUETRUE示例值:1
1表示该外部联系人是微信用户,2表示该外部联系人是企业微信用户
维度字典:1-微信用户,2-企业微信用户
$wecom_{corpid}_external_user_title{企业简称} 企业微信外部联系人职位字符串FALSETRUE示例值:Manager企业微信外部联系人的职位,如果外部企业或用户选择隐藏职位,则不返回,
仅当企业微信联系人类型是企业微信用户时有此字段
$wecom_{corpid}_external_user_corp_name{企业简称} 企业微信外部联系人所在企业简称字符串FALSETRUE示例值:腾讯仅当企业微信联系人类型是企业微信用户时有此字段
$wecom_{corpid}_external_user_corp_full_name{企业简称} 企业微信外部联系人所在企业主体名称字符串FALSETRUE示例值:
腾讯科技有限公司
仅当企业微信联系人类型是企业微信用户时有此字段
$wecom_{corpid}_external_user_follow_user_ids{企业简称} 企业微信外部联系人添加员工 IDlistFALSETRUE

触发事件:

$WeComExternalAddMember
$WeComMemberDelExternal

$wecom_{corpid}_external_user_follow_earliest_user_id

{企业简称} 企业微信外部联系人最早添加员工 ID


字符串FALSETRUE

触发事件:

$WeComExternalAddMember
$WeComMemberDelExternal

$wecom_{corpid}_external_user_follow_latest_user_id

{企业简称} 企业微信外部联系人最新添加员工 ID

字符串FALSETRUE

触发事件:

$WeComExternalAddMember
$WeComMemberDelExternal

$wecom_{corpid}_external_user_follow_first_time

{企业简称} 企业微信外部联系人首次添加员工时间

datetimeFALSETRUE

该属性只取外部联系人添加的第一个员工的时间,之后即使删除第一个员工,该时间不变。

触发事件:$WeComExternalAddMember

$wecom_{corpid}_external_user_follow_user_main_dept_ids

{企业简称} 企业微信外部联系人添加员工所属主部门ID

listFALSETRUE

触发事件:

$WeComExternalAddMember
$WeComMemberDelExternal

$wecom_{corpid}_external_user_follow_user_main_dept_name

{企业简称} 企业微信外部联系人添加员工所属主部门名称

listFALSETRUE

触发事件:

$WeComExternalAddMember
$WeComMemberDelExternal

$wecom_{corpid}_external_user_remarks{企业简称} 企业微信外部联系人备注listFALSETRUE

去重

触发事件:$WeComMemberEditExternal

$wecom_{corpid}_external_user_tags{企业简称} 企业微信外部联系人标签名称listFALSETRUE

去重;包括企业标签和员工个人标签

触发事件:$WeComMemberEditExternal

$wecom_{corpid}_external_user_tag_ids

{企业简称} 企业微信外部联系人标签ID

listFALSETRUE

["etJZyJDQAAPoRmAzVXS-FS7HD_gahyNQ","etJZyJDQAA-ZF7MTSVZ6zX0KN8QSXrFQ"]

触发事件:$WeComMemberEditExternal
$wecom_{corpid}_external_user_remark_mobiles{企业简称} 企业微信外部联系人备注手机号listFALSETRUE

触发事件:$WeComMemberEditExternal

$wecom_{corpid}_external_user_remark_corps{企业简称} 企业微信外部联系人备注所属企业listFALSETRUE

触发事件:$WeComMemberEditExternal

$wecom_{corpid}_external_user_add_ways{企业简称} 企业微信外部联系人添加方式listFALSETRUE0-未知来源,1-扫描二维码,2-搜索手机号,3-名片分享,4-群聊,5-手机通讯录,6-微信联系人,7-来自微信的添加好友申请,8-安转第三方应用时自动添加的客服人员,9-搜索邮箱,201 内部成员共享,202-管理员/负责人分配

触发事件:

$WeComExternalAddMember

$wecom_{corpid}_external_user_latest_update_time

{企业简称} 企业微信外部联系人最近更新时间

datetimefalsetrue
任何涉及外部联系人属性更新时即更新该属性
员工相关属性
$wecom_{corpid}_member_id{企业简称} 企业微信员工 ID字符串FALSETRUE示例值:tommy
$wecom_{corpid}_member_name{企业简称} 企业微信员工用户名字符串FALSETRUE示例值:张三三方不可获取,调用时返回userid以代替name;
对于非第三方创建的成员,第三方通讯录应用也不可获取;
第三方页面需要通过通讯录展示组件来展示名字
$wecom_{corpid}_member_mobile{企业简称} 企业微信员工手机号码字符串FALSETRUE示例值:13800000000第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_dept_ids{企业简称} 企业微信员工所属部门 ID 列表listFALSETRUE示例值:[3, 9, 12]
$wecom_{corpid}_member_title{企业简称} 企业微信员工职务字符串FALSETRUE示例值:后台工程师第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_gender{企业简称} 企业微信员工性别数值TRUETRUE示例值:0
0表示未定义,1表示男性,2表示女性
维度字典:0-未定义,1-男性,2-女性
$wecom_{corpid}_member_email{企业简称} 企业微信员工邮箱字符串FALSETRUE示例值:zhangsan@gzdev.com第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_is_leader_in_dept{企业简称} 企业微信员工是否为上级BOOLTRUETRUE示例值: 0-否;1-是维度字典;第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_avatar_url{企业简称} 企业微信员工头像地址字符串FALSETRUE示例值:
http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0
第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_avatar_thumb_url{企业简称} 企业微信员工头像缩略图地址字符串FALSETRUE示例值:
http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/100
第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_telephone{企业简称} 企业微信员工座机字符串FALSETRUE示例值:020-123456第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_alias{企业简称} 企业微信员工别名字符串FALSETRUE示例值:jackzhang第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_activation_status{企业简称} 企业微信员工激活状态数值TRUETRUE示例值:1

维度字典:
1-已激活,2-已禁用,4-未激活,5-退出企业。
已激活代表已激活企业微信或已关注微工作台(原企业号)。未激活代表既未激活企业微信又未关注微工作台(原企业号)

触发事件:


$wecom_{corpid}_member_qr_code_url{企业简称} 企业微信员工二维码地址字符串FALSETRUE示例值:https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=xxx第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_external_title{企业简称} 企业微信员工对外职务字符串FALSETRUE示例值:产品经理如果设置了该值,则以此作为对外展示的职务,否则以position来展示
第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_address{企业简称} 企业微信员工地址字符串FALSETRUE示例值:广州市海珠区新港中路第三方仅通讯录应用可获取;对于非第三方创建的成员,第三方通讯录应用也不可获取
$wecom_{corpid}_member_main_dept{企业简称} 企业微信员工主部门数值FALSETRUE示例值:1
$wecom_{corpid}_member_group_ids

{企业简称} 企业微信员工所在群聊 ID

listfalsetrue

触发事件:

$WeComGroupCreate
$WeComGroupDisband
$WeComMemberJoinChat
$WeComMemberExitChat

$wecom_{corpid}_member_group_names

{企业简称} 企业微信员工所在群聊名称

listfalsetrue

触发事件:

$WeComGroupCreate
$WeComGroupDisband
$WeComMemberJoinChat
$WeComMemberExitChat

$WeComGroupNameChange

$wecom_{corpid}_member_latest_update_time

{企业简称} 企业微信员工最近更新时间

datetimefalsetrue

「客户群聊」相关属性
$wecom_{corpid}_group_id{企业简称} 企业微信群 ID字符串falsetrue
$WeComGroupCreate

$wecom_{corpid}_group_name{企业简称} 企业微信群名称字符串falsetrue
$WeComGroupCreate
$WeComGroupNameChange
$wecom_{corpid}_group_create_time{企业简称} 企业微信群创建时间datetimefalsetrue
$WeComGroupCreate
$wecom_{corpid}_group_disband_time{企业简称} 企业微信群解散时间datetimefalsetrue
$WeComGroupDisband

$wecom_{corpid}_group_latest_update_time{企业简称} 企业微信群最近更新时间datetimefalsetrue
所有涉及更新属性的都会更新此字段
$wecom_{corpid}_group_owner_id{企业简称} 企业微信群主 ID字符串falsetrue
$WeComGroupCreate
$WeComGroupOwnerChange

$wecom_{corpid}_group_manager_ids{企业简称} 企业微信群管理员 IDlistfalsetrue

$wecom_{corpid}_group_member_ids{企业简称} 企业微信群成员 IDlistfalsetrue

$WeComGroupCreate
$WeComGroupDisband

$WeComMemberJoinChat
$WeComMemberExitChat

$WeComExternalExitChat

$WeComExternalJoinChat

$user_subject_type用户主体类型字符串truefalse

该属性用来标识用户表内某条数据的用户类型:

1 - 员工,2-外部联系人,3 - 企微群聊




预置事件


序号事件英文变量名事件显示名属性英文变量名事件属性显示名类型是否使用维度字典是否默认展示属性值示例或说明埋点形式触达时机备注
1$WeComMemberHalfAddExternal企业微信员工免验证添加外部联系人
(客户联系回调事件)
$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点



当企业中配置了客户联系功能的员工被外部联系人添加时,微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件

只有在员工配置了客户联系功能,开启免验证并且是‘加我为联系人时,不自动添加对方到通讯录’才会触发这个回调

$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE
$wecom_corp_id企业微信 CorpID字符串FALSETRUE
2$WeComExternalAddMember






企业微信外部联系人添加员工
(
客户联系回调事件)






$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点



当员工添加外部联系人时,
企业微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件




不管是谁主动添加谁都是此事件。

$is_first_time、$is_external_existed_in_users 、$wecom_liveqrcode_name、$wecom_liveqrcode_configid这几个是通过员工活码添加的会有活码的属性。




$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE
$wecom_corp_id企业微信 CorpID字符串FALSETRUE
$wecom_external_user_add_way企业微信外部联系人添加方式字符串TRUETRUE0-未知来源,1-扫描二维码,2-搜索手机号,3-名片分享,4-群聊,5-手机通讯录,6-微信联系人,7-来自微信的添加好友申请,8-安转第三方应用时自动添加的客服人员,9-搜索邮箱,201 内部成员共享,202-管理员/负责人分配
$wecom_liveqrcode_name企业微信活码名称字符串FALSETRUE
$wecom_liveqrcode_configid企业微信活码configID字符串FALSETRUE
$is_first_time是否首次触发事件布尔型FALSETRUE
$is_external_existed_in_users  外部联系人是否已在用户表布尔型FALSEFALSE
3$WeComMemberDelExternal企业微信员工删除外部联系人
(
客户联系回调事件)
$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点当员工删除外部联系人时,
企业微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件



$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE
$wecom_corp_id企业微信 CorpID字符串FALSETRUE
4$WeComMemberEditExternal企业微信员工编辑外部联系人
(
客户联系回调事件)
$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点当员工编辑外部联系人信息时,
企业微信服务器将POST消息的XML数据包到开发者填写的URL上,
后端通过客户id去查询客户详情,对比判断内部员工编辑客户的变更内容上报事件。








$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE
$wecom_corp_id企业微信 CorpID字符串FALSETRUE
$wecom_external_remark企业微信外部联系人的备注信息字符串FALSETRUE
$wecom_external_description企业微信外部联系人的描述信息字符串FALSETRUE
$wecom_external_tags企业微信外部联系人的标签列表listFALSETRUE
$wecom_external_mobiles企业微信外部联系人的备注电话号码listFALSETRUE
$wecom_external_corp_remark企业微信外部联系人的企业名称备注字符串FALSETRUE
5$WeComExternalDelMember企业微信外部联系人删除员工
(
客户联系回调事件)
$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点当企业中配置了客户联系功能的员工被外部联系人删除时,
微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件




$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE
$wecom_corp_id企业微信 CorpID字符串FALSETRUE
6$WeComExternalJoinChat








企业微信外部联系人加入群聊
(
客户联系回调事件)








$wecom_corp_id企业微信 CorpID字符串FALSETRUE
神策服务器端埋点








外部联系人加入/退出客户群时,微信服务器将POST消息的XML数据包到开发者填写的URL上,
后端根据外部群id查询群成员列表,对比来判断外部联系人加入/退出群聊上报事件。

















$wecom_group_id企业微信群 ID字符串FALSETRUE
$wecom_group_name企业微信群名称字符串FALSETRUE
$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE
$wecom_group_invitor_member_id企业微信群邀请者员工 ID字符串FALSETRUE
$wecom_group_owner_id企业微信群主 ID字符串FALSETRUE
$wecom_group_create_time企业微信群创建时间DATETIMEFALSETRUE
$wecom_group_join_time企业微信入群时间DATETIMEFALSETRUE
$wecom_group_join_scene企业微信入群方式数值TRUETRUE1-直接邀请入群
2-通过邀请链接入群
3-通过扫描群二维码入群
7$WeComExternalExitChat









企业微信外部联系人退出群聊
(
客户联系回调事件)









$wecom_corp_id企业微信 CorpID字符串FALSETRUE
神策服务器端埋点









企业微信外部联系人退出群聊触发





















$wecom_group_id企业微信群 ID字符串FALSETRUE
$wecom_group_name企业微信群名称字符串FALSETRUE
$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE
$wecom_group_owner_id企业微信群主 ID字符串FALSETRUE
$wecom_group_create_time企业微信群创建时间DATETIMEFALSETRUE
$wecom_group_join_time企业微信入群时间DATETIMEFALSETRUE
$wecom_group_duration企业微信在群时长数值FALSETRUE
$wecom_group_join_scene企业微信入群方式数值TRUETRUE1-直接邀请入群
2-通过邀请链接入群
3-通过扫描群二维码入群
$wecom_group_quit_scene企业微信退群方式数值TRUETRUE0 - 自己退群
1 - 群主/群管理员移出
8$WeComGroupNoticeChange

企业微信群公告变更(客户联系回调事件)


$wecom_group_id企业微信群 ID字符串falsetrue

更改企业微信群公告时触发
$wecom_group_name企业微信群名称字符串falsetrue


9$WeComGroupOwnerChange

企业微信群主变更(客户联系回调事件)


$wecom_group_id企业微信群 ID字符串falsetrue

变更企业微信群主时触发
$wecom_group_name企业微信群名称字符串falsetrue


10$WeComGroupNameChange

企业微信群名称变更(客户联系回调事件)


$wecom_group_id企业微信群 ID字符串falsetrue

修改企业微信群名称时触发
$wecom_group_name企业微信群名称字符串falsetrue


11

$WeComGroupCreate




企业微信群创建(客户联系回调事件)

$wecom_group_id企业微信群 ID字符串falsetrue
神策服务器端埋点

创建企业微信群的时候触发
$wecom_group_name企业微信群名称字符串falsetrue

$wecom_group_create_time企业微信群创建时间DATETIMEfalsetrue

12$WeComGroupDisband


企业微信群解散(客户联系回调事件)


$wecom_group_id企业微信群 ID字符串falsetrue
神策服务器端埋点


企业微信群解散的时候触发
$wecom_group_name企业微信群名称字符串falsetrue

$wecom_group_create_time企业微信群创建时间datetimefalsetrue

$wecom_group_disband_time企业微信群解散时间datetimefalsetrue

13$WeComMemberJoinChat

企业微信员工加入群聊(客户联系回调事件)

$wecom_member_id企业微信员工 ID字符串falsefalse
神策服务器端埋点员工加入群聊的时候触发
$wecom_corp_id企业微信 CorpID字符串falsetrue

$wecom_group_id企业微信群 ID字符串falsetrue

$wecom_group_name企业微信群名称字符串falsetrue

$wecom_group_invitor_member_id

企业微信群邀请者员工 ID字符串falsetrue

$wecom_group_owner_id企业微信群主 ID字符串falsetrue

$wecom_group_create_time企业微信群创建时间DATETIMEfalsetrue

$wecom_group_join_time企业微信入群时间DATETIMEfalsetrue

$wecom_group_join_scene企业微信入群方式数值truetrue1-直接邀请入群
2-通过邀请链接入群
3-通过扫描群二维码入群

14$WeComMemberExitChat

企业微信员工退出群聊(客户联系回调事件)


$wecom_member_id企业微信员工 ID字符串falsefalse
神策服务器端埋点员工退出群聊的时候触发
$wecom_corp_id企业微信 CorpID字符串falsetrue

$wecom_group_id企业微信群 ID字符串falsetrue

$wecom_group_name企业微信群名称字符串falsetrue

$wecom_group_owner_id企业微信群主 ID字符串falsetrue

$wecom_group_create_time企业微信群创建时间DATETIMEfalsetrue

$wecom_group_join_time企业微信入群时间DATETIMEfalsetrue

$wecom_group_duration企业微信在群时长数值falsetrue退群时间 - 入群时间 单位为秒
$wecom_group_join_scene企业微信入群方式数值truetrue1-直接邀请入群
2-通过邀请链接入群
3-通过扫描群二维码入群

$wecom_group_quit_scene企业微信退群方式数值truetrue0 - 自己退群
1 - 群主/群管理员移出

15$WeComMemberAdd

企业微信员工新增(通讯录回调事件)


$wecom_member_id企业微信员工 ID字符串falsefalse
神策服务器端埋点当企业员工点击接收加入企业的时候触发
$wecom_corp_id企业微信 CorpID字符串falsetrue

16$WeComMemberUpdate

企业微信员工更新(通讯录回调事件)


$wecom_member_id企业微信员工 ID字符串falsefalse
神策服务器端埋点当员工名称、部门、id变更时会触发事件
$wecom_corp_id企业微信 CorpID字符串falsetrue

17$WeComMemberActivationStatusChange

企业微信员工激活状态变更(通讯录回调事件)


$wecom_member_id企业微信员工 ID字符串falsefalse
神策服务器端埋点


员工激活状态发生变化时触发




$wecom_member_activation_status_old企业微信员工激活状态_旧数值truetrue

$wecom_member_activation_status_new企业微信员工激活状态_新数值truetrue

$wecom_corp_id企业微信 CorpID字符串falsetrue

18$WeComMemberDelete

企业微信员工删除(通讯录回调事件)


$wecom_member_id企业微信员工 ID字符串falsefalse
神策服务器端埋点当员工退出企业或者被删除的时候触发该事件
$wecom_corp_id企业微信 CorpID字符串falsetrue

19$WeComMemberEnterApp企业微信员工进入内部应用
(自建应用回调事件)
$wecom_app_id企业微信应用 ID字符串FALSETRUE
神策服务器端埋点本事件在成员进入企业微信的内部应用时,
微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件
企业微信员工从工作台或者聊天工具栏等地方进入自建应用就算


$wecom_app_name企业微信应用名称字符串FALSETRUE
$wecom_member_id企业微信员工 ID字符串FALSETRUE
$wecom_corp_id企业微信 CorpID字符串FALSETRUE
20$WeComMemberReportLocationInApp





企业微信员工在内部应用中上报地理位置
(自建应用回调事件)





$wecom_app_id企业微信应用 ID字符串FALSETRUE
神策服务器端埋点





本事件在成员进入企业微信的内部应用发送地理位置时,微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件





当设置了应用主页之后,此应用的事件不会触发。

进入内部应用时,如果勾选了上报地理位置,会上报此事件。







$wecom_app_name企业微信应用名称字符串FALSETRUE
$wecom_member_id企业微信员工 ID字符串FALSETRUE
$wecom_corp_id企业微信 CorpID字符串FALSETRUE
$latitude纬度数值FALSETRUE
$longitude经度数值FALSETRUE
$location_precision地理位置精度数值FALSEFALSE
21$WeComMemberClickTaskcard企业微信员工点击任务卡片
(自建应用回调事件)
$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点当员工点击企业内部应用推送的任务卡片时,企业微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件
任务卡片需要通过企业内部应用使用api推送

$wecom_corp_id企业微信 CorpID字符串FALSETRUE
$wecom_taskcard_key企业微信任务卡片 KEY 值字符串FALSETRUE
$wecom_app_id企业微信应用 ID字符串FALSETRUE
$wecom_app_name企业微信应用名称字符串FALSETRUE
$wecom_taskcard_id企业微信任务卡片 ID字符串FALSETRUE
22$WeComMemberSubscribeApp企业微信员工关注内部应用
(自建应用回调事件)
$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点当员工已经加入企业,管理员添加员工到企业微信内部应用可见范围时,
企业微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件




$wecom_corp_id企业微信 CorpID字符串FALSETRUE
$wecom_app_id企业微信应用 ID字符串FALSETRUE
$wecom_app_name企业微信应用名称字符串FALSETRUE企业内部应用名称通过应用id查询
23$WeComMemberUnsubscribeApp



企业微信员工取消关注内部应用
(自建应用回调事件)



$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点员工已经在应用可见范围,员工退出企业或管理员应用移除可见范围时,
企业微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件




$wecom_corp_id企业微信 CorpID字符串FALSETRUE
$wecom_app_id企业微信应用 ID字符串FALSETRUE
$wecom_app_name企业微信应用名称字符串FALSETRUE

24$WeComMemberClickAppMenu











企业微信员工点击内部应用菜单
(自建应用回调事件)












$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点











员工点击企业微信内部应用菜单时,
企业微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件












当设置了应用主页之后,此应用的事件不会触发












$wecom_corp_id企业微信 CorpID字符串FALSETRUE
$wecom_app_menu_key企业微信应用菜单 KEY 值字符串FALSETRUE
$wecom_app_id企业微信应用 ID字符串FALSETRUE
$wecom_app_name企业微信应用名称字符串FALSETRUE
$wecom_app_menu_type企业微信应用菜单类型字符串TRUETRUEclick:点击菜单,
view:点击菜单跳转链接,
view_miniprogram:点击菜单跳转小程序,
scancode_push:扫码推,
scancode_waitmsg:扫码推且弹出“消息接收中”提示框,
pic_sysphoto:弹出系统拍照发图,
pic_photo_or_album:弹出拍照或者相册发图,
pic_weixin:弹出微信相册发图器,
location_select:弹出地理位置选择器
$wecom_scan_type企业微信用户的扫描类型字符串FALSETRUE
$wecom_scan_result企业微信用户的扫描结果字符串FALSETRUE
$wecom_send_pics_count企业微信用户发送图片数量数值FALSETRUE
$wecom_send_pics_md5_list企业微信用户发送图片md5值列表listFALSETRUE
$latitude纬度数值FALSETRUE
$longitude经度数值FALSETRUE
$location_precision地理位置精度数值FALSEFALSE
$location_info地理位置信息字符串FALSEFALSE
25$WeComMemberSendMsgInApp
















企业微信员工在内部应用中发消息
(自建应用回调事件)
















$wecom_member_id企业微信员工 ID字符串FALSETRUE
神策服务器端埋点















员工向企业微信内部应用发送消息时,
企业微信服务器将POST消息的XML数据包到开发者填写的URL上,后端基于接收到的 XML 数据包上报事件

















当设置了应用主页之后,此应用的事件不会触发
















$wecom_corp_id企业微信 CorpID字符串FALSETRUE
$wecom_app_id企业微信应用 ID字符串FALSETRUE
$wecom_app_name企业微信应用名称字符串FALSETRUE
$wecom_msg_type企业微信消息类型字符串TRUETRUEtext:文字消息
image:图片消息
voice:语音消息
video:视频消息
location:地理位置信息
link:链接消息
$wecom_msg_text_content企业微信消息文本内容字符串FALSETRUE
$wecom_msg_id企业微信消息 ID字符串FALSEFALSE
$wecom_msg_pic_url企业微信消息图片链接字符串FALSETRUE
$wecom_msg_media_id企业微信消息媒体 ID字符串FALSETRUE
$wecom_msg_voice_format企业微信消息语音格式字符串FALSETRUE
$wecom_msg_thumb_media_id企业微信消息缩略图媒体 ID字符串FALSETRUE
$wecom_msg_link_description企业微信消息链接描述字符串FALSEFALSE
$wecom_msg_link_url企业微信消息链接地址字符串FALSETRUE
$wecom_msg_link_title企业微信消息链接标题字符串FALSETRUE
$latitude纬度数值FALSETRUE
$longitude经度数值FALSETRUE
$location_precision地理位置精度数值FALSEFALSE
$location_info地理位置信息字符串FALSEFALSE
26$WeComExternalWatchLiving企业微信外部联系人观看直播
(
配置了直播secret的事件)
$wecom_living_id企业微信直播 ID字符串FALSETRUE
每日定时API查询










通过直播id去查询拿到外部联系人观看直播的详情信息











因为是按照直播ID作为字段取数据,所以数据的统计维度是by 直播,而不是by 观看 这个动作










$wecom_living_theme企业微信直播主题字符串FALSETRUE
$wecom_living_anchor_userid企业微信主播用户 ID字符串FALSETRUE
$wecom_living_anchor_dept_id企业微信主播所在主部门 ID数值FALSETRUE
$wecom_living_start_time企业微信直播开始时间DATETIMEFALSETRUE
$wecom_living_end_time企业微信直播结束时间DATETIMEFALSETRUE
$wecom_living_type企业微信直播类型数值TRUETRUE0-通用直播,1-小班课,2-大班课,
3-企业培训,4-活动直播
$wecom_watch_living_duration企业微信观看直播时长数值FALSETRUE
$wecom_living_is_comment企业微信直播是否评论布尔型FALSETRUE
$wecom_living_is_mic企业微信直播是否连麦发言布尔型FALSETRUE
$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE
27$WeComLiveqrcodeExternalChurn 企业微信活码外部联系人流失
(只使用数据采集不会有这个是事件 是渠道活码事件,需要有活码应用)
$wecom_member_id企业微信员工 ID字符串FALSETRUE

当发生外部联系人删除员工或者员工删除外部联系人时,如果是通过活码添加的,那么会发送此事件。










$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE

$wecom_corp_id企业微信 CorpID字符串FALSETRUE

$wecom_liveqrcode_name企业微信活码名称字符串FALSETRUE

$wecom_liveqrcode_configid企业微信活码ID字符串FALSETRUE

$is_first_time是否首次布尔型FALSETRUE

会话内容存档需要首先在企业微信上购买会话内容存档应用后才能采集数据,能采集的数据如下

事件英文名中文名属性英文名属性中文名属性类型是否使用维度字典是否默认展示属性值示例或说明备注埋点形式触发时机
$WeComMemberSwitchCorp

企业微信员工切换企业

(会话内存存档)

$wecom_msg_id企业微信消息 ID字符串FALSEFALSE

定时拉取企业微信员工切换企业触发此事件
$wecom_member_id企业微信员工 ID字符串FALSETRUE

$wecom_corp_id企业微信 CorpID字符串FALSETRUE

$WeComMemberRecallMsg

企业微信员工撤回消息

(会话内存存档)

$wecom_member_id企业微信员工 ID字符串FALSETRUE

定时拉取员工撤回消息触发此事件
$wecom_corp_id企业微信 CorpID字符串FALSETRUE

$wecom_msg_tolist企业微信消息接收方列表listFALSEFALSE同一个企业内容为userid,非相同企业为external_userid
$wecom_msg_type企业微信消息类型字符串TRUETRUE固定为:revoke
$wecom_group_id企业微信群 ID字符串FALSETRUE如果是单聊则为空。
$wecom_msg_id企业微信消息 ID字符串FALSEFALSE

$wecom_recall_msg_id企业微信撤回消息 ID字符串FALSEFALSE

$WeComExternalRecallMsg

企业微信客户撤回消息

(会话内存存档)

$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE

定时拉取客户撤回消息触发此事件
$wecom_corp_id企业微信 CorpID字符串FALSETRUE

$wecom_msg_tolist企业微信消息接收方列表listFALSEFALSE同一个企业内容为userid,非相同企业为external_userid
$wecom_msg_type企业微信消息类型字符串FALSETRUE固定为:revoke
$wecom_group_id企业微信群 ID字符串FALSETRUE如果是单聊则为空。
$wecom_msg_id企业微信消息 ID字符串FALSEFALSE

$wecom_recall_msg_id企业微信撤回消息 ID字符串FALSEFALSE

$WeComMemberSendMsg

企业微信员工发送消息

(会话内存存档)

$wecom_msg_id企业微信消息 ID字符串FALSEFALSE

定时拉取员工发送消息触发此事件
$wecom_member_id企业微信员工 ID字符串FALSETRUE

$wecom_corp_id企业微信 CorpID字符串FALSETRUE

$wecom_msg_tolist企业微信消息接收方列表listFALSEFALSE同一个企业内容为userid,非相同企业为external_userid
$wecom_group_id企业微信群 ID字符串FALSETRUE如果是单聊则为空。
$wecom_msg_type企业微信消息类型字符串TRUETRUEtext:文本,
image:图片,
link:链接,
weapp:小程序,
redpacket:红包,
external_redpacket:互通红包,
file:文件,
voip_doc_share:音频共享文档,
voice:语音,
video:视频,
card:名片,
location:位置,
emotion:表情,
chatrecord会话记录,
collect:填表,
meeting:会议邀请,
docmsg:在线文档,
calendar:日程,
markdown:MarkDown格式,
meeting_voice_call:音频存档,
维度字典
文本





$wecom_msg_text_content企业微信消息文本内容字符串FALSETRUE

图片





$wecom_msg_image_md5sum企业微信消息图片 md5 值字符串FALSEFALSE

$wecom_msg_image_fileid企业微信消息图片 ID字符串FALSETRUE

$wecom_msg_image_filesize企业微信消息图片大小字符串FALSETRUE

链接





$wecom_msg_link_description企业微信消息链接描述字符串FALSEFALSE

$wecom_msg_link_url企业微信消息链接地址字符串FALSETRUE

$wecom_msg_link_title企业微信消息链接标题字符串FALSETRUE

$wecom_msg_link_image_url企业微信消息链接图片地址字符串FALSETRUE

小程序消息





$wecom_msg_weapp_description企业微信消息小程序描述字符串FALSEFALSE

$wecom_msg_weapp_displayname企业微信消息小程序显示名字符串FALSETRUE

$wecom_msg_weapp_title企业微信消息小程序标题字符串FALSETRUE

$wecom_msg_weapp_username企业微信消息小程序用户名称字符串FALSETRUE

红包消息





$wecom_redpacket_type企业微信红包类型字符串TRUETRUE1-普通红包、2-拼手气群红包、3-激励群红包维度字典
$wecom_redpacket_wish企业微信红包祝福语字符串FALSETRUE

$wecom_redpacket_totalcnt企业微信红包总个数数值FALSETRUE

$wecom_redpacket_totalamount企业微信红包总金额数值FALSETRUE单位为分
文件消息


TRUE

$wecom_doc_share_filename企业微信文档共享文件名称字符串FALSETRUE

$WeComExternalSendMsg





























企业微信外部联系人发送消息
(会话内存存档)

$wecom_msg_id企业微信消息 ID字符串FALSEFALSE

定时拉取客户发送消息触发此事件
$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE

$wecom_corp_id企业微信CorpID字符串FALSETRUE

$wecom_msg_tolist企业微信消息接收方列表listFALSEFALSE同一个企业内容为userid,非相同企业为external_userid
$wecom_group_id企业微信群 ID字符串FALSETRUE如果是单聊则为空。
$wecom_msg_type企业微信消息类型字符串TRUETRUE
维度字典
文本





$wecom_msg_text_content企业微信消息文本内容字符串FALSETRUE

图片





$wecom_msg_image_md5sum企业微信消息图片 md5 值字符串FALSEFALSE

$wecom_msg_image_fileid企业微信消息图片 ID字符串FALSETRUE

$wecom_msg_image_filesize企业微信消息图片大小字符串FALSETRUE

链接





$wecom_msg_link_description企业微信消息链接描述字符串FALSEFALSE

$wecom_msg_link_url企业微信消息链接地址字符串FALSETRUE

$wecom_msg_link_title企业微信消息链接标题字符串FALSETRUE

$wecom_msg_link_image_url企业微信消息链接图片地址字符串FALSETRUE

小程序消息





$wecom_msg_weapp_description企业微信消息小程序描述字符串FALSEFALSE

$wecom_msg_weapp_displayname企业微信消息小程序显示名字符串FALSETRUE

$wecom_msg_weapp_title企业微信消息小程序标题字符串FALSETRUE

$wecom_msg_weapp_username企业微信消息小程序用户名称字符串FALSETRUE

红包消息





$wecom_redpacket_type企业微信红包类型字符串TRUETRUE1 普通红包、2 拼手气群红包、3 激励群红包维度字典
$wecom_redpacket_wish企业微信红包祝福语字符串FALSETRUE

$wecom_redpacket_totalcnt企业微信红包总个数数值FALSETRUE

$wecom_redpacket_totalamount企业微信红包总金额数值FALSETRUE单位为分
文件消息





$wecom_doc_share_filename企业微信文档共享文件名称字符串FALSETRUE

$WeComExternalChangeAgreement

企业微信外部联系人变更会话协议

(会话内存存档)

$wecom_external_user_id企业微信外部联系人 ID字符串FALSETRUE

定时拉取客户变更会话协议触发此事件
$wecom_agreenment_change_status企业微信会话协议变更状态字符串FALSETRUE同意/不同意此状态为变更后状态
$wecom_corp_id企业微信CorpID字符串FALSETRUE

上一个
微信预置事件和预置属性
下一个
App 推送集成
最近修改: 2024-12-27