获取群发任务详情接口

最后更新: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:已删除

results matching ""

    No results matching ""