# 创建朋友圈任务
请求方式: POST
请求地址: https://nbd-api.myscrm.cn/bff-nbd-qw-openapi/v1/job/add
请求参数说明:
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
app_id | string | 是 | 企微中台应用 id |
send_type | int32 | 是 | 发送方式:1-立即发送,2-定时发送 |
send_schedule_time | string | 是 | 定时发送时间(不能小于当前时间) |
creator_id | string | 是 | 创建人ID |
creator_name | string | 是 | 创建人名称 |
task_name | string | 是 | 任务名称 |
customer_filter_type | int32 | 是 | 客户筛选类型:1-按条件筛选,2-全部客户 |
qw_external_userids | string[] | 是 | 企微外部联系人id列表 |
create_source | int32 | 否 | 创建来源:1-企业创建,2-个人创建 |
creator_type | int32 | 否 | 创建人类型:1-后台登录用户id,2-企微成员id |
members | array | 是 | 成员列表 |
members.qw_user_id | string | 是 | 企微成员id |
members.qw_user_name | string | 是 | 企微成员名称 |
qw_tag_ids | string[] | 否 | 朋友圈可见客户标签-空时所有客户满足 |
organ_proj_list | array | 是 | 项目列表 |
organ_proj_list.organ_proj_id | string | 是 | 关联项目id |
organ_proj_list.organ_proj_name | string | 是 | 关联项目名称 |
attachments | array | 是 | 素材列表 |
attachments.type | int32 | 是 | 素材类型:1-图片,3-H5,4-视频,7-文本 |
attachments.text_content | string | 是 | 文本 |
attachments.img_url | string | 是 | 图片URL |
attachments.img_thumbnail_url | string | 是 | 图片缩略图 |
attachments.h5_href | string | 是 | h5链接 |
attachments.h5_title | string | 是 | h5标题 |
attachments.h5_description | string | 是 | h5描述 |
attachments.cover_url | string | 是 | 封面(H5、视频有封面) |
attachments.cover_thumbnail_url | string | 是 | 封面缩略图 |
attachments.video_url | string | 是 | 视频url |
attachments.ewmp_material_id | string | 是 | 中台素材id(如果是中台素材时必填) |
attachments.img_oss_path | string | 是 | 图片oss-path |
attachments.cover_oss_path | string | 是 | 封面oss-path |
attachments.video_oss_path | string | 是 | 视频oss-path |
custom_condition | array | 否 | 自定义筛选群发客户条件 |
custom_condition.code | string | 否 | 条件编码 |
custom_condition.values | string | 否 | 条件值,多个逗号分割 |
请求参数示例:
{
"app_id": "xxx-xxx",
"send_type": 1,
"send_schedule_time": "string",
"creator_id": "xxxx",
"creator_name": "xxx",
"create_source": 1,
"creator_type": 1,
"members": [
{
"qw_user_id": "xxxx",
"qw_user_name": "xxx"
}
],
"qw_tag_ids": [
"xxx"
],
"organ_proj_list": [
{
"organ_proj_id": "xxx",
"organ_proj_name": "xxx"
}
],
"attachments": [
{
"type": 1,
"text_content": "",
"img_url": "xxx",
"img_thumbnail_url": "xxx",
"h5_href": "xx",
"h5_title": "xxx",
"h5_description": "xxx",
"cover_url": "xxx",
"cover_thumbnail_url": "xxx",
"video_url": "xxx",
"ewmp_material_id": "xx",
"img_oss_path": "xx",
"cover_oss_path": "xx",
"video_oss_path": "xx"
}
],
"task_name": "xxx",
"customer_filter_type": 0,
"qw_external_userids": [
"xx"
],
"custom_condition": [
{
"code": "xx",
"values": "xxx"
}
]
}
返回数据:
{
"errcode": 0,
"errmsg": "ok",
"job_id": "xxxxx"
}
返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
job_id | string | 任务id |