邀请成员 - Developer OpenAPI

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

权限说明：
须拥有指定成员、部门或标签的查看权限。

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

文档ID: 12543
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90975
https://open.work.weixin.qq.com/api/doc/90001/90143/91127
https://open.work.weixin.qq.com/api/doc/90002/90151/91159

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

access_token

array[string]

调用接口凭证

必需

tag

array[string]

可选

标签ID列表，最多支持100个。

user

array[string]

可选

成员ID列表, 最多支持1000个。

party

array[string]

可选

部门ID列表，最多支持100个。

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

对返回码的文本描述内容

invaliduser

array[string]

非法成员列表

必需

invalidparty

array[string]

非法部门列表

必需

invalidtag

array[string]

非法标签列表

必需

示例

{
  "errcode": 0,
  "errmsg": "string",
  "invaliduser": [
    "string"
  ],
  "invalidparty": [
    "string"
  ],
  "invalidtag": [
    "string"
  ]
}