创建工单
功能介绍
用户在使用产品的过程中，遇到问题或者需要帮助时可以提交工单。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/servicerequest/cases
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：5000 |
X-Language | 否 | String | 语言环境，值为通用的语言描述字符串，比如zh-cn等，默认为zh-cn。 会根据语言环境对应展示一些国际化的信息，比如工单类型名称等。 最小长度：1 最大长度：32 |
X-Time-Zone | 否 | String | 环境时区，值为通用的时区描述字符串，比如GMT+8等，默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度：1 最大长度：32 |
x-phone-verifiedid | 否 | String | 手机验证序列号id，如果选择非注册手机号提醒，如果是非注册联系方式则必填，通过"查询已验证的列表"接口查询获取 最小长度：1 最大长度：32 |
x-email-verifiedid | 否 | String | 邮件验证序列号id，如果选择非注册邮箱提醒，如果是非注册联系方式则必填，通过"查询已验证的列表"接口查询获取 最小长度：1 最大长度：32 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
incident_sub_type_id | 否 | String | 工单子类，通过"查询工单类目列表"接口获取 最小长度：0 最大长度：32 |
product_category_id | 否 | String | 工单产品类型，通过"查询工单类目列表"接口获取 最小长度：0 最大长度：64 |
business_type_id | 是 | String | 工单问题类型，通过"查询问题类型列表"接口获取 最小长度：0 最大长度：512 |
region_id | 否 | String | 区域ID，根据business_type_id对应工单类型是5则必填，通过"查询问题类型列表"查看 最小长度：0 最大长度：64 |
simple_description | 是 | String | 问题描述 最小长度：0 最大长度：2000 |
source_id | 是 | String | 工单来源，当前固定为83aeb0f2834c4df49826c781d32a963e 最小长度：0 最大长度：32 |
remind_mobile | 否 | String | 提醒手机号 最小长度：0 最大长度：32 |
remind_mail | 否 | String | 提醒邮箱 最小长度：0 最大长度：128 |
remind_time | 否 | String | 提醒时间 最小长度：0 最大长度：16 |
project_id | 否 | String | ProjectId 最小长度：0 最大长度：64 |
accessory_ids | 否 | Array of strings | 附件id列表，"上传附件"接口返回的id 最小长度：0 最大长度：100 |
extends_map | 否 | Map<String,Object> | 附加参数 数组范围：0-100（每个元素key值长度范围0-32） |
extension_map | 否 | Map<String,Object> | 扩展参数 数组范围：0-100（每个元素key值长度范围0-32） |
severity_id | 否 | String | 严重性id，通过"查询问题严重性列表"接口获取 最小长度：0 最大长度：64 |
verify_code | 否 | String | 验证码，如果是非注册联系方式，需要通过"获取验证码"获取验证码 最小长度：0 最大长度：6 |
area_code | 否 | String | 国家码 最小长度：0 最大长度：32 |
incident_service_type | 否 | String | 服务类型，IncidentService：工单服务，IntelligentCustomerService：在线服务 最小长度：0 最大长度：32 |
session_ids | 否 | Array | 会话ID列表 数组范围：0-5，每个元素长度不超过64 |
agreement_signed_record_id | 否 | Integer | 协议签署记录id |
ask_for_case_words | 否 | String | 用户大模型问答场景下触发转人工的话术，如果是点击按钮转人工, 则留空 |
agent_code | 否 | String | 在智能客服创建工单时传入，0原智能客服的CRMAgent, 1盘古助手Agent，2盘古助手Agent工单 |
响应参数
状态码： 200
参数 | 参数类型 | 描述 |
|---|---|---|
incident_id | String | 工单id 最小长度：0 最大长度：64 |
请求示例
POST https://{endpoint}/v2/servicerequest/cases
{
"incident_sub_type_id" : "123",
"product_category_id" : "123",
"business_type_id" : "123",
"region_id" : "cn-north-1",
"simple_description" : "test",
"source_id" : "123",
"remind_mobile" : null,
"remind_mail" : null,
"remind_time" : "9:00-18:00",
"project_id" : null,
"accessory_ids" : [ ],
"extends_map" : [ ],
"extension_map" : [ ],
"severity_id" : "123",
"verify_code" : null,
"area_code" : 86
} 响应示例
状态码： 200
成功返回工单号
{
"incident_id" : "123"
} 状态码
状态码 | 描述 |
|---|---|
200 | 成功返回工单号 |
错误码
请参见错误码。
