企业内部开发 服务端API 上下游 上下游通讯录管理 批量导入上下游联系人
批量导入上下游联系人

1、企业负责人指老板、法人、IT 管理员或主要对接人;单企业最多填写 5 人,也可以不填;
2、上下游企业名称请填写完整、准确;
3、支持国内、国际手机号(国内手机号直接输入手机号即可;国际手机号必须包含加号以及国家地区码,格式示例:“+85259****4”);
4、表格中填写的企业负责人/成员会在企业微信、微信上收到邀请,确认后即可加入当前上下游;
5、若上下游企业未创建,需任一企业负责人查收微信服务通知,点击激活企业后,成员才会收到邀请;
6、单次导入的企业总数不得超过1000个,导入的企业数加上下游空间的企业数不能超过上下游空间的企业限制;
7、单个企业导入人数不得超过200人;
8、单次最多能导入2000人;
9、每天最多能导入20000人
10、只允许串行调用

 

提交批量导入上下游联系人任务

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

请求包体:

{
	"chain_id":"xxxxxx",
	"contact_list":[
		{
			"corp_name":"飞飞培训学校",
			"group_path":"华北区/北京市/海淀区",
			"custom_id":"wof3du51quo5sl1is",
			"contact_info_list":[
				{
					"name":"张三",
					"identity_type":1,
					"mobile":"13000000001"
				},
				{
					"name":"李四",
					"identity_type":2,
					"mobile":"13000000001"
				}
			]
		}
	]
}

参数说明:

参数必须说明
chain_id上下游id。文件中的联系人将会被导入此上下游中
contact_list上下游联系人列表。这些联系人将会被导入此上下游中
contact_list.corp_name上下游企业名称。长度为1-32个utf8字符。只能由中文、字母、数字和“ -_()()”六种字符组成
contact_list.group_path导入后企业所在分组。分组为空的企业会放在根分组下。仅针对新导入企业生效,不会修改已导入企业的分组。
contact_list.custom_id上下游企业自定义 id。长度为0~64 个字节,只能由数字和字母组成
contact_list.contact_info_list上下游联系人信息列表
contact_list.contact_info_list.name上下游联系人姓名。长度为1~32个utf8字符
contact_list.contact_info_list.identity_type联系人身份类型。1:成员,2:负责人。
contact_list.contact_info_list.mobile手机号。支持国内、国际手机号(国内手机号直接输入手机号即可,格式示例:“138****0001”;国际手机号必须包含加号以及国家地区码,格式示例:“+85259****45”

 

权限说明:

  • 仅已验证的企业可调用
  • 仅上下游系统应用可调用

 

导入任务限制:
同时只能存在一个导入任务。导入任务包括通过API提交的任务和从管理后台提交的导入任务。

 

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"jobid": "xxxxx"
}
可使用jobid通过获取异步任务结果接口查询任务执行状态及结果
当开启了上下游应用回调通知后,任务运行完成时会推送异步任务完成通知

参数说明 :

参数说明
errcode返回码
errmsg对返回码的文本描述内容
jobid异步任务id,最大长度为64字节
上一篇
获取上下游信息
下一篇
获取异步任务结果