下发指令
<h2>简要描述</h2>
<p>下发指令可以完成：
1、建群；
2、增删群成员；
3、修改群名；
4、群转让；
5、获取群二维码；
6、增删好友；
7、禁改群名；
8、搜索通讯录成员；
9、增删管理员；
10、修改联系人（好友）标签；
11、获取企微号登录二维码；
12、发朋友圈（一个客户每天最多可见次数是3次）；
13、删除朋友圈；
14、修改联系人（好友）备注；
15、修改联系人（好友）描述；
16、添加名片上的人为好友；
17、评论朋友圈；
18、修改联系人（好友）信息；
19、设置群聊邀请是否需要确认(需要企微号是群主或管理员)；
20、修改企微号自己在群里的群昵称；
21、添加群聊里的人为好友；
22、保存或移除群聊到通讯录；
<font color='red'> 需要注意：1、在收到指令并经过初步校验后，会创建任务并开始异步执行，该接口同步返回创建的任务ID。2、任务状态已完成，仅当任务类型属于（建群、获取群二维码、加好友、搜索通讯录成员、获取企微号登陆二维码、发朋友圈）时表示发送成功，其他类型都仅代表已下发指令，不保证执行成功，是否成功需要依赖下面第二条路径根据具体事件进行判断。如：邀请群成员指令是否成功，可依赖是否有相应的群成员入群事件推送判断是否邀请成功。</font>
用户有三条路径获取任务执行结果：
1、主动调用[<a href="<a href="https://www.showdoc.com.cn/yunzhenji/11490699102215489">查询指令执行结果</a>]接口查询">https://www.showdoc.com.cn/yunzhenji/11490699102215489">查询指令执行结果</a>]接口查询</a>；
2、执行完相应指令后，当有相应的事件发生时，会触发相关<a href="<a href="https://www.showdoc.com.cn/yunzhenji/11490693160849765">数据回调</a>（如增删群成员指令下发后，会触发群成员数据推送">https://www.showdoc.com.cn/yunzhenji/11490693160849765">数据回调</a>（如增删群成员指令下发后，会触发群成员数据推送</a>）；
3、除了以上两种方式，部分异步执行的任务（建群、获取群二维码、加好友、搜索通讯录成员、获取企微号登陆二维码、发朋友圈）在执行完毕后，也会以“任务完成（taskDone）”作为回调类型把执行结果推送到已设置的回调地址，详见[<a href="<a href="https://www.showdoc.com.cn/yunzhenji/11490693160849765">数据回调</a>">https://www.showdoc.com.cn/yunzhenji/11490693160849765">数据回调</a></a>;]。</p>
<h2>请求URL</h2>
<ul>
<li><code>URL:/wechat/pushTask</code></li>
</ul>
<h2>请求方式</h2>
<ul>
<li>POST </li>
</ul>
<h2>请求数据结构</h2>
<pre><code>{
&quot;app_id&quot;:&quot;xxxx&quot;,
&quot;access_token&quot;:&quot;xxxx&quot;,
&quot;task_type&quot;:&quot;xxxx&quot;,
&quot;data&quot;:{},
&quot;delayed_time&quot;:&quot;时间戳(秒)，如需下发定时指令，可传该参数；否则不传或传0；如：传1645083311 表示指令从2022-02-17 15:35:11开始执行&quot;
}</code></pre>
<h2>请求示例</h2>
<pre><code>POST /wechat/pushTask HTTP/1.1
Host:oapi-yzj.miaokol.com
Content-Type: application/json; charset=UTF-8
{
&quot;app_id&quot;:&quot;xxx&quot;,
&quot;access_token&quot;:&quot;xxx&quot;,
&quot;task_type&quot;:&quot;newGroup&quot;,
&quot;data&quot;:{
&quot;wxid&quot;:&quot;xxxx&quot;,
&quot;room_name&quot;:&quot;群名称&quot;,
&quot;member_wxids&quot;:[
&quot;xxx1&quot;,
&quot;xxx2&quot;
]
}
}
</code></pre>
<h2>响应示例</h2>
<pre><code>HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
&quot;data&quot;:{
&quot;task_id&quot;:&quot;1&quot;
},
&quot;errcode&quot;:0
}
</code></pre>
<ul>
<li>task_type 任务类型，具体类型如下：</li>
</ul>
<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="#newGroup">newGroup</a></td>
<td style="text-align: left;">建群</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#groupMemberAdd">groupMemberAdd</a></td>
<td style="text-align: left;">添加群成员</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#groupMemberDel">groupMemberDel</a></td>
<td style="text-align: left;">删除群成员</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#groupRename">groupRename</a></td>
<td style="text-align: left;">修改群名</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#groupTransfer">groupTransfer</a></td>
<td style="text-align: left;">群转让（企微号须是群主）</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#roomQrcode">roomQrcode</a></td>
<td style="text-align: left;">获取群二维码</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#contactAdd">contactAdd</a></td>
<td style="text-align: left;">添加联系人</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#contactDel">contactDel</a></td>
<td style="text-align: left;">删除联系人</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#disableModifyRoomName">disableModifyRoomName</a></td>
<td style="text-align: left;">禁改群名（企微号须是群主或群管理）</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#searchUser">searchUser</a></td>
<td style="text-align: left;">搜索通讯录成员（注意：搜索结果中包含企微号所在企业的内部员工，也包含其他企微好友、个微好友。如需本企业员工请根据corp_wxid对搜索结果进行过滤。）</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#addChatroomAdmin">addChatroomAdmin</a></td>
<td style="text-align: left;">添加群管理（企微号须是群主）</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#removeChatroomAdmin">removeChatroomAdmin</a></td>
<td style="text-align: left;">删除群管理（企微号须是群主）</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#changeFanLabel">changeFanLabel</a></td>
<td style="text-align: left;">修改联系人（好友）标签</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#getQrcode">getQrcode</a></td>
<td style="text-align: left;">获取企微号登录二维码</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#createMoment">createMoment</a></td>
<td style="text-align: left;">发朋友圈（一个客户每天最多可见次数是3次）</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#deleteMoment">deleteMoment</a></td>
<td style="text-align: left;">删除朋友圈</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#commentMoment">commentMoment</a></td>
<td style="text-align: left;">评论朋友圈</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#changeFanRemark">changeFanRemark</a></td>
<td style="text-align: left;">修改联系人（好友）备注</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#changeFanDesc">changeFanDesc</a></td>
<td style="text-align: left;">修改联系人（好友）描述</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#changeFanInfo">changeFanInfo</a></td>
<td style="text-align: left;">修改联系人（好友）信息</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#makeFriendFromCard">makeFriendFromCard</a></td>
<td style="text-align: left;">添加名片上的人为好友</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#enableInviteConfirm">enableInviteConfirm</a></td>
<td style="text-align: left;">设置群聊邀请是否需要确认(需要企微号是群主或管理员)</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#setChatroomMemberNickname">setChatroomMemberNickname</a></td>
<td style="text-align: left;">修改企微号自己在群里的群昵称</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#makeFriendFromRoom">makeFriendFromRoom</a></td>
<td style="text-align: left;">添加群聊里的人为好友</td>
</tr>
<tr>
<td style="text-align: left;"><a href="#saveChatroomToContact">saveChatroomToContact</a></td>
<td style="text-align: left;">保存或移除群聊到通讯录</td>
</tr>
</tbody>
</table>
<ul>
<li>不同类型下的data数据结构
<a id="newGroup"></a></li>
<li>
<h2>建群（newGroup）</h2>
</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;">wxid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>企微号wxid</td>
</tr>
<tr>
<td style="text-align: left;">room_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>新建群名称</td>
</tr>
<tr>
<td style="text-align: left;">member_wxids</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">array</td>
<td>建群同时拉人进群，拉人进群的成员wxid数组或不拉人传空数组，不要超过40人，太多的话企微那边执行失败几率会高。</td>
</tr>
<tr>
<td style="text-align: left;">has_external</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>member_wxids中包含外部联系人传1，都是内部员工或为空时传0；默认为0</td>
</tr>
</tbody>
</table>
<p><a id="groupMemberAdd"></a></p>
<ul>
<li>
<h2>添加群成员（groupMemberAdd）</h2>
</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;">wxid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>企微号wxid</td>
</tr>
<tr>
<td style="text-align: left;">room_wxid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>群wxid</td>
</tr>
<tr>
<td style="text-align: left;">member_wxids</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>添加成员的wxid（必须是字符串）</td>
</tr>
<tr>
<td style="text-align: left;">history_messages</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">array</td>
<td>邀请入群并附带聊天记录(仅登录apad/ipad平台支持)，数据格式见下方</td>
</tr>
</tbody>
</table>
<p><font color="red"><strong>注意：history_messages里的内容要使用2天内的聊天记录，且最多不超过30条，否则容易出错;</strong></font>
history_messages结构：</p>
<table>
<thead>
<tr>
<th style="text-align: left;"></th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">msg_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>消息类型；<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;">content</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>消息内容，原封不动使用聊天记录里的内容</td>
</tr>
<tr>
<td style="text-align: left;">corp_wxid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>消息发送人归属的企业ID，个微就固定写死：1970325134026788</td>
</tr>
<tr>
<td style="text-align: left;">from_name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>发送人昵称</td>
</tr>
<tr>
<td style="text-align: left;">from_wxid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>发送人wxid</td>
</tr>
<tr>
<td style="text-align: left;">msg_time</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>消息发送时间</td>
</tr>
</tbody>
</table>
<p>history_messages结构示例如下：</p>
<pre><code>[
{
&quot;msg_type&quot;: &quot;text&quot;
&quot;content&quot;: {//消息内容，原封不动使用聊天记录里的内容
&quot;items&quot;: [
{
&quot;type&quot;: &quot;text&quot;,
&quot;text&quot;: &quot;22222&quot;
}
]
},
&quot;corp_wxid&quot;: &quot;1970325134026788&quot;,
&quot;from_name&quot;: &quot;xxx&quot;,
&quot;from_wxid&quot;: &quot;xxx&quot;,
&quot;msg_time&quot;: &quot;1724664989&quot;//该条消息的发送时间，直接使用聊天记录里的msg_time
},
{
&quot;msg_type&quot;: &quot;picture&quot;,
&quot;content&quot;: {//消息内容，原封不动使用聊天记录里的内容，字段要完整带上；
&quot;height&quot;: 2560,
&quot;width&quot;: 1920,
&quot;size&quot;: 175272,
&quot;org_content&quot;: {
&quot;file_type&quot;: 2,
&quot;hash&quot;: &quot;eec7dda5c153722e1e3a0f2c8bf6bfb0&quot;,
&quot;key&quot;: &quot;&quot;,
&quot;md5&quot;: &quot;7173a858c310c28cde652bcfc3e90e95&quot;,
&quot;raw_type&quot;: 14,
&quot;wxurl&quot;: &quot;306902010204623060020100020477f8a9c402030f42410204bf795875020466cc4ca4042430653936356530322d616361302d343734612d396237632d366134313066613334636361020100020302acb004107173a858c310c28cde652bcfc3e90e950201020201000400&quot;
},
&quot;url&quot;: &quot;//yunzhenji.oss-cn-hangzhou.aliyuncs.com/public/wechatdata/7/21/chatroom/20240826/1688851873049028/pic/7173a858c310c28cde652bcfc3e90e95.jpg&quot;
},
&quot;corp_wxid&quot;: &quot;xxx&quot;,
&quot;from_name&quot;: &quot;xxx&quot;,
&quot;from_wxid&quot;: &quot;xxx&quot;,
&quot;msg_time&quot;: &quot;1724664997&quot;
}
]</code></pre>
<p><a id="groupMemberDel"></a></p>
<ul>
<li>
<h2>删除群成员[groupMemberDel]</h2>
</li>
</ul>
<p>|参数名|必选|类型|说明|```</p>
<pre><code>|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
|member_wxids |是 |array | 删除成员的wxid（必须是字符串） |
&lt;a id=&quot;groupRename&quot;&gt;&lt;/a&gt;
- ## 修改群名（groupRename）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
|room_name |是 |string | 新群名称 |
&lt;a id=&quot;groupTransfer&quot;&gt;&lt;/a&gt;
- ## 群转让（groupTransfer）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 群主wxid(需保证群主企微号在系统登录) |
|room_wxid |是 |string | 群wxid |
|new_owner_wxid |是 |string | 新群主wxid |
&lt;a id=&quot;roomQrcode&quot;&gt;&lt;/a&gt;
- ## 获取群二维码（roomQrcode）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
&lt;a id=&quot;contactAdd&quot;&gt;&lt;/a&gt;
- ## 添加联系人（contactAdd）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|content |是 |string | 打招呼信息，文本 |
|mobile |是 |string | 手机号，或者使用企微官方API生成的【&lt;a href=&quot;https://developer.work.weixin.qq.com/document/16997&quot;&gt;手机号对应的随机串】&lt;/a&gt; |
|flag |否 |int | 1:仅加对方个微号;2:仅加对方企微号;3:同时加对方个微号和企微号，默认1 |
&lt;a id=&quot;contactDel&quot;&gt;&lt;/a&gt;
- ## 删除联系人（contactDel）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|contact_wxid |是 |string | 联系人wxid |
|corp_wxid |是 |string | 联系人所在企业wxid，个微传空字符串 |
&lt;a id=&quot;disableModifyRoomName&quot;&gt;&lt;/a&gt;
- ## 禁改群名（disableModifyRoomName）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid[必须是群主] |
|room_wxid |是 |string | 群wxid |
|disable |是 |int | 是否禁改群名，0否1是； |
&lt;a id=&quot;searchUser&quot;&gt;&lt;/a&gt;
- ## 搜索企微号的通讯录成员（searchUser）
- 注意：搜索结果中包含企微号所在企业的内部员工，也包含其他企微好友、个微好友。如需本企业员工请根据corp_wxid对搜索结果进行过滤。
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|text |是 |string | 同企业内部员工名称关键词 |
&lt;a id=&quot;addChatroomAdmin&quot;&gt;&lt;/a&gt;
- ## 添加群管理（addChatroomAdmin）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
|admin_list |是 |array | 管理员wxid，string数组[] |
&lt;a id=&quot;removeChatroomAdmin&quot;&gt;&lt;/a&gt;
- ## 删除群管理（removeChatroomAdmin）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
|admin_list |是 |array | 管理员wxid，string数组[] |
&lt;a id=&quot;changeFanLabel&quot;&gt;&lt;/a&gt;
- ## 修改好友标签（changeFanLabel）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|contact_wxid |是 |string | 联系人wxid |
|corp_tag_wxids |是 |string | 企业标签wxid，多个以英文逗号分隔，如：&quot;14073752039745680,14073752039744955&quot;。&lt;br/&gt;&lt;font color=&quot;red&quot;&gt;注意事项：&lt;/font&gt;&lt;br/&gt;1、通过&lt;a href=&quot;https://www.showdoc.com.cn/yunzhenji/11490707274505770&quot;&gt;标签接口&lt;/a&gt;查询某企业下所有标签；&lt;br/&gt;2、该字段是覆盖更新：所以要删除所有标签就传空字符；要新增标签需要带上该联系人之前已有的标签wxid，组合后传参；要修改标签则直接传所需要的所有标签组合； |
&lt;a id=&quot;getQrcode&quot;&gt;&lt;/a&gt;
- ## 获取企微号登录二维码（getQrcode）
- &lt;font color=&quot;red&quot;&gt;注意：近期，企微微信更新了客户端登录机制，扫码后需要输入验证码才能登录了。通过API获取的企微号登录二维码，手机端扫码后跳出来的验证码，需要通过调用校验验证码接口进行校验。点击跳转至&lt;a href=&quot;https://www.showdoc.com.cn/1702411877508139/10490943302006009&quot;&gt;验证码校验接口&lt;/a&gt;&lt;/font&gt;
- 回调返回的二维码字段qrcode_base64是图片内容的base64格式,显示时，在返回的内容前添加&quot;data:image/jpeg;base64,&quot; 即可直接显示。如: ```&lt;img src=&quot;data:image/jpeg;base64,...&quot;&gt;```
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|sub_user_id |是 |int | 登录到的子账号ID，到主账号传0即可，可通过&lt;a href=&quot;https://www.showdoc.com.cn/yunzhenji/11490711586735262&quot;&gt;子账号列表&lt;/a&gt;获取 |
|group_id |是 |int | 登录到的企微号分组ID，到未分组传0即可，可通过&lt;a href=&quot;https://www.showdoc.com.cn/yunzhenji/11490712130071370&quot;&gt;企微号分组列表&lt;/a&gt;获取 |
|login_wxid|否|string|支持带上要登录的企微号wxid，带了该参数会有以下几种情况：1、该企微号在系统平台登录过且可以直接登录无需扫码，则此次请求会直接登录不再异步返回登录二维码；2、未登录过或登录失败，则同步返回此次任务ID。同时异步返回绑定了该企微号的登录二维码，只有使用该企微号扫码才可正常登录，使用其他企微号扫码无效。|
|os |否 |string | 登录到的服务器系统，AndroidPad传&quot;apad&quot;，ipad传&quot;ipad&quot;，Mac传&quot;mac&quot;，默认不传或传空字符串表示Windows |
&lt;a id=&quot;createMoment&quot;&gt;&lt;/a&gt;
- ## 发朋友圈（createMoment）（一个客户每天最多可见次数是3次）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|moment |是 |object | 朋友圈内容，格式见下面 |
|visible_range |否 |object | 可见范围，格式见下面 |
moment，结构如下：</code></pre>
<p>{
text: "", //文本内容</p>
<pre><code> //以下字段优先级：image &gt; video &gt; link &gt; channels
image: [&#039;img_url1&#039;, &#039;img_url2&#039;], //图片，最多9张。每张图片大小不超过1M。
video: {
url: &#039;video_url&#039;, //视频文件地址，mp4格式，30秒内，大小不超过10M，
},
link:{
title:&#039;链接标题&#039;,
url:&#039;链接地址&#039;,
cover:&#039;封面地址&#039;
},
channels:{ //视频号内容，需要从素材库选择，字段和消息channels的content字段保持一致。
url:&#039;&#039;,
title:&#039;&#039;,
desc:&#039;&#039;,
avatar:&#039;&#039;,
cover:&#039;&#039;,
org_content:{}
}</code></pre>
<p>}</p>
<pre><code>visible_range，结构如下：</code></pre>
<p>//以下字段设置可见范围（user_list + tag_list）， 如果没有visible_range字段，认为是全部可见。
{
user_list:['',''], //wxid 列表
tag_list:['', ''], //标签id列表
}</p>
<pre><code>- ## 请求示例
</code></pre>
<p>POST /wechat/pushTask HTTP/1.1
Content-Type: application/json; charset=UTF-8
{
"app_id":"xxxxx",
"access_token":"xxxxxxxxx",
"data":{
"wxid":"1688851873xxxxx",
"moment":{
"text":"第2条",
"image":[
"<a href="https://yunzhenji.oss-cn-hangzhou.aliyuncs.com/u/21/20220725/0590ba63908fc052b823c25386c6004f.jpg"">https://yunzhenji.oss-cn-hangzhou.aliyuncs.com/u/21/20220725/0590ba63908fc052b823c25386c6004f.jpg"</a>;,
"<a href="https://yunzhenji.oss-cn-hangzhou.aliyuncs.com/u/21/20220725/0590ba63908fc052b823c25386c6004f.jpg"">https://yunzhenji.oss-cn-hangzhou.aliyuncs.com/u/21/20220725/0590ba63908fc052b823c25386c6004f.jpg"</a>;
]
},
"visible_range":{
"user_list":[
"客户wxidxxxx1",
"客户wxidxxx2"
]
}
},
"task_type":"createMoment"
}</p>
<pre><code>
&lt;a id=&quot;commentMoment&quot;&gt;&lt;/a&gt;
- ## 评论朋友圈（commentMoment）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|task_id |是 |string | 发朋友圈返回的task_id |
|text |是 |string | 评论的内容文本 |
&lt;a id=&quot;deleteMoment&quot;&gt;&lt;/a&gt;
- ## 删除朋友圈（deleteMoment）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|task_id |是 |string | 发朋友圈返回的task_id |
&lt;a id=&quot;changeFanRemark&quot;&gt;&lt;/a&gt;
- ## 修改联系人（好友）备注（changeFanRemark）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|contact_wxid |是 |string | 联系人wxid |
|remark |是 |string | 文本，备注内容 |
&lt;a id=&quot;changeFanDesc&quot;&gt;&lt;/a&gt;
- ## 修改联系人（好友）描述（changeFanDesc）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|contact_wxid |是 |string | 联系人wxid |
|desc |是 |string | 文本，描述内容 |
&lt;a id=&quot;changeFanInfo&quot;&gt;&lt;/a&gt;
- ## 修改联系人（好友）信息（changeFanInfo）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|contact_wxid |是 |string | 联系人wxid |
|desc |是 |string | 文本，描述内容 |
|remark |是 |string | 备注|
|corp_name |是 |string | 公司名称|
|phone_list |是 |string[] | 电话，[&quot;xxx1&quot;,&quot;xxx2&quot;]|
&lt;a id=&quot;makeFriendFromCard&quot;&gt;&lt;/a&gt;
- ## 添加名片上的人为好友（名片来自其他人发给企微号）（makeFriendFromCard）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|card_wxid |是 |string | 名片wxid（来自聊天名片消息） |
|sender_wxid |是 |string | 发送名片的人的wxid（来自聊天名片消息） |
|verify_message |是 |string | 验证消息 |
&lt;a id=&quot;enableInviteConfirm&quot;&gt;&lt;/a&gt;
- ## 设置群聊邀请是否需要确认(需要企微号是群主或管理员) （enableInviteConfirm）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
|enable |是 |int | 是否开启需要确认：1 是；0 否； |
&lt;a id=&quot;setChatroomMemberNickname&quot;&gt;&lt;/a&gt;
- ## 修改企微号自己在群里的群昵称（setChatroomMemberNickname）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
|nickname |是 |string | 企微号在群里的昵称 |
&lt;a id=&quot;makeFriendFromRoom&quot;&gt;&lt;/a&gt;
- ## 添加群聊里的人为好友（企微号需要在群里）（makeFriendFromRoom）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
|member_wxid |是 |string | 群成员wxid |
|corp_wxid |是 |string | 群成员所属企业wxid（从群成员列表或群成员回调信息里获取corp_wxid） |
|content |是 |string | 验证消息 |
&lt;a id=&quot;saveChatroomToContact&quot;&gt;&lt;/a&gt;
- ## 保存或移除群聊到通讯录（saveChatroomToContact）
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|wxid |是 |string | 企微号wxid |
|room_wxid |是 |string | 群wxid |
|save |是 |int | 保存: 1; 移除:0; |</code></pre>