创建超级群发任务
最后更新:2024/09/06企业可通过此接口异步创建超级群发任务
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/mass_send/corp/async_create_super_mass_info
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"template_name": "test_81625bf0400d",
"user_id": "test_d68d45c65c79",
"user_targets_info_list": [
{
"user_id": "test_11e236fd7f5f",
"send_ids": [
"test_b2a3da3a357f"
]
}
],
"explain": {
"materials": [
{
"id": 44,
"type": 0,
"send_type": 95,
"combination_id": "test_ed33b54a2f9d",
"package_config_id": "test_b2a8201bb4db",
"is_poster": true,
"act_child_type": 1
}
]
},
"end_time": 31,
"delay_type": 1
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
template_name | string | 是 | 任务名称 |
user_id | string | 是 | 创建人id |
user_targets_info_list | array | 是 | 需要被超级群发的客户群列表.超级群发员工数+客户群数不得超过10000个 |
user_id | string | 是 | 员工id |
send_ids | array | 是 | 需要被发送的目标列表,只支持群id |
explain | object | 是 | 任务发送内容对象 |
end_time | long | 否 | 结束时间.时间戳.精度:秒.默认值:任务开始后第3天0点 |
delay_type | int | 是 | 任务类型.1-立即跟进.目前通过openAPI创建只支持立即跟进. |
explain字段参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
materials | array | 否 | 素材集合,集合最大:10 |
material字段参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | long | 是 | 素材id |
type | int | 是 | 素材类型.1-海报(暂不支持), 2-文本, 3-图片, 4-文章, 5-语音, 6-视频, 7-文件, 8-小程序,9-外部链接,10-优惠券,11-商品,12-活动(actChildType:1-拼团,2-秒杀,3-抽奖) |
send_type | int | 否 | 素材的发送方式,仅轨迹素材填写生效,1-以轨迹形式发送轨迹素材,2-以普通形式形式发送轨迹素材。如素材超过限制,不论填写哪种发送形式,系统都以轨迹形式完成发送,比如文件大小超过10M等,具体参考页面提示。 |
combination_id | string | 否 | 关联的组合素材id |
package_config_id | string | 否 | 组合素材分类id |
is_poster | bool | 否 | 是否为海报素材图片,否则为普通素材图片 |
act_child_type | int | 否 | 活动素材子类型.1-拼团,2-秒杀,3-抽奖 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"template_id": 94
}
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 返回成功仅代表系统收到请求,不代表已创建成功,最终是否成功可通过请求任务列表查询任务状态来判断 |
data | object | 返回对象 |
template_id | long | 超级群发任务id |