创建自助单

POST

http://127.0.0.1/v1.0/customerService/tickets

生态伙伴API/智能客服

最后修改时间：2022-08-30 09:19:22

责任人：未设置

说明

调用本接口创建用户自定义的自助单。
服务地址：api.dingtalk.com

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	客服行业的工单写接口权限	API Explorer
第三方企业应用	支持	客服行业的工单写接口权限	API Explorer
第三方个人应用	暂不支持	客服行业的工单写接口权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	system.error	系统错误	系统错误
400	illegal.parameter	参数错误	参数错误

请求参数

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

sourceId

string

必需

会员来源，取diamond配置的值。

foreignId

string

第三方会员ID。

必需

foreignName

string

第三方会员名称。

必需

openInstanceId

string

可选

实例ID。
单实例企业必须传default，多实例企业必须传实例ID。

productionType

integer

智能客服产品类型：

可选

templateId

string

必需

自助单ID，钉钉智能客服自助单配置里的值。

title

string

工单标题。

必需

properties

array [object {2}]

工单表单。

可选

name

string

字段的key。

可选

value

string

字段的值。

可选

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/v1.0/customerService/tickets' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

ticketId

string

新创建的工单ID。

可选

示例

{
  "ticketId": "string"
}

分页查询工单

创建自助单

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码