创建发表任务

企业和第三方应用可通过该接口创建客户朋友圈的发表任务。

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

请求示例：

{
	"text": {
		"content": "文本消息内容"
	},
	"attachments": [
		{
			"msgtype": "image",
			"image": {
				"media_id": "MEDIA_ID"
			}
		},
		{
			"msgtype": "video",
			"video": {
				"media_id": "MEDIA_ID"
			}
		},
		{
			"msgtype": "link",
			"link": {
				"title": "消息标题",
				"url": "https://example.link.com/path",
				"media_id": "MEDIA_ID"
			}
		}
	],
 	"visible_range":{
		"sender_list":{
			"user_list":["zhangshan","lisi"],
			"department_list":[2,3]
		},
		"external_contact_list":{
			"tag_list":[ "etXXXXXXXXXX", "etYYYYYYYYYY"]
		}
	}
}

参数说明：

可见范围说明

visible_range，分以下几种情况：

1. 若只指定sender_list，则可见的客户范围为该部分执行者的客户，目前执行者支持传userid与部门id列表，注意不在应用可见范围内的执行者会被忽略。
   
   
2. 若只指定external_contact_list，即指定了可见该朋友圈的目标客户（通过客户标签指定），此时会将该发表任务推给这些目标客户的应用可见范围内的跟进人。
   
   
3. 若同时指定sender_list以及external_contact_list，会将该发表任务推送给同时满足以下条件的执行者：
   （1）在sender_list中且在应用可见范围内的执行者；
   （2）执行者有客户在external_contact_list当中。
   执行者发表后仅external_contact_list指定的客户可见。
   
   
4. 若未指定visible_range，则可见客户的范围为该应用可见范围内执行者的客户，执行者为应用可见范围内所有成员。

注：若指定external_contact_list列表，则该条朋友圈为部分可见；否则为公开

权限说明：

• 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。
• 自建应用调用，只会返回应用可见范围内用户的发送情况。
• 第三方应用或代开发自建应用调用需要企业授权客户朋友圈下发表到成员客户的朋友圈的权限
• 企业每分钟创建朋友圈的频率：10条/分钟
• 企业每个月允许通过api创建的朋友圈次数限制：10万

返回结果：

{
	"errcode":0,
	"errmsg":"ok",
	"jobid":"xxxx"
}

参数说明：

获取任务创建结果

由于发表任务的创建是异步执行的，应用需要再调用该接口以获取创建的结果。
请求方式：GET（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_task_result?access_token=ACCESS_TOKEN&jobid=JOBID

参数说明：

权限说明：

只能查询已经提交过的历史任务。

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "status": 1,
    "type": "add_moment_task",
	"result": {
		"errcode":0,
		"errmsg":"ok",
		"moment_id":"xxxx",
		"invalid_sender_list":{
			"user_list":["zhangshan","lisi"],
			"department_list":[2,3]
		},
		"invalid_external_contact_list":{
			"tag_list":["xxx"]
		}
	}
}

参数说明：