dingtalk.oapi.customerservice.ticket.create (新建工单)

用于第三方企业的用户给其客服新建工单使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ticket_create TicketCreateDto 必须 工单对象
  • └ source_id
  • String
  • 必须
  • 1030043
  • 会员标识
  • └ foreign_id
  • String
  • 必须
  • song_0102
  • 第三方会员id
  • └ foreign_name
  • String
  • 必须
  • song_01
  • 第三方会员名
  • └ template_id
  • String
  • 必须
  • 12
  • 工单模板id
  • └ title
  • String
  • 必须
  • 我想咨询的问题是
  • 工单标题
  • properties
  • TicketFieldDto []
  • 必须
  • [ { "name": "question_type", "value": "bug" }, { "name": "memo", "value": "这是我反馈的问题,帮忙处理下" } ]
  • 工单表单
  • └ value
  • String
  • 必须
  • memo
  • 字段key
  • └ name
  • String
  • 必须
  • 这是我反馈的问题,帮忙处理下
  • 字段值
  • └ value_type
  • String
  • 可选
  • text
  • 默认值:text
  • 字段值类型,attachments,附件,数组类型;text,文本类型
  • └ production_type
  • String
  • 可选
  • 1
  • 默认值:1
  • 1智能客服产品
  • └ open_instance_id
  • String
  • 可选
  • shop001
  • 默认值:default
  • 实例id

响应参数

名称 类型 示例值 描述
result TicketCreateResultDto {"ticketId":"2000000000100517"} 结果对象
  • └ ticket_id
  • String
  • "2000000000100517"
  • 工单id
success Boolean false 是否成功
errcode Number 50010 异常码
errmsg String 内部错误 异常消息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/customerservice/ticket/create");
OapiCustomerserviceTicketCreateRequest req = new OapiCustomerserviceTicketCreateRequest();
TicketCreateDto obj1 = new TicketCreateDto();
obj1.setSourceId("1030043");
obj1.setForeignId("song_0102");
obj1.setForeignName("song_01");
obj1.setTemplateId("12");
obj1.setTitle("我想咨询的问题是");
List<TicketFieldDto> list3 = new ArrayList<TicketFieldDto>();
TicketFieldDto obj4 = new TicketFieldDto();
list3.add(obj4);
obj4.setValue("memo");
obj4.setName("这是我反馈的问题,帮忙处理下");
obj4.setValueType("text");
obj1.setProperties(list3);
obj1.setProductionType("1");
obj1.setOpenInstanceId("shop001");
req.setTicketCreate(obj1);
OapiCustomerserviceTicketCreateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "result":{
        "ticket_id":"\"2000000000100517\""
    },
    "success":false,
    "errcode":50010,
    "errmsg":"内部错误"
}

异常示例

  • JSON示例
{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部