全量覆盖成员

本接口以userid为主键，全量覆盖企业的通讯录成员，任务完成后企业的通讯录成员与提交的文件完全保持一致。请先下载CSV文件(下载全量覆盖成员模版)，根据需求填写文件内容。

注意事项：
模板中的部门需填写部门ID，多个部门用分号分隔，部门ID必须为数字，根部门的部门id默认为1
文件中存在、通讯录中也存在的成员，完全以文件为准
文件中存在、通讯录中不存在的成员，执行添加操作
通讯录中存在、文件中不存在的成员，执行删除操作。出于安全考虑，下面两种情形系统将中止导入并返回相应的错误码。
需要删除的成员多于50人，且多于现有人数的20%以上
需要删除的成员少于50人，且多于现有人数的80%以上
成员字段更新规则：可自行添加扩展字段。文件中有指定的字段，以指定的字段值为准；文件中没指定的字段，不更新

权限说明：须拥有通讯录的写权限

文档ID: 15015
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90981
https://open.work.weixin.qq.com/api/doc/90001/90143/91131
https://open.work.weixin.qq.com/api/doc/90002/90151/91164

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/batch/replaceuser?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{"media_id":"xxxxxx","to_invite":true,"callback":{"url":"xxx","token":"xxx","encodingaeskey":"xxx"}}'

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

media_id

string

必需

上传的csv文件的media_id

to_invite

boolean

必需

是否邀请新建的成员使用企业微信（将通过微信服务通知或短信或邮件下发邀请，每天自动下发一次，最多持续3个工作日），默认值为true。

callback

object

可选

回调信息。如填写该项则任务完成后，通过callback推送事件给企业。具体请参考应用回调模式中的相应选项

url

string

可选

企业应用接收企业微信推送请求的访问协议和地址，支持http或https协议

token

string

用于生成签名

可选

encodingaeskey

string

可选

用于消息体的加密，是AES密钥的Base64编码

示例

application/json

Body

errcode

integer <int32>

返回码

可选

jobid

string

可选

异步任务id，最大长度为64字节

errmsg

string

可选

对返回码的文本描述内容

请求参数

返回响应