邀请成员

POST

/cgi-bin/batch/invite

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

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

更多说明：
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 参数

Body 参数application/json

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/cgi-bin/batch/invite?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{"user":["UserID1","UserID2","UserID3"],"party":[PartyID1,PartyID2],"tag":[TagID1,TagID2]}'

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2025-03-26 09:11:31

二次验证

手机号获取userid