获取群发任务详情接口
最后更新:2024/8/15企业可通过该接口获取群发任务详情
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/mass_send/corp/get_mass_task_detail?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"task_id": 54
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
task_id | long | 是 | 群发任务ID |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"task_id": 2,
"task_name": "fake_data",
"task_status": 1,
"type": 10,
"create_user_id": "fake_data",
"send_time": 57,
"end_time": 59,
"create_time": 37,
"content": "fake_data",
"plan_staff_qty": 27,
"no_send_staff_qty": 79,
"success_staff_qty": 25,
"fail_staff_qty": 80,
"plan_target_qty": 67,
"no_send_target_qty": 73,
"success_target_qty": 3,
"fail_target_qty": 5,
"excess_target_qty": 72,
"comment_staff_qty": 52,
"comment_customer_qty": 93,
"like_staff_qty": 54,
"like_customer_qty": 89,
"material_infos": [
{
"material_id": 73,
"material_type": 42,
"title": "fake_data",
"combination_id": "fake_data",
"package_config_id": "fake_data",
"act_child_type": 1,
"status": 0
}
],
"filter_range_info": {
"filter_type": "fake_data",
"is_all_customer": false,
"is_all_customer_group": true,
"all_staff": false,
"range_info": "fake_data"
}
}
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | page | 分页对象 |
total | int | 总条数 |
records | object[] | 数据列表 |
task_id | long | 群发任务id |
task_name | string | 群发任务名称 |
type | int | 群发类型 10:企业群发客户,11.企业群发客户群;12.企业群发朋友圈;13.个人群发客户;14.个人群发客户群;15.个人群发朋友圈; |
task_status | int | 任务状态 0.未开始;1.创建中;2.进行中;3.已结束;4.已失效;5.关闭中;-1.创建失败; |
create_user_id | string | 创建群发任务员工ID |
send_time | long | 任务发送时间 |
end_time | long | 任务结束时间 |
create_time | long | 任务创建时间 |
content | string | 发送文本内容 |
plan_staff_qty | int | 预计执行员工数 |
no_send_staff_qty | int | 未执行员工数量 |
success_staff_qty | int | 已执行员工数 |
fail_staff_qty | int | 无法执行员工数 |
plan_target_qty | int | 预计发送客户/客户群数 |
no_send_target_qty | int | 未送达客户/客户群数 |
success_target_qty | int | 已送达客户/客户群数 |
fail_target_qty | int | 送达失败客户/客户群 |
excess_target_qty | int | 超额送达客户/客户群数 |
comment_staff_qty | int | 评论员工数 |
comment_customer_qty | int | 评论客户数 |
like_staff_qty | int | 点赞员工数 |
like_customer_qty | int | 点赞客户数 |
material_infos | array | 素材信息数据集合 |
material_id | long | 素材ID |
material_type | int | 素材类型 |
title | string | 标题 |
combination_id | string | 组合素材ID |
package_config_id | string | 素材分类ID |
act_child_type | int | 活动素材子类型 1.拼团/2.秒杀/3.抽奖 |
status | int | 素材状态:0.正常;-1.已删除;1.海报素材-小程序已取消授权;2.该海报上的员工推广码已被删除; |
filter_range_info | object | 筛选范围 |
filter_type | string | 过滤类型, AllCustomer:全部客户, AllCustomerGroup:全部客户群, CorpSend2Customer:企业群发客户, StaffSend2Customer:个人群发客户, CorpSend2CustomerGroup:企业群发客户群, StaffSend2CustomerGroup:个人群发客户群, CorpSend2Moment:企业发表朋友圈, StaffSend2Moment:个人发表朋友圈, OpenSend2Customer:企业群发指定员工发送给指定客户, OpenSend2CustomerGroup:企业群发指定员工发送给指定客户群, CrowdPack:人群包 |
is_all_customer | bool | 是否全部客户 |
is_all_customer_group | bool | 是否全部客户群 |
all_staff | bool | 发送范围是否为“全部员工” |
range_info | string | 范围信息,内容为json格式的字符串数据 |
必看,扩展补充
filter_type=CorpSend2Customer,range_info范围信息内容如下:
{
"add_user_range": {
"user_ids": [
"test_a29da7427c0b"
],
"dept_ids": [
70
],
"user_tags": [
{
"tag_id": "test_cf873d1ac9f7",
"tag_name": "test_bcbcda0f2044"
}
]
},
"add_time_range": {
"start_time": "test_4c0647f811f9",
"end_time": "test_5bb4fc1407f0"
},
"include_tags": {
"operator": 99,
"tag_detail_list": [
{
"tag_id": "test_98b8d38873c3",
"tag_name": "test_181bbb44e510",
"tag_type": 38,
"strategy_id": 82,
"auth": 56,
"status": 76,
"desc": "test_17aa31492143"
}
]
},
"exclude_tags": {
"operator": 41,
"tag_detail_list": [
{
"tag_id": "test_f4d73ff89f52",
"tag_name": "test_59a276f69935",
"tag_type": 46,
"strategy_id": 82,
"auth": 67,
"status": 31,
"desc": "test_91384cb181a9"
}
]
},
"locations": [
{
"region_code": "test_7fd3e441dcaa",
"region_remark": "test_c71ede997fd2"
}
],
"chat_list": [
{
"chat_id": "test_469d073c6571",
"chat_name": "test_906189133a0a",
"status": "test_fbe5fdb41483"
}
],
"sex": "test_d56c33a50723",
"age_range": "test_dce6b7dfb984",
"remark_key_words": [
"test_2d7032436521"
],
"description_key_words": [
"test_1eeed2458a9e"
],
"tag_groups": [
{
"tag_group_id": "test_ef638e554830",
"tag_group_name": "test_374d81e0a629",
"tag_detail_list": [
{
"tag_id": "test_bf05801bf258",
"tag_name": "test_de1089a9b027",
"tag_type": 99,
"strategy_id": 47,
"auth": 19,
"status": 57,
"desc": "test_48bbe7c08842"
}
]
}
]
}
参数 | 类型 | 说明 |
---|---|---|
add_user_range | object | 添加人范围 |
user_ids | array | 员工ID集合,员工ID类型:string |
dept_ids | array | 部门ID集合,部门ID类型:long |
user_tags | object | 员工标签集合 |
tag_id | string | 员工标签id |
tag_name | string | 员工标签名称 |
add_time_range | object | 添加时间范围 |
start_time | string | 开始时间,格式: yyyy-MM-dd HH:mm:ss |
end_time | string | 结束时间,格式: yyyy-MM-dd HH:mm:ss |
include_tags | object | 客户包含标签 |
operator | int | 标签集合内的运算规则 (1:满足任意一个标签;2:同时满足所有标签;3:无标签客户;4:同组标签为或,不同组标签为且) |
tag_detail_list | array | 标签信息集合,标签信息为object |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
exclude_tags | object | 客户剔除标签 |
operator | int | 标签集合内的运算规则 (1:满足任意一个标签;2:同时满足所有标签;3:无标签客户;4:同组标签为或,不同组标签为且) |
tag_detail_list | array | 标签信息集合,标签信息为object |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
locations | array | 所在地区信息数组 |
region_code | string | 地区编码 |
region_remark | string | 省市区.格式:湖北省,武汉市,江夏区 |
chat_list | array | 所在群聊数组 |
chat_id | string | 群聊id |
chat_name | string | 群聊名称 |
status | string | 群聊状态:0.正常;0100:群id错误;0101: 群被解散;0201:群主被移除可见范围;0202:账号未开通或已过期;0203:群主账号未激活; |
sex | string | 性别:ALL-全部;M-男;F-女;UNKNOW-未知; |
age_range | string | 年龄范围,用\"~\"分隔;例如:25~30 |
remark_key_words | array | 备注名关键词数组 |
description_key_words | array | 描述关键词数组 |
tag_groups | array | 标签组信息数组 |
tag_group_id | string | 标签组id |
tag_group_name | string | 标签组名称 |
tag_detail_list | array | 标签信息数组 |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
filter_type=CorpSend2CustomerGroup,range_info范围信息内容如下:
{
"group_owner_range": {
"user_ids": [
"test_3b12d07f9f79"
],
"dept_ids": [
70
],
"user_tags": [
{
"tag_id": "test_cf873d1ac9f7",
"tag_name": "test_bcbcda0f2044"
}
]
},
"group_name_list": [
"test_8f72fdd13a44"
],
"include_tags": {
"operator": 1,
"tag_detail_list": [
{
"tag_id": "test_b9ad882b3982",
"tag_name": "test_29686622a69a",
"tag_type": 11,
"strategy_id": 34,
"auth": 24,
"status": 98,
"desc": "test_08f83a998783"
}
]
},
"exclude_tags": {
"operator": 1,
"tag_detail_list": [
{
"tag_id": "test_eba0a6acfc58",
"tag_name": "test_ac31d14e1d68",
"tag_type": 1,
"strategy_id": 72,
"auth": 53,
"status": 2,
"desc": "test_465afedc2cdc"
}
]
},
"user_chat_info": {
"user_id_1": [
"chat_id_1",
"chat_id_2"
],
"user_id_2": [
"chat_id_2",
"chat_id_2"
]
}
}
参数 | 类型 | 说明 |
---|---|---|
group_owner_range | object | 群主范围 |
user_ids | array | 员工ID集合,员工ID类型:string |
dept_ids | array | 部门ID集合,部门ID类型:long |
user_tags | object | 员工标签集合 |
tag_id | string | 员工标签id |
tag_name | string | 员工标签名称 |
group_name_list | array | 客户群名称集合,客户群名称类型:string |
include_tags | object | 包括标签对象 |
exclude_tags | object | 过滤标签对象 |
operator | int | 运算规则,1:满足任意一个标签;2:同时满足所有标签;3:无标签客户 |
tag_detail_list | array | 标签信息集合 |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
user_chat_info | object | 员工与客户群关系对 |
key | string | 员工ID |
value | array | 客户群ID集合,客户群ID类型:string |
filter_type=CorpSend2Moment,range_info范围信息内容如下:
{
"add_user_range": {
"user_ids": [
"test_3b12d07f9f79"
],
"dept_ids": [
70
],
"user_tags": [
{
"tag_id": "test_cf873d1ac9f7",
"tag_name": "test_bcbcda0f2044"
}
]
},
"tag_groups": [
{
"tag_group_id": "fake_data",
"tag_group_name": "fake_data",
"tag_detail_list": [
{
"tag_id": "fake_data",
"tag_name": "fake_data",
"tag_type": 1,
"strategy_id": 34,
"status": 0,
"desc": "fake_data"
}
]
}
]
}
参数 | 类型 | 说明 |
---|---|---|
add_user_range | object | 添加人范围对象 |
user_ids | array | 员工ID集合,员工ID类型:string |
dept_ids | array | 部门ID集合,部门ID类型:long |
user_tags | object | 员工标签集合 |
tag_id | string | 员工标签id |
tag_name | string | 员工标签名称 |
tag_groups | array | 标签组信息数组 |
tag_group_id | string | 标签组ID |
tag_group_name | string | 标签组名称 |
tag_detail_list | array | 标签信息数组 |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | int | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
filter_type=OpenSend2Customer,range_info范围信息内容如下:
{
"user_customer_info": {
"user_id_1": [
"customer_id_1",
"customer_id_2"
],
"user_id_2": [
"customer_id_2",
"customer_id_2"
]
}
}
参数 | 类型 | 说明 |
---|---|---|
user_customer_info | object | 员工客户映射关系 |
key | string | 员工ID |
value | array | 客户ID集合,客户ID类型:string |
filter_type=OpenSend2CustomerGroup,range_info范围信息内容如下:
{
"user_chat_info": {
"user_id_1": [
"chat_id_1",
"chat_id_2"
],
"user_id_2": [
"chat_id_2",
"chat_id_2"
]
}
}
参数 | 类型 | 说明 |
---|---|---|
user_chat_info | object | 员工客户群映射关系 |
key | string | 员工ID |
value | array | 客户群ID集合,客户群ID类型:string |
filter_type=StaffSend2Customer,range_info范围信息内容如下:
{
"add_user_range": {
"user_ids": [
"test_3b12d07f9f79"
],
"dept_ids": [
70
],
"user_tags": [
{
"tag_id": "test_cf873d1ac9f7",
"tag_name": "test_bcbcda0f2044"
}
]
},
"tag_groups": [
{
"tag_group_id": "test_617398026225",
"tag_group_name": "test_7a22f2c9f785",
"tag_detail_list": [
{
"tag_id": "test_161e0111c553",
"tag_name": "test_da082681a55d",
"tag_type": 84,
"strategy_id": 84,
"auth": 0,
"status": 8,
"desc": "test_3f5573a840e2"
}
]
}
],
"add_time_range": {
"start_time": "test_201623c4a398",
"end_time": "test_eab3b51f2116"
},
"exclude_tags": {
"operator": 1,
"tag_detail_list": [
{
"tag_id": "test_060646392dbc",
"tag_name": "test_efe85ea157c9",
"tag_type": 1,
"strategy_id": 75,
"auth": 30,
"status": 40,
"desc": "test_795abb1c47cd"
}
]
},
"location": [
{
"region_code": "test_6f5f8d0d3166",
"region_remark": "test_b1adf675efac"
}
],
"chat_list": [
{
"chat_id": "test_860dcd5105c1",
"chat_name": "test_014a2b2d59b6",
"status": "test_372e05fe0f1a"
}
],
"sex": "test_88f881455368",
"age_range": "test_b7b658854566",
"remark_key_words": [
"test_87c854a5a342"
],
"description_key_words": [
"test_7a875eb54ba1"
],
"user_customer_info": {
"user_id_1": [
"customer_id_1",
"customer_id_2"
],
"user_id_2": [
"customer_id_2",
"customer_id_2"
]
}
}
参数 | 类型 | 说明 |
---|---|---|
add_user_range | object | 添加人范围 |
user_ids | array | 员工ID集合,员工ID类型:string |
dept_ids | array | 部门ID集合,部门ID类型:long |
user_tags | object | 员工标签集合 |
tag_id | string | 员工标签id |
tag_name | string | 员工标签名称 |
tag_groups | array | 标签组信息数组 |
tag_group_id | string | 标签组Id |
tag_group_name | string | 标签组名称 |
tag_detail_list | array | 标签信息集合,标签信息为object |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
add_time_range | object | 添加时间范围对象 |
start_time | object | 开始时间,格式:yyyy-MM-dd HH:mm:ss |
end_time | object | 结束时间,格式:yyyy-MM-dd HH:mm:ss |
chat_list | array | 群聊信息集合 |
chat_id | string | 群聊id |
chat_name | string | 群聊名称 |
status | int | 群聊状态:0.正常;0100:群id错误;0101: 群被解散;0201:群主被移除可见范围;0202:账号未开通或已过期;0203:群主账号未激活; |
exclude_tags | object | 移除标签对象 |
operator | int | 运算规则,1:满足任意一个标签;2:同时满足所有标签;3:无标签客户 |
tag_detail_list | array | 标签信息集合 |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
location | array | 所在地区集合 |
region_code | string | 地区编码 |
region_remark | string | 省市区之间用英文半角逗号分隔;例如:北京市,北京市,东城区 |
sex | string | 性别 |
age_range | string | 年龄范围 |
remark_key_words | array | 备注名关键词集合 |
description_key_words | array | 描述关键词集合 |
user_customer_info | object | 备注名关键词集合 |
key | string | 员工ID |
value | array | 客户ID集合,客户ID类型:string |
filter_type=StaffSend2CustomerGroup,range_info范围信息内容如下:
{
"group_owner_range": {
"user_ids": [
"test_3b12d07f9f79"
],
"dept_ids": [
70
],
"user_tags": [
{
"tag_id": "test_cf873d1ac9f7",
"tag_name": "test_bcbcda0f2044"
}
]
},
"group_name_list": [
"test_1f66bf99bec8"
],
"include_tags": {
"operator": 1,
"tag_detail_list": [
{
"tag_id": "test_a99774bba9a7",
"tag_name": "test_2040f8120c79",
"tag_type": 29,
"strategy_id": 32,
"auth": 28,
"status": 44,
"desc": "test_0bb7c652667c"
}
]
},
"exclude_tags": {
"operator": 1,
"tag_detail_list": [
{
"tag_id": "test_ed2895d6af07",
"tag_name": "test_5aeb900305ec",
"tag_type": 53,
"strategy_id": 21,
"auth": 3,
"status": 26,
"desc": "test_85524980631a"
}
]
},
"user_chat_info": {
"user_id_1": [
"chat_id_1",
"chat_id_2"
],
"user_id_2": [
"chat_id_2",
"chat_id_2"
]
}
}
参数 | 类型 | 说明 |
---|---|---|
group_owner_range | object | 添加人范围 |
user_ids | array | 员工ID集合,员工ID类型:string |
dept_ids | array | 部门ID集合,部门ID类型:long |
user_tags | object | 员工标签集合 |
tag_id | string | 员工标签id |
tag_name | string | 员工标签名称 |
group_name_list | array | 群名关键词数组 |
include_tags | object | 客户包含标签 |
operator | int | 标签集合内的运算规则 (1:满足任意一个标签;2:同时满足所有标签;3:无标签客户) |
tag_detail_list | array | 标签信息集合,标签信息为object |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
exclude_tags | object | 过滤标签信息对象 |
operator | int | 运算规则,1:满足任意一个标签;2:同时满足所有标签;3:无标签客户 |
tag_detail_list | array | 标签信息集合 |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
user_chat_info | object | 员工与客户群关系对 |
key | string | 员工ID |
value | array | 客户群ID集合,客户群ID类型:string |
filter_type=StaffSend2Moment,range_info范围信息内容如下:
{
"add_user_range": {
"user_ids": [
"test_3b12d07f9f79"
],
"dept_ids": [
70
],
"user_tags": [
{
"tag_id": "test_cf873d1ac9f7",
"tag_name": "test_bcbcda0f2044"
}
]
},
"tag_groups": [
{
"tag_group_id": "test_e54579846213",
"tag_group_name": "test_ea11a09b1be2",
"tag_detail_list": [
{
"tag_id": "test_9e18bdb70e3e",
"tag_name": "test_cbc52c3f07bf",
"tag_type": 87,
"strategy_id": 66,
"auth": 1,
"status": 16,
"desc": "test_be6df20b07aa"
}
]
}
],
"exclude_tags": {
"operator": 1,
"tag_detail_list": [
{
"tag_id": "test_06be1a5c82ad",
"tag_name": "test_6f6780caa349",
"tag_type": 94,
"strategy_id": 36,
"auth": 92,
"status": 6,
"desc": "test_6b6020aab85a"
}
]
}
}
参数 | 类型 | 说明 |
---|---|---|
add_user_range | object | 添加人范围 |
user_ids | array | 员工ID集合,员工ID类型:string |
dept_ids | array | 部门ID集合,部门ID类型:long |
user_tags | object | 员工标签集合 |
tag_id | string | 员工标签id |
tag_name | string | 员工标签名称 |
tag_groups | array | 标签组信息数组 |
tag_group_id | string | 标签组Id |
tag_group_name | string | 标签组名称 |
tag_detail_list | array | 标签信息集合,标签信息为object |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
exclude_tags | object | 过滤标签信息对象 |
operator | int | 运算规则,1:满足任意一个标签;2:同时满足所有标签;3:无标签客户 |
tag_detail_list | array | 标签信息集合 |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
strategy_id | long | 业务标签规则组(客户标签才有) |
status | int | 标签状态:0:正常 1:删除或不存在; |
desc | string | 标签异常状态说明 |
filter_type=CrowdPack,range_info范围信息内容如下:
{
"tenant_id": "test_tenant_id",
"crowd_packs": [
{
"id": 54579846213,
"name": "人群包",
"deleted": 0
}
]
}
参数 | 类型 | 说明 |
---|---|---|
tenant_id | object | 添加人范围 |
crowd_packs | array | 人群包集合 |
id | Long | 人群包ID |
name | String | 人群包名称 |
deleted | Integer | 人群包删除状态 0:未删除 1:已删除 |