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

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

请求包体:

{
	"userid": "zhangsan",
	"name": "李四",
	"department": [1],
	"order": [10],
	"position": "后台工程师",
	"mobile": "13800000000",
	"gender": "1",
	"email": "zhangsan@gzdev.com",
	"biz_mail":"zhangsan@qyycs2.wecom.work",
	"is_leader_in_dept": [1],
	"direct_leader":["lisi"],
	"enable": 1,
	"avatar_mediaid": "2-G6nrLmr5EC3MNb_-zL1dDdzkd0p7cNliYu9V5w7o8K0",
	"telephone": "020-123456",
	"alias": "jackzhang",
	"address": "广州市海珠区新港中路",
	"main_department": 1,
	"extattr": {
		"attrs": [
			{
				"type": 0,
				"name": "文本名称",
				"text": {
					"value": "文本"
				}
			},
			{
				"type": 1,
				"name": "网页名称",
				"web": {
					"url": "http://www.test.com",
					"title": "标题"
				}
			}
		]
	},
	"external_position": "工程师",
	"external_profile": {
		"external_corp_name": "企业简称",
		"wechat_channels": {
			"nickname": "视频号名称",
		},
		"external_attr": [
			{
				"type": 0,
				"name": "文本名称",
				"text": {
					"value": "文本"
				}
			},
			{
				"type": 1,
				"name": "网页名称",
				"web": {
					"url": "http://www.test.com",
					"title": "标题"
				}
			},
			{
				"type": 2,
				"name": "测试app",
				"miniprogram": {
					"appid": "wx8bd80126147dFAKE",
					"pagepath": "/index",
					"title": "my miniprogram"
				}
			}
		]
	}
}

参数说明:

参数必须说明
access_token调用接口凭证
userid成员UserID。对应管理端的账号,企业内必须唯一。不区分大小写,长度为1~64个字节
name成员名称。长度为1~64个utf8字符
alias别名。长度为1-64个utf8字符
mobile手机号码。企业内必须唯一。若成员已激活企业微信,则需成员自行修改(此情况下该参数被忽略,但不会报错)
department成员所属部门id列表,不超过100个
order部门内的排序值,默认为0。当有传入department时有效。数量必须和department一致,数值越大排序越前面。有效的值范围是[0, 2^32)
position职务信息。长度为0~128个utf8字符
gender性别。1表示男性,2表示女性
email邮箱。长度不超过64个字节,且为有效的email格式。企业内必须唯一。若是绑定了腾讯企业邮箱的企业微信,则需要在腾讯企业邮箱中修改邮箱(此情况下该参数被忽略,但不会报错)
biz_mail企业邮箱。仅对开通企业邮箱的企业有效。长度6~64个字节,且为有效的企业邮箱格式。企业内必须唯一。企业邮箱为系统自动生成的成员可修改一次
telephone座机。由1-32位的纯数字、“-”、“+”或“,”组成
is_leader_in_dept部门负责人字段,个数必须和department一致,表示在所在的部门内是否为负责人。0-否,1-是
direct_leader直属上级,可以设置企业范围内成员为直属上级,最多设置1个
avatar_mediaid成员头像的mediaid,通过素材管理接口上传图片获得的mediaid
enable启用/禁用成员。1表示启用成员,0表示禁用成员
extattr自定义字段。自定义字段需要先在WEB管理端添加,见扩展属性添加方法,否则忽略未知属性的赋值。
extattr.type属性类型: 0-文本 1-网页 2-小程序
extattr.name属性名称: 需要先确保在管理端有创建该属性,否则会忽略
extattr.text文本类型的属性
extattr.text.value文本属性内容,长度限制64个UTF8字符
extattr.web网页类型的属性,url和title字段要么同时为空表示清除该属性,要么同时不为空
extattr.web.url网页的url,必须包含http或者https头
extattr.web.title网页的展示标题,长度限制12个UTF8字符
external_profile成员对外属性,字段详情见对外属性
external_position对外职务,如果设置了该值,则以此作为对外展示的职务,否则以position来展示。不超过12个汉字
nickname视频号名字(设置后,成员将对外展示该视频号)。须从企业绑定到企业微信的视频号中选择,可在“我的企业”页中查看绑定的视频号
address地址。长度最大128个字符
main_department主部门
特别地,如果userid由系统自动生成,则仅允许修改一次。新值可由new_userid字段指定。
如果创建时『企业邮箱』为系统默认分配的,则仅允许修改一次,若创建时填入了合规的『企业邮箱』,则无法修改

 

权限说明:

仅通讯录同步助手或第三方通讯录应用可调用。

注意,每个部门下的部门、成员总数不能超过3万个。

返回结果:

{
   "errcode": 0,
   "errmsg": "updated"
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
上一篇
读取成员
下一篇
删除成员