云真机

API接口文档


解密后的数据结构介绍

<h2>简介</h2> <p>当发生数据更新变动或下发的任务执行完成时,会推送数据到用户的回调地址,用户可根据接收到的数据进行处理。数据推送前已被加密,加解密方式参见: &lt;a href=&quot;<a href="https://www.showdoc.com.cn/yunzhenji/11490692518660567&quot;&gt;https://www.showdoc.com.cn/yunzhenji/11490692518660567&lt;/a&gt">https://www.showdoc.com.cn/yunzhenji/11490692518660567&quot;&gt;https://www.showdoc.com.cn/yunzhenji/11490692518660567&lt;/a&gt</a>;</p> <h2>回调数据解密后的格式</h2> <p>智域管家.云真机通过POST请求API回调URL,Request的ContentType都是application/json。</p> <pre><code>Content-Type: application/json; charset=utf-8</code></pre> <p>Request发送的body内容解密后的数据有一个通用格式:</p> <pre><code>[ { &amp;quot;type&amp;quot;: &amp;quot;xxxxxx&amp;quot;, //回调类型 &amp;quot;corp_wxid&amp;quot;: &amp;quot;xxxxxx&amp;quot;, //当前服务的企微号归属企业的微信ID &amp;quot;rel_wxid&amp;quot;:&amp;quot;xxxxx&amp;quot;,//当前服务的企微号微信ID &amp;quot;data&amp;quot;: [{}] //回调数据 }, { &amp;quot;type&amp;quot;: &amp;quot;xxxxxx&amp;quot;, //回调类型 &amp;quot;rel_wxid&amp;quot;:&amp;quot;xxxxx&amp;quot;,//当前服务的企微号微信ID &amp;quot;data&amp;quot;: [{}] //回调数据 }, { .... //数组每一项表示一条消息通知 } ]</code></pre> <p>Response响应的格式不做限制,一般可为:</p> <pre><code>{ &amp;quot;errcode&amp;quot;:0 }</code></pre> <h2>请求参数</h2> <ul> <li>json结构体,结构体描述如下:</li> </ul> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>回调类型</td> </tr> <tr> <td style="text-align: left;">rel_wxid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>当前服务的企微号微信ID</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">是</td> <td style="text-align: left;">mixed</td> <td>对应不同的结构体</td> </tr> </tbody> </table> <h2>回调类型(type)</h2> <table> <thead> <tr> <th style="text-align: left;">回调类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">&lt;a href=&quot;#chatMsg&quot;&gt;chatMsg&lt;/a&gt;</td> <td style="text-align: left;">聊天消息(群聊或私聊)。&lt;font color=&quot;red&quot;&gt;有该回调事件仅代表消息已发出,默认成功,失败情况需要专门处理下方失败事件【chatMsgSendFail】&lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#chatMsgSendFail&quot;&gt;chatMsgSendFail&lt;/a&gt;</td> <td style="text-align: left;">聊天消息(群聊或私聊)发送失败</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#updateChatMsg&quot;&gt;updateChatMsg&lt;/a&gt;</td> <td style="text-align: left;">聊天消息(群聊或私聊)撤回</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#voiceToText&quot;&gt;voiceToText&lt;/a&gt;</td> <td style="text-align: left;">聊天消息语音转文本(1秒内能转好的文本随聊天消息一起回调(chatMsg),1秒内未转好的通过此类型voiceToText事件回调)</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#contacts&quot;&gt;contacts&lt;/a&gt;</td> <td style="text-align: left;">客户(联系人)信息</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#contactCorps&quot;&gt;contactCorps&lt;/a&gt;</td> <td style="text-align: left;">客户(联系人)所属企业信息</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#rooms&quot;&gt;rooms&lt;/a&gt;</td> <td style="text-align: left;">群信息(含群公告)</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#roomMembers&quot;&gt;roomMembers&lt;/a&gt;</td> <td style="text-align: left;">群成员信息</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#tags&quot;&gt;tags&lt;/a&gt;</td> <td style="text-align: left;">企业标签(组)</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#wechatOnline&quot;&gt;wechatOnline&lt;/a&gt;</td> <td style="text-align: left;">企微号上线</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#wechatOffline&quot;&gt;wechatOffline&lt;/a&gt;</td> <td style="text-align: left;">企微号离线</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#voiceVideoCall&quot;&gt;voiceVideoCall&lt;/a&gt;</td> <td style="text-align: left;">新语音/视频通话</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#taskDone&quot;&gt;taskDone&lt;/a&gt;</td> <td style="text-align: left;">下发任务完成</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#wechatExtInfo&quot;&gt;wechatExtInfo&lt;/a&gt;</td> <td style="text-align: left;">企微号扩展信息(账号异常回调)</td> </tr> <tr> <td style="text-align: left;">&lt;a href=&quot;#contactSmartTag&quot;&gt;contactSmartTag&lt;/a&gt;</td> <td style="text-align: left;">客户(联系人)智能标签变动(按用户开放,联系客服开通)</td> </tr> </tbody> </table> <h2>不同类型下的data结构</h2> <ul> <li>聊天消息(chatMsg)&lt;a id=&quot;chatMsg&quot;&gt;&lt;/a&gt;</li> </ul> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">from_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">发送者wxid</td> </tr> <tr> <td style="text-align: left;">to_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">接收者wxid</td> </tr> <tr> <td style="text-align: left;">chat_type</td> <td style="text-align: left;">int</td> <td style="text-align: left;">1私聊,2群聊</td> </tr> <tr> <td style="text-align: left;">msg_type</td> <td style="text-align: left;">string</td> <td style="text-align: left;">消息类型</td> </tr> <tr> <td style="text-align: left;">content</td> <td style="text-align: left;">object</td> <td style="text-align: left;">参见“&lt;a href=&quot;<a href="https://www.showdoc.com.cn/yunzhenji/11490690012909560&quot;&gt;聊天消息数据结构&lt;/a&gt;”章节">https://www.showdoc.com.cn/yunzhenji/11490690012909560&quot;&gt;聊天消息数据结构&lt;/a&gt;”章节</a></td> </tr> <tr> <td style="text-align: left;">svrid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">消息全局唯一ID</td> </tr> <tr> <td style="text-align: left;">extra</td> <td style="text-align: left;">object</td> <td style="text-align: left;">消息附带数据</td> </tr> <tr> <td style="text-align: left;">extra.api_send_id</td> <td style="text-align: left;">string</td> <td style="text-align: left;">通过api接口&lt;a href=&quot;<a href="https://www.showdoc.com.cn/yunzhenji/11490695962081036&quot;&gt;发送消息&lt;/a&gt;且带了api_send_id字段,会在此处带回。类型无论发送接口处是整型还是字符串型,此处都为字符串类型">https://www.showdoc.com.cn/yunzhenji/11490695962081036&quot;&gt;发送消息&lt;/a&gt;且带了api_send_id字段,会在此处带回。类型无论发送接口处是整型还是字符串型,此处都为字符串类型</a>。</td> </tr> <tr> <td style="text-align: left;">extra.api_send_svrid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">通过api接口&lt;a href=&quot;<a href="https://www.showdoc.com.cn/yunzhenji/11490695962081036&quot;&gt;发送消息&lt;/a&gt;系统会生成自己的发送消息ID:api_send_svrid,会在此处带回。有别于svrid,请不要混淆">https://www.showdoc.com.cn/yunzhenji/11490695962081036&quot;&gt;发送消息&lt;/a&gt;系统会生成自己的发送消息ID:api_send_svrid,会在此处带回。有别于svrid,请不要混淆</a>。</td> </tr> </tbody> </table> <ul> <li>聊天消息撤回 (updateChatMsg)&lt;a id=&quot;updateChatMsg&quot;&gt;&lt;/a&gt;</li> </ul> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">from_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">发送者wxid</td> </tr> <tr> <td style="text-align: left;">to_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">接收者wxid</td> </tr> <tr> <td style="text-align: left;">msg_type</td> <td style="text-align: left;">string</td> <td style="text-align: left;">消息类型</td> </tr> <tr> <td style="text-align: left;">msg_time</td> <td style="text-align: left;">string</td> <td style="text-align: left;">消息发送时间,时间戳(毫秒)</td> </tr> <tr> <td style="text-align: left;">wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">上报消息企微号wxid</td> </tr> <tr> <td style="text-align: left;">chat_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">聊天对象wxid(群聊以R:开头)</td> </tr> <tr> <td style="text-align: left;">svrid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">消息全局唯一ID,可用于标记之前发送的消息状态</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">int</td> <td style="text-align: left;">发送消息后没有该回调默认发送成功;status: 3表示撤回,其他值忽略。</td> </tr> </tbody> </table> <ul> <li>聊天消息发送失败 (chatMsgSendFail)&lt;a id=&quot;chatMsgSendFail&quot;&gt;&lt;/a&gt;</li> </ul> <p>数据示例:</p> <pre><code>[     {         &amp;quot;corp_wxid&amp;quot;:&amp;quot;xxx&amp;quot;,         &amp;quot;rel_wxid&amp;quot;:&amp;quot;168xxx&amp;quot;,         &amp;quot;type&amp;quot;:&amp;quot;chatMsgSendFail&amp;quot;,         &amp;quot;data&amp;quot;:[             {                 &amp;quot;api_send_id&amp;quot;:&amp;quot;xxx&amp;quot;,//调用发消息接口时由用户自定义,发送失败回调时此处原样带回                 &amp;quot;api_send_svrid&amp;quot;:&amp;quot;168xxx,7xxx,1675995049713gMWlEj&amp;quot;,//调用发消息接口时由系统自动生成,发送失败回调时此处原样带回                 &amp;quot;source&amp;quot;:1,                 &amp;quot;errcode&amp;quot;:1,                 &amp;quot;message&amp;quot;:&amp;quot;对方还不是你的联系人,请先发送申请验证,对方通过验证后才能聊天。&amp;quot;//发送失败原因             }         ]     } ]</code></pre> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">api_send_id</td> <td style="text-align: left;">string</td> <td style="text-align: left;">用户调用发消息接口时带的自定义ID(可以使用用户业务发送记录ID)</td> </tr> <tr> <td style="text-align: left;">api_send_svrid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">用户调用发消息接口时智域管家.云真机自动生成的消息ID,由三部分组成以逗号分隔:【&quot;{发送消息企微号wxid},{接收消息的客户或群wxid},{毫秒时间戳+6位随机字符串}&quot;】 ,如:【&quot;168xxx,7xxx,1675995049713gMWlEj&quot;】</td> </tr> <tr> <td style="text-align: left;">errcode</td> <td style="text-align: left;">int</td> <td style="text-align: left;">异常错误码,目前未区分,统一为1</td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">string</td> <td style="text-align: left;">发送失败原因</td> </tr> </tbody> </table> <ul> <li>聊天消息语音转文本(voiceToText)&lt;a id=&quot;voiceToText&quot;&gt;&lt;/a&gt;</li> </ul> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">svrid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">消息全局唯一ID,通过该字段与之前收到的聊天消息做关联</td> </tr> <tr> <td style="text-align: left;">text</td> <td style="text-align: left;">string</td> <td style="text-align: left;">语音消息转成的文本</td> </tr> </tbody> </table> <p>数据示例:</p> <pre><code>[ {       &amp;quot;corp_wxid&amp;quot;:&amp;quot;xxx&amp;quot;, &amp;quot;rel_wxid&amp;quot;:&amp;quot;168xxx&amp;quot;, &amp;quot;type&amp;quot;:&amp;quot;voiceToText&amp;quot;, &amp;quot;data&amp;quot;:[ { &amp;quot;from_wxid&amp;quot;:&amp;quot;7xxx&amp;quot;, &amp;quot;to_wxid&amp;quot;:&amp;quot;168xxx&amp;quot;, &amp;quot;wxid&amp;quot;:&amp;quot;168xxx&amp;quot;, &amp;quot;chat_wxid&amp;quot;:&amp;quot;7xxx&amp;quot;, &amp;quot;svrid&amp;quot;:&amp;quot;xxx&amp;quot;, &amp;quot;msg_hash&amp;quot;:&amp;quot;from_msgid_772634421531187180&amp;quot;, &amp;quot;wx_svrid&amp;quot;:&amp;quot;2185971&amp;quot;, &amp;quot;text&amp;quot;:&amp;quot;你好,...&amp;quot; } ] } ]</code></pre> <ul> <li>好友(联系人)信息(contacts)&lt;a id=&quot;contacts&quot;&gt;&lt;/a&gt;</li> </ul> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">联系人wxid</td> </tr> <tr> <td style="text-align: left;">nickname</td> <td style="text-align: left;">string</td> <td style="text-align: left;">昵称</td> </tr> <tr> <td style="text-align: left;">alias</td> <td style="text-align: left;">string</td> <td style="text-align: left;">别名</td> </tr> <tr> <td style="text-align: left;">real_name</td> <td style="text-align: left;">string</td> <td style="text-align: left;">真实姓名</td> </tr> <tr> <td style="text-align: left;">avatar</td> <td style="text-align: left;">string</td> <td style="text-align: left;">头像</td> </tr> <tr> <td style="text-align: left;">gender</td> <td style="text-align: left;">int</td> <td style="text-align: left;">性别:1男;2女;0未知</td> </tr> <tr> <td style="text-align: left;">make_time</td> <td style="text-align: left;">int</td> <td style="text-align: left;">加好友时间戳(秒)</td> </tr> <tr> <td style="text-align: left;">phone_list</td> <td style="text-align: left;">array</td> <td style="text-align: left;">手机号,备注了会有,数组如:[],[&quot;136xxxx&quot;,&quot;137xxxx&quot;]</td> </tr> <tr> <td style="text-align: left;">remark</td> <td style="text-align: left;">string</td> <td style="text-align: left;">备注</td> </tr> <tr> <td style="text-align: left;">desc</td> <td style="text-align: left;">string</td> <td style="text-align: left;">描述</td> </tr> <tr> <td style="text-align: left;">source</td> <td style="text-align: left;">string</td> <td style="text-align: left;">来源:1扫一扫;2手机号;3名片;4群聊;6微信好友;8第三方应用专属客服;其他值如-1、100等表示:其他</td> </tr> <tr> <td style="text-align: left;">wechat_type</td> <td style="text-align: left;">int</td> <td style="text-align: left;">类型:1个微;2企微</td> </tr> <tr> <td style="text-align: left;">corp_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">好友所属企业微信ID</td> </tr> <tr> <td style="text-align: left;">corp_tag_wxids</td> <td style="text-align: left;">string</td> <td style="text-align: left;">好友标签,多个英文逗号分隔</td> </tr> <tr> <td style="text-align: left;">is_deleted</td> <td style="text-align: left;">int</td> <td style="text-align: left;">是否已删除好友:0否;1是</td> </tr> <tr> <td style="text-align: left;">bitval</td> <td style="text-align: left;">int</td> <td style="text-align: left;">用于判断好友是否删除当前企微号;二进制位从低位开始数第4位是0表示被删,是1表示未被删;也可与十进制数字“8”按位与:结果是0表示对方删掉自己了,非0表示对方没有删掉自己。比如:bitval的值是1,1 按位与 8 = 0;表示好友已删除自己;</td> </tr> </tbody> </table> <ul> <li>好友所属企业信息(contactCorps)&lt;a id=&quot;contactCorps&quot;&gt;&lt;/a&gt;</li> </ul> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">admin_name</td> <td style="text-align: left;">string</td> <td style="text-align: left;">企业注册者姓名</td> </tr> <tr> <td style="text-align: left;">admin_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">企业注册者微信ID</td> </tr> <tr> <td style="text-align: left;">wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">联系人归属企业wxid,与好友(联系人)信息(contacts)中的corp_wxid一致</td> </tr> <tr> <td style="text-align: left;">full_name</td> <td style="text-align: left;">string</td> <td style="text-align: left;">企业全称</td> </tr> <tr> <td style="text-align: left;">short_name</td> <td style="text-align: left;">string</td> <td style="text-align: left;">企业简称</td> </tr> <tr> <td style="text-align: left;">logo</td> <td style="text-align: left;">string</td> <td style="text-align: left;">企业logo</td> </tr> <tr> <td style="text-align: left;">verified</td> <td style="text-align: left;">string</td> <td style="text-align: left;">企业是否认证: 0否;非0是</td> </tr> </tbody> </table> <ul> <li>群信息(rooms)&lt;a id=&quot;rooms&quot;&gt;&lt;/a&gt;</li> </ul> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">客户群wxid</td> </tr> <tr> <td style="text-align: left;">nickname</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群昵称</td> </tr> <tr> <td style="text-align: left;">announcement</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群公告</td> </tr> <tr> <td style="text-align: left;">owner_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群主微信id</td> </tr> <tr> <td style="text-align: left;">wx_ctime</td> <td style="text-align: left;">int</td> <td style="text-align: left;">群创建时间戳(秒)</td> </tr> <tr> <td style="text-align: left;">member_count</td> <td style="text-align: left;">int</td> <td style="text-align: left;">群成员数</td> </tr> <tr> <td style="text-align: left;">invite_confirm</td> <td style="text-align: left;">bool</td> <td style="text-align: left;">群聊邀请是否需要确认:false否;true是;</td> </tr> <tr> <td style="text-align: left;">members</td> <td style="text-align: left;">array</td> <td style="text-align: left;">群成员数组</td> </tr> <tr> <td style="text-align: left;">members[0].wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群成员微信id</td> </tr> <tr> <td style="text-align: left;">members[0].entry_time</td> <td style="text-align: left;">int</td> <td style="text-align: left;">进群时间戳(秒)</td> </tr> <tr> <td style="text-align: left;">members[0].inviter_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">邀请者微信id</td> </tr> <tr> <td style="text-align: left;">members[0].is_admin</td> <td style="text-align: left;">int</td> <td style="text-align: left;">是否管理员:0否1是</td> </tr> <tr> <td style="text-align: left;">members[0].join_scene</td> <td style="text-align: left;">int</td> <td style="text-align: left;">进群方式:1邀请;2链接入群;3扫码入群</td> </tr> </tbody> </table> <ul> <li>群成员信息(roomMembers)&lt;a id=&quot;roomMembers&quot;&gt;&lt;/a&gt; &lt;br&gt;&lt;font color=&quot;red&quot;&gt;注意:数据是分批多次上报上来的,不会一次上报下面所有字段。每次上报了哪些字段,部分更新入库下就行。&lt;/font&gt;</li> </ul> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">room_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群微信id</td> </tr> <tr> <td style="text-align: left;">owner_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群主微信id</td> </tr> <tr> <td style="text-align: left;">scene</td> <td style="text-align: left;">string</td> <td style="text-align: left;">非iPad和aPad协议登录的企微号,数据上报场景值:初始化init,表示初始化全量上报数据; 空字符串表示非初始化,即正常的增量上报;&lt;font color=&quot;red&quot;&gt;iPad和aPad协议情景下,该字段无意义;&lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">array</td> <td style="text-align: left;">群成员数组</td> </tr> <tr> <td style="text-align: left;">data[0].wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群成员wxid</td> </tr> <tr> <td style="text-align: left;">data[0].nickname</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群成员昵称</td> </tr> <tr> <td style="text-align: left;">data[0].remark</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群成员备注</td> </tr> <tr> <td style="text-align: left;">data[0].gender</td> <td style="text-align: left;">int</td> <td style="text-align: left;">群成员性别:1男;2女;0未知</td> </tr> <tr> <td style="text-align: left;">data[0].avatar</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群成员头像</td> </tr> <tr> <td style="text-align: left;">data[0].inviter_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">邀请人wxid</td> </tr> <tr> <td style="text-align: left;">data[0].entry_time</td> <td style="text-align: left;">int</td> <td style="text-align: left;">进群时间</td> </tr> <tr> <td style="text-align: left;">data[0].join_scene</td> <td style="text-align: left;">int</td> <td style="text-align: left;">进群方式:1(直接邀请入群)、2(链接入群)、3(扫描入群)</td> </tr> <tr> <td style="text-align: left;">data[0].corp_wxid</td> <td style="text-align: left;">string</td> <td style="text-align: left;">群成员归属企业wxid</td> </tr> <tr> <td style="text-align: left;">data[0].wechat_type</td> <td style="text-align: left;">int</td> <td style="text-align: left;">类型:1个微;2企微</td> </tr> <tr> <td style="text-align: left;">data[0].is_deleted</td> <td style="text-align: left;">int</td> <td style="text-align: left;">成员是否退群,1是,0或没该字段表示否</td> </tr> <tr> <td style="text-align: left;">data[0].is_new</td> <td style="text-align: left;">int</td> <td style="text-align: left;">是否新成员进群:1是(前提是scene!=&quot;init&quot;),0或没返回该字段表示否;</td> </tr> <tr> <td style="text-align: left;">data[0].is_admin</td> <td style="text-align: left;">int</td> <td style="text-align: left;">是否管理员,有该字段且字段值为1表示管理员;</td> </tr> </tbody> </table> <ul> <li>企业标签(组)(tags)&lt;a id=&quot;tags&quot;&gt;&lt;/a&gt;</li> </ul> <p>数据示例: ```[     {         &quot;corp_wxid&quot;:&quot;xxx&quot;,         &quot;rel_wxid&quot;:&quot;xxx&quot;,         &quot;type&quot;:&quot;tags&quot;,         &quot;data&quot;:[             {                 &quot;is_deleted&quot;:0,                 &quot;is_group&quot;:0,                 &quot;parent_wxid&quot;:&quot;xxx&quot;,                 &quot;type&quot;:1,                 &quot;wx_ctime&quot;:1650850244,                 &quot;wx_name&quot;:&quot;4.23男&quot;,                 &quot;wx_order&quot;:0,                 &quot;wxid&quot;:&quot;xxx&quot;             },             {                 &quot;is_deleted&quot;:0,                 &quot;is_group&quot;:0,                 &quot;parent_wxid&quot;:&quot;xxx&quot;,                 &quot;type&quot;:1,                 &quot;wx_ctime&quot;:1650850244,                 &quot;wx_name&quot;:&quot;4.23女&quot;,                 &quot;wx_order&quot;:0,                 &quot;wxid&quot;:&quot;xxx&quot;             }         ]     } ]</p> <pre><code> |字段|类型|说明| |:---- |:---|:----- | |is_deleted |int|是否删除:0否;1是 | |is_group |int |是否标签组:0否;1是 | |parent_wxid |string|标签(组)上一级微信ID | |type |int|类型:1企业标签;2个人标签 | |wx_ctime |int|微信创建时间戳(秒) | |wx_order |int|顺序值 | |wx_name |string|标签(组)名称 | |wxid |string|标签(组)微信ID | - 企微号上线(wechatOnline)&amp;lt;a id=&amp;quot;wechatOnline&amp;quot;&amp;gt;&amp;lt;/a&amp;gt; 数据示例:</code></pre> <p>[ { &quot;type&quot;:&quot;wechatOnline&quot;, &quot;data&quot;:[ { &quot;id&quot;:1646, &quot;wxid&quot;:&quot;xxx&quot;, &quot;nickname&quot;:&quot;xxx&quot;, &quot;full_name&quot;:&quot;xxx&quot;, &quot;avatar&quot;:&quot;http:\/\/wework.qpic.cn\/bizmail\/mIu5Ucn8jMpd02ibP297T2ERCzYFjydpIxsqKibWzCL0NwlU5GIoNTfA\/0&quot;, &quot;mobile&quot;:&quot;xxx&quot;, &quot;corp_id&quot;:3, &quot;online&quot;:1, &quot;last_login_time&quot;:1646708151, &quot;last_offline_time&quot;:1646210928, &quot;ctime&quot;:1641460958, &quot;utime&quot;:1646708151, &quot;corp&quot;:{ &quot;id&quot;:3, &quot;name&quot;:&quot;杭州xx科技有限公司&quot;, &quot;short_name&quot;:&quot;xx网络&quot;, &quot;wxid&quot;:&quot;xxx&quot;, &quot;remark&quot;:&quot;&quot;, &quot;legal_person_name&quot;:&quot;xxx&quot;, &quot;legal_person_id&quot;:&quot;xxx&quot;, &quot;verify_type&quot;:2, &quot;ctime&quot;:1635157724, &quot;utime&quot;:1645427939 } } ] } ]</p> <pre><code> |字段|类型|说明| |:---- |:---|:----- | |wxid |string|企微号wxid | |nickname |string |昵称 | |full_name |string |全名 | |avatar |string |头像 | |mobile |string |手机号 | |corp_id|int|企业ID |online |int |是否在线 | |last_login_time |int |上次登录时间戳(秒) | |last_offline_time |int |上次下线时间戳(秒) | |corp|object |企业信息| |corp.wxid |string |企业wxid | |corp.name |string |企业名称 | |corp.short_name |string |企业简称 | |corp.legal_person_name |string |企业注册者名称 | |corp.legal_person_id |string |企业注册者Id | - 企微号离线(wechatOffline)&amp;lt;a id=&amp;quot;wechatOffline&amp;quot;&amp;gt;&amp;lt;/a&amp;gt; |字段|类型|说明| |:---- |:---|:----- | |wxid |string|企微号wxid | |error_code |int|企微号离线错误码 | |error_msg |string|企微号离线原因 | - 语音/视频通话(voiceVideoCall)&amp;lt;a id=&amp;quot;voiceVideoCall&amp;quot;&amp;gt;&amp;lt;/a&amp;gt; |字段|类型|说明| |:---- |:---|:----- | |wxid |string|企微号wxid | |chat_wxid |string|联系人微信id | |type |int|1视频;2语音 | |voipid |int|通话id(接受或拒绝时需要该字段) | |contactid |string|会话ID | |users |Array|会话双方的wxid | - 下发任务执行完成(taskDone)&amp;lt;a id=&amp;quot;taskDone&amp;quot;&amp;gt;&amp;lt;/a&amp;gt; |字段|类型|说明| |:---- |:---|:----- | |task_id |int|任务id | |task_type |string|任务类型 | |errcode |int|错误代码,0表示无错误 | |message |string|错误描述,无错误为空 | |res_data |object|任务执行结果,字段参见查询任务 | - 企微号扩展信息(wechatExtInfo)&amp;lt;a id=&amp;quot;wechatExtInfo&amp;quot;&amp;gt;&amp;lt;/a&amp;gt; 说明:该事件来自pc客户端上的弹窗信息,企微号登录在iPad平台时没有该事件。 数据示例:</code></pre> <p>[     {         &quot;corp_wxid&quot;:&quot;197xxx&quot;,         &quot;rel_wxid&quot;:&quot;168xxx&quot;,         &quot;type&quot;:&quot;wechatExtInfo&quot;,         &quot;data&quot;:{             &quot;data&quot;:{                 &quot;action&quot;:&quot;{&quot;action&quot;:&quot;makeFriendFromMobile&quot;,&quot;router&quot;:{&quot;client&quot;:&quot;wechat&quot;,&quot;wxid&quot;:&quot;168xxx&quot;,&quot;uid&quot;:&quot;xxx&quot;},&quot;data&quot;:{&quot;mobile&quot;:&quot;xxx&quot;,&quot;content&quot;:&quot;你好&quot;,&quot;flag&quot;:1,&quot;extra&quot;:{&quot;user_id&quot;:&quot;xxx&quot;,&quot;task_id&quot;:&quot;xxx&quot;,&quot;open_callback_type&quot;:0}}}&quot;,                 &quot;action_time&quot;:1699254139,                 &quot;text&quot;:&quot;添加好友过于频繁,请稍后再重试&quot;,                 &quot;title&quot;:&quot;封禁提示&quot;             },             &quot;type&quot;:1         }     } ]</p> <pre><code> |字段|类型|说明| |:---- |:---|:----- | |rel_wxid |string|企微号wxid | |data.type |string |类型,1: 弹窗提醒,暂时只有这1种类型 | |data.data |object |数据内容 | |data.data.action_time |string |事件发生时间戳,单位秒 | |data.data.action |string |事件参数,json字符串,具体字段与具体事件相关 | |data.data.title |string |事件标题,可根据该字段 | |data.data.text |string |事件内容,可根据该字段进行账号状态监控,比如监控&amp;quot;添加好友过于频繁&amp;quot;、&amp;quot;向微信好友发消息功能已被限制使用&amp;quot;、&amp;quot;本群涉嫌违法或违规,已被暂停使用&amp;quot;,等可以判断账号当前状态 | - 客户(联系人)智能标签变动(contactSmartTag)&amp;lt;a id=&amp;quot;contactSmartTag&amp;quot;&amp;gt;&amp;lt;/a&amp;gt; |字段|类型|说明| |:---- |:---|:----- | |user_id |string|企微宝平台用户ID | |rel_wxid |string|企微号wxid | |wxid |string|客户(联系人)wxid | |make_time |int|加好友时间戳(秒) | |add_tag_ids|string[]|新增智能标签id,数组| |del_tag_ids|string[]|删除智能标签id,数组| |all_tag_ids|string[]|客户当前全部智能标签id,数组|</code></pre>

页面列表

ITEM_HTML