解密后的数据结构介绍
<h2>简介</h2>
<p>当发生数据更新变动或下发的任务执行完成时,会推送数据到用户的回调地址,用户可根据接收到的数据进行处理。数据推送前已被加密,加解密方式参见:
<a href="<a href="https://www.showdoc.com.cn/yunzhenji/11490692518660567">https://www.showdoc.com.cn/yunzhenji/11490692518660567</a>">https://www.showdoc.com.cn/yunzhenji/11490692518660567">https://www.showdoc.com.cn/yunzhenji/11490692518660567</a></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>[
{
&quot;type&quot;: &quot;xxxxxx&quot;, //回调类型
&quot;corp_wxid&quot;: &quot;xxxxxx&quot;, //当前服务的企微号归属企业的微信ID
&quot;rel_wxid&quot;:&quot;xxxxx&quot;,//当前服务的企微号微信ID
&quot;data&quot;: [{}] //回调数据
},
{
&quot;type&quot;: &quot;xxxxxx&quot;, //回调类型
&quot;rel_wxid&quot;:&quot;xxxxx&quot;,//当前服务的企微号微信ID
&quot;data&quot;: [{}] //回调数据
},
{
.... //数组每一项表示一条消息通知
}
]</code></pre>
<p>Response响应的格式不做限制,一般可为:</p>
<pre><code>{
&quot;errcode&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;"><a href="#chatMsg">chatMsg</a></td>
<td style="text-align: left;">聊天消息(群聊或私聊)。<font color="red">有该回调事件仅代表消息已发出,默认成功,失败情况需要专门处理下方失败事件【chatMsgSendFail】</font></td>
</tr>
<tr>
<td style="text-align: left;"><a href="#chatMsgSendFail">chatMsgSendFail</a></td>
<td style="text-align: left;">聊天消息(群聊或私聊)发送失败</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#updateChatMsg">updateChatMsg</a></td>
<td style="text-align: left;">聊天消息(群聊或私聊)撤回</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#voiceToText">voiceToText</a></td>
<td style="text-align: left;">聊天消息语音转文本(1秒内能转好的文本随聊天消息一起回调(chatMsg),1秒内未转好的通过此类型voiceToText事件回调)</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#contacts">contacts</a></td>
<td style="text-align: left;">客户(联系人)信息</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#contactCorps">contactCorps</a></td>
<td style="text-align: left;">客户(联系人)所属企业信息</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#rooms">rooms</a></td>
<td style="text-align: left;">群信息(含群公告)</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#roomMembers">roomMembers</a></td>
<td style="text-align: left;">群成员信息</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#tags">tags</a></td>
<td style="text-align: left;">企业标签(组)</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#wechatOnline">wechatOnline</a></td>
<td style="text-align: left;">企微号上线</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#wechatOffline">wechatOffline</a></td>
<td style="text-align: left;">企微号离线</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#voiceVideoCall">voiceVideoCall</a></td>
<td style="text-align: left;">新语音/视频通话</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#taskDone">taskDone</a></td>
<td style="text-align: left;">下发任务完成</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#wechatExtInfo">wechatExtInfo</a></td>
<td style="text-align: left;">企微号扩展信息(账号异常回调)</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#contactSmartTag">contactSmartTag</a></td>
<td style="text-align: left;">客户(联系人)智能标签变动(按用户开放,联系客服开通)</td>
</tr>
</tbody>
</table>
<h2>不同类型下的data结构</h2>
<ul>
<li>聊天消息(chatMsg)<a id="chatMsg"></a></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;">参见“<a href="<a href="https://www.showdoc.com.cn/yunzhenji/11490690012909560">聊天消息数据结构</a>”章节">https://www.showdoc.com.cn/yunzhenji/11490690012909560">聊天消息数据结构</a>”章节</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接口<a href="<a href="https://www.showdoc.com.cn/yunzhenji/11490695962081036">发送消息</a>且带了api_send_id字段,会在此处带回。类型无论发送接口处是整型还是字符串型,此处都为字符串类型">https://www.showdoc.com.cn/yunzhenji/11490695962081036">发送消息</a>且带了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接口<a href="<a href="https://www.showdoc.com.cn/yunzhenji/11490695962081036">发送消息</a>系统会生成自己的发送消息ID:api_send_svrid,会在此处带回。有别于svrid,请不要混淆">https://www.showdoc.com.cn/yunzhenji/11490695962081036">发送消息</a>系统会生成自己的发送消息ID:api_send_svrid,会在此处带回。有别于svrid,请不要混淆</a>。</td>
</tr>
</tbody>
</table>
<ul>
<li>聊天消息撤回 (updateChatMsg)<a id="updateChatMsg"></a></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)<a id="chatMsgSendFail"></a></li>
</ul>
<p>数据示例:</p>
<pre><code>[
{
&quot;corp_wxid&quot;:&quot;xxx&quot;,
&quot;rel_wxid&quot;:&quot;168xxx&quot;,
&quot;type&quot;:&quot;chatMsgSendFail&quot;,
&quot;data&quot;:[
{
&quot;api_send_id&quot;:&quot;xxx&quot;,//调用发消息接口时由用户自定义,发送失败回调时此处原样带回
&quot;api_send_svrid&quot;:&quot;168xxx,7xxx,1675995049713gMWlEj&quot;,//调用发消息接口时由系统自动生成,发送失败回调时此处原样带回
&quot;source&quot;:1,
&quot;errcode&quot;:1,
&quot;message&quot;:&quot;对方还不是你的联系人,请先发送申请验证,对方通过验证后才能聊天。&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,由三部分组成以逗号分隔:【"{发送消息企微号wxid},{接收消息的客户或群wxid},{毫秒时间戳+6位随机字符串}"】 ,如:【"168xxx,7xxx,1675995049713gMWlEj"】</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)<a id="voiceToText"></a></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>[
{
&quot;corp_wxid&quot;:&quot;xxx&quot;,
&quot;rel_wxid&quot;:&quot;168xxx&quot;,
&quot;type&quot;:&quot;voiceToText&quot;,
&quot;data&quot;:[
{
&quot;from_wxid&quot;:&quot;7xxx&quot;,
&quot;to_wxid&quot;:&quot;168xxx&quot;,
&quot;wxid&quot;:&quot;168xxx&quot;,
&quot;chat_wxid&quot;:&quot;7xxx&quot;,
&quot;svrid&quot;:&quot;xxx&quot;,
&quot;msg_hash&quot;:&quot;from_msgid_772634421531187180&quot;,
&quot;wx_svrid&quot;:&quot;2185971&quot;,
&quot;text&quot;:&quot;你好,...&quot;
}
]
}
]</code></pre>
<ul>
<li>好友(联系人)信息(contacts)<a id="contacts"></a></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;">手机号,备注了会有,数组如:[],["136xxxx","137xxxx"]</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)<a id="contactCorps"></a></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)<a id="rooms"></a></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)<a id="roomMembers"></a>
<br><font color="red">注意:数据是分批多次上报上来的,不会一次上报下面所有字段。每次上报了哪些字段,部分更新入库下就行。</font></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,表示初始化全量上报数据; 空字符串表示非初始化,即正常的增量上报;<font color="red">iPad和aPad协议情景下,该字段无意义;</font></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!="init"),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)<a id="tags"></a></li>
</ul>
<p>数据示例:
```[
{
"corp_wxid":"xxx",
"rel_wxid":"xxx",
"type":"tags",
"data":[
{
"is_deleted":0,
"is_group":0,
"parent_wxid":"xxx",
"type":1,
"wx_ctime":1650850244,
"wx_name":"4.23男",
"wx_order":0,
"wxid":"xxx"
},
{
"is_deleted":0,
"is_group":0,
"parent_wxid":"xxx",
"type":1,
"wx_ctime":1650850244,
"wx_name":"4.23女",
"wx_order":0,
"wxid":"xxx"
}
]
}
]</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)&lt;a id=&quot;wechatOnline&quot;&gt;&lt;/a&gt;
数据示例:</code></pre>
<p>[
{
"type":"wechatOnline",
"data":[
{
"id":1646,
"wxid":"xxx",
"nickname":"xxx",
"full_name":"xxx",
"avatar":"http:\/\/wework.qpic.cn\/bizmail\/mIu5Ucn8jMpd02ibP297T2ERCzYFjydpIxsqKibWzCL0NwlU5GIoNTfA\/0",
"mobile":"xxx",
"corp_id":3,
"online":1,
"last_login_time":1646708151,
"last_offline_time":1646210928,
"ctime":1641460958,
"utime":1646708151,
"corp":{
"id":3,
"name":"杭州xx科技有限公司",
"short_name":"xx网络",
"wxid":"xxx",
"remark":"",
"legal_person_name":"xxx",
"legal_person_id":"xxx",
"verify_type":2,
"ctime":1635157724,
"utime":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)&lt;a id=&quot;wechatOffline&quot;&gt;&lt;/a&gt;
|字段|类型|说明|
|:---- |:---|:----- |
|wxid |string|企微号wxid |
|error_code |int|企微号离线错误码 |
|error_msg |string|企微号离线原因 |
- 语音/视频通话(voiceVideoCall)&lt;a id=&quot;voiceVideoCall&quot;&gt;&lt;/a&gt;
|字段|类型|说明|
|:---- |:---|:----- |
|wxid |string|企微号wxid |
|chat_wxid |string|联系人微信id |
|type |int|1视频;2语音 |
|voipid |int|通话id(接受或拒绝时需要该字段) |
|contactid |string|会话ID |
|users |Array|会话双方的wxid |
- 下发任务执行完成(taskDone)&lt;a id=&quot;taskDone&quot;&gt;&lt;/a&gt;
|字段|类型|说明|
|:---- |:---|:----- |
|task_id |int|任务id |
|task_type |string|任务类型 |
|errcode |int|错误代码,0表示无错误 |
|message |string|错误描述,无错误为空 |
|res_data |object|任务执行结果,字段参见查询任务 |
- 企微号扩展信息(wechatExtInfo)&lt;a id=&quot;wechatExtInfo&quot;&gt;&lt;/a&gt;
说明:该事件来自pc客户端上的弹窗信息,企微号登录在iPad平台时没有该事件。
数据示例:</code></pre>
<p>[
{
"corp_wxid":"197xxx",
"rel_wxid":"168xxx",
"type":"wechatExtInfo",
"data":{
"data":{
"action":"{"action":"makeFriendFromMobile","router":{"client":"wechat","wxid":"168xxx","uid":"xxx"},"data":{"mobile":"xxx","content":"你好","flag":1,"extra":{"user_id":"xxx","task_id":"xxx","open_callback_type":0}}}",
"action_time":1699254139,
"text":"添加好友过于频繁,请稍后再重试",
"title":"封禁提示"
},
"type":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 |事件内容,可根据该字段进行账号状态监控,比如监控&quot;添加好友过于频繁&quot;、&quot;向微信好友发消息功能已被限制使用&quot;、&quot;本群涉嫌违法或违规,已被暂停使用&quot;,等可以判断账号当前状态 |
- 客户(联系人)智能标签变动(contactSmartTag)&lt;a id=&quot;contactSmartTag&quot;&gt;&lt;/a&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>