创建客户跟进任务(旧)
最后更新:2023/09/15企业可通过此接口创建客户跟进任务(即将下线,请及时更换新接口)
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/task/follow_up/create
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"template_name": "每周会员日营销任务-测试",
"user_id": "wovvCXcAAASVUviBLSl3jHC-zKRynn-w",
"user_customers_list": [
{
"user_id": "wovvCXcAAASVUviBLSl3jHC-zKRynn-w",
"customer_id_list": [
"wovvCXcAAAj2wgt5-cZA6zWq01sCQOWQ",
"wovvCXcAAA72pPvHxMrpVYG7Ganv_sCg"
]
},
{
"user_id": "wovvCXcAAASVUviBLSl3jHC-zKRynn-w",
"customer_id_list": [
"wovvCXcAAAj2wgt5-cZA6zWq01sCQOWQ",
"wovvCXcAAA72pPvHxMrpVYG7Ganv_sCg"
]
}
],
"priority": 1,
"explain": {
"content": "测试",
"materials": []
},
"verbals": [
{
"verbal_type": 2,
"title": "title",
"content": "content",
"material": {
"id": 1357158668060377986,
"type": 2,
"title": "title"
}
}
],
"end_time": 1662010034,
"task_mode": 1,
"create_todo": true,
"send_notify": true,
"task_ext_type": "normal"
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
template_name | string | 是 | 跟进任务名称 |
user_id | string | 是 | 创建人id |
user_customers_list | array | 是 | 需要被跟进的客户列表 |
user_id | string | 是 | 跟进员工 |
customer_id_list | array | 是 | 需要被跟进的客户列表 |
priority | int | 否 | 任务优先级:不传默认优先级为中(1:高;2:中;3:低) |
explain | object | 否 | 任务说明 |
content | string | 否 | 任务说明文本内容(不能超过1300字符) |
materials | array | 否 | 素材列表(素材个数不能超过10个) |
id | long | 否 | 素材id |
type | int | 否 | 素材类型 |
title | string | 否 | 标题 |
combination_id | string | 否 | 关联的组合素材 |
package_config_id | string | 否 | 组合素材分类 |
verbals | array | 否 | 话术集合(不超过10个)。当传入verbals时, verbal_type、title、content、material{id、type、title}为必填字段,参数不能为空。 |
verbal_type | int | 否 | verbal_type的说明改为:话术内容类型。目前不支持传入自定义话术内容,只支持传入「2」,代表此话术是素材。 |
title | string | 否 | 话术标题 |
content | string | 否 | 话术内容 |
material | object | 否 | 素材 |
id | long | 否 | 素材id |
type | int | 否 | 素材类型 |
title | string | 否 | 标题 |
combination_id | string | 否 | 关联的组合素材 |
package_config_id | string | 否 | 组合素材分类 |
end_time | long | 否 | 结束时间,不填则默认90天后0点 |
task_mode | int | 否 | 任务模式:1.普通 2.数据同步(普通模式会发送待办和企微通知,数据同步模式不发送待办和企微通知;如果使用数据同步模式,将忽略 createTodo 和 sendNotify) |
create_todo | boolean | 否 | 是否创建待办。默认创建,如果不需要创建待办,传false |
send_notify | boolean | 否 | 是否发送企微消息。默认发送,如果不需要发送消息,传false |
task_ext_type | string | 否 | open接口任务类型,默认值normal,具体值open接口可以跟进业务自己指定。 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": "1561984059847033281"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | string | 跟进任务id |