企业微信应用开发中, 重要的的地方就在于可以可以管理企业微信中的成员信息, 同步成员信息,也可以进行成员的管理。
本系列,主要说下成员管理中用到的操作,跟各操作的用法。
一、 创建成员
二、 读取成员
三、 更新成员
四、 删除成员
五、 批量删除成员
六、 获取部门成员
七、 获取部门成员详情
八、 邀请成员
企业可通过接口批量邀请成员使用企业微信,邀请后将通过短信或邮件下发通知。
邀请成员
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/batch/invite?access_token=ACCESS_TOKEN
POST请求参数示例:
[C#] 纯文本查看 复制代码
{
"user" : ["UserID1", "UserID2", "UserID3"],
"party" : [PartyID1, PartyID2],
"tag" : [TagID1, TagID2]
}
请求参数说明:
[C#] 纯文本查看 复制代码
参数 是否必须 说明
1. access_token 是 调用接口凭证
2. user 否 成员ID列表, 最多支持1000个。
3. party 否 部门ID列表,最多支持100个。
4. tag 否 标签ID列表,最多支持100个。
返回结果实例:
[C#] 纯文本查看 复制代码
{
"errcode" : 0,
"errmsg" : "ok",
"invaliduser" : ["UserID1", "UserID2"],
"invalidparty" : [PartyID1, PartyID2],
"invalidtag": [TagID1, TagID2]
}
返回参数说明:
[C#] 纯文本查看 复制代码
参数 说明
1. errcode 返回码
2. errmsg 对返回码的文本描述内容
3. invaliduser 非法成员列表
4. invalidparty 非法部门列表
5. invalidtag 非法标签列表
备注:
user, party, tag三者不能同时为空; 如果部分接收人无权限或不存在,邀请仍然执行,但会返回无效的部分(即invaliduser或invalidparty或invalidtag); 同一用户只须邀请一次,被邀请的用户如果未安装企业微信,在3天内每天会收到一次通知,最多持续3天。 因为邀请频率是异步检查的,所以调用接口返回成功,并不代表接收者一定能收到邀请消息(可能受上述频率限制无法接收)。
[size=14.6667px]
权限说明:
须拥有指定成员、部门或标签的查看权限。
|