企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
通讯录管理
成员管理
邀请成员
邀请成员
最后更新:2024/11/04

企业可通过接口批量邀请成员使用企业微信,邀请后将通过短信或邮件下发通知。

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/batch/invite?access_token=ACCESS_TOKEN

请求示例:

{
   "user" : ["UserID1", "UserID2", "UserID3"],
   "party" : [1, 2, 3],
   "tag" : [101, 102, 103]
}

参数说明:

参数是否必须说明
access_token调用接口凭证
user成员ID列表, 最多支持1000个。
party部门ID列表,最多支持100个。
tag标签ID列表,最多支持100个。

权限说明:
须拥有指定成员、部门或标签的查看权限。
第三方仅通讯录应用可调用。

返回示例:

{
  "errcode" : 0,
  "errmsg" : "ok",
  "invaliduser" : ["UserID1", "UserID2"],
  "invalidparty" : [1, 2],
  "invalidtag": [101, 102]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
invaliduser非法成员列表
invalidparty非法部门列表
invalidtag非法标签列表

更多说明:

  • user, party, tag三者不能同时为空;
  • 如果部分接收人无权限或不存在,邀请仍然执行,但会返回无效的部分(即invaliduser或invalidparty或invalidtag);
  • 同一用户只须邀请一次,被邀请的用户如果未安装企业微信,在3天内每天会收到一次通知,最多持续3天。
  • 因为邀请频率是异步检查的,所以调用接口返回成功,并不代表接收者一定能收到邀请消息(可能受上述频率限制无法接收)。
  • 境外成员可用企业录入的邮箱登录企业微信。
上一篇登录二次验证
下一篇获取加入企业二维码
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们