# 创建朋友圈任务

请求方式: 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