第三方应用开发 服务端API 通讯录管理 成员管理 邀请成员
邀请成员
最后更新:2022/01/14
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
邀请成员
最后更新:2022/01/14

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

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

请求示例:

{
   "user" : ["UserID1", "UserID2", "UserID3"],
   "party" : [PartyID1, PartyID2],
   "tag" : [TagID1, TagID2]
}

参数说明:

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

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

返回示例:

{
  "errcode" : 0,
  "errmsg" : "ok",
  "invaliduser" : ["UserID1", "UserID2"],
  "invalidparty" : [PartyID1, PartyID2],
  "invalidtag": [TagID1, TagID2]
}

参数说明:

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

更多说明:

  • user, party, tag三者不能同时为空;
  • 如果部分接收人无权限或不存在,邀请仍然执行,但会返回无效的部分(即invaliduser或invalidparty或invalidtag);
  • 同一用户只须邀请一次,被邀请的用户如果未安装企业微信,在3天内每天会收到一次通知,最多持续3天。
  • 因为邀请频率是异步检查的,所以调用接口返回成功,并不代表接收者一定能收到邀请消息(可能受上述频率限制无法接收)。
上一篇
userid与openid互换
下一篇
手机号获取userid