- 接口地图
- 一、快速入门
- 二、核心业务实体
- 2.1 客户与联系人
- 2.2 工单
- 2.3 服务记录
- 2.4 知识库
- 三、人员与组织
- 四、系统配置
- 4.1 表单管理
- 4.2 表单字段
- 4.3 资产表
- 4.4 自定义字段配置
- 4.5 客服分组管理
- 4.6 工单查询器管理
- 4.7 工单模板管理
- 4.8 客户分组管理
- 4.9 短信接口
- 4.10 服务商设置
- 4.11 外部扩展集成
- 五、呼叫中心
- 六、在线客服
- 七、公共接口
获取工单列表
GET
https://www.bangwo8.com/api/v1/tickets.json
最后修改时间：2026-04-06 05:16:25
责任人：未设置
请求参数说明#
| 名称 | 必要的 | 类型 | 注释 |
|---|---|---|---|
| created_start | 否 | string | 按创建时间查询：开始时间，包含当天 |
| created_end | 否 | string | 按创建时间查询：结束时间，包含当天 |
| updated_start | 否 | string | 按更新时间查询：开始时间，包含当天 |
| updated_end | 否 | string | 按更新时间查询：结束时间，包含当天 |
| created_order | 否 | string | 按创建时间排序：asc（升序），desc（降序） |
| updated_order | 否 | string | 按更新时间排序：asc（升序），desc（降序） |
| status_order | 否 | string | 按工单状态排序：asc（升序），desc（降序） |
| page | 否 | number | 页码，默认为 1 |
| per_page | 否 | number | 每页大小，默认为 10 |
created_start、created_end、updated_start、updated_end）格式为“2026-01-01 00:00:00”。per_page 参数的值来自定义每页返回的条数，建议不要超过100条，因为会影响接口返回速度。per_page 参数值时，可设置自增的 page 参数继续请求下一页数据。GET http://www.bangwo8.com/api/v1/companies/{company_id}/tickets.json
查看服务商下某个客户的某个联系人的工单
GET http://www.bangwo8.com/api/v1/users/{user_id}/tickets.json
返回参数说明#
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| ticketId | int | 是 | 工单id，系统自动生成 |
| custUserId | int | 否 | 联系人id，说明该工单是为该客户解决问题 |
| subject | String | 是 | 工单标题 |
| descript | String | 是 | 工单描述 |
| servicerUserId | int | 否 | 受理客服id（如果想置空需要传0） |
| ccUserIdList | string | 否 | 抄送客服id列表 |
| ticketType | int | 否 | 工单类型：1–问题，2–事务，3–故障，4–任务 |
| priorityLevel | int | 否 | 工单优先级：1–低，2–正常，3–高，4–紧急 |
| tagList | int | 否 | 工单标签列表，以逗号分隔 |
| ticketStatus | int | 否 | 工单状态：1–新建，2–已开启，3–待回应，4–已解决，5–自动关闭，6–手动关闭 |
| createDT | datetime | 是 | 工单创建时间 |
| updateDT | datetime | 是 | 工单更新时间 |
| solveDT | datetime | 否 | 解决时间 |
| waitDT | datetime | 否 | 等待时间 |
| openDT | datetime | 否 | 开启时间 |
| closeDT | datetime | 否 | 关闭时间 |
| servicerGroupId | int | 否 | 受理客服组id |
| createrId | int | 是 | 工单创建人id |
| createrType | int | 否 | 工单创建人类型，0-客服 1-客户 |
| agentId | int | 是 | 关联agents表aId |
| ticketSource | int | 否 | 工单来源：1–远程，2–聊天，3–呼叫中心，4–留言，5–系统创建，6-其他，7–API，8–工单模板发布，9–邮件接入，10-其他服务商，11-工单工作台，12-手动导入，13-客户管理自动化任务，14-帮我吧APP |
| ticketTemplateId | int | 是 | 工单模板id，创建工单需指明当前工单使用哪个工单模板 |
| ccGroupIdList | string | 否 | 抄送客服组id列表 |
| customTemplateId | int | 否 | 客户模板id |
| rootTicket | int | 否 | 该工单关联哪单，填写想关联工单的工单号即可（显示在后台会显示拆自此单，工单来源为API） |
| createrType | String | 否 | 创建类型 |
| currentNodeField | String | 否 | 节点字段 |
| currentNodeFieldValue | String | 否 | 节点 |
| nodeFieldIntoTime | String | 否 | 节点时间 |
| queryIDs | String | 否 | |
| custom_fields | array | 否 | 工单自定义字段 |
| tables | array | 否 | 工单中的普通表单、评价表单 |
| count | int | 是 | 所有工单数量 |
| next_page | String | 否 | 下一页地址 |
| previous_page | String | 否 | 上一页地址 |
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password示例：
Authorization: Basic *****************Query 参数
请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://www.bangwo8.com/api/v1/tickets.json?page=1&per_page=10&state=&groupId=&servicerId=&userId=&companyId=&created_start=&created_end=' \
--header 'Authorization: Basic <encoded-value>'返回响应
🟢200成功
application/json
Body
示例
{
"tickets": [
{
"servicerGroupId": "5399",
"servicerUserId": "176853",
"ticketType": "",
"priorityLevel": "",
"tagList": "",
"subject": "聊天-u2_128789_342334903843",
"descript": "",
"ticketStatus": "1",
"ticketSource": "2",
"createrId": "176853",
"agentId": "128789",
"ticketTemplateId": "4",
"ccGroupIdList": "",
"custUserId": "0",
"createrType": "0",
"updateDT": "2020-07-01 16:35:53",
"createDT": "2020-07-01 16:35:53",
"ticketId": "10338961",
"descriptattachments": [],
"ccUserIdList": "",
"custom_fields": []
},
{
"servicerGroupId": "5399",
"servicerUserId": "176853",
"ticketType": "",
"priorityLevel": "",
"tagList": "",
"subject": "聊天-u2_128789_179028813514",
"descript": "",
"ticketStatus": "1",
"ticketSource": "2",
"createrId": "176853",
"agentId": "128789",
"ticketTemplateId": "4",
"ccGroupIdList": "",
"custUserId": "0",
"createrType": "0",
"updateDT": "2020-07-01 16:49:22",
"createDT": "2020-07-01 16:49:22",
"ticketId": "10339432",
"descriptattachments": [],
"ccUserIdList": "",
"custom_fields": []
},
{
"ticketId": "1045325",
"custUserId": "8471227",
"subject": "邮件接入",
"descript": "邮件接入",
"servicerUserId": "0",
"ccUserIdList": "",
"ticketType": "0",
"priorityLevel": "0",
"tagList": "0",
"ticketStatus": "1",
"createDT": "2018-02-03 18:10:57",
"updateDT": "2020-09-04 10:18:43",
"solveDT": "",
"waitDT": "",
"openDT": "",
"closeDT": "",
"servicerGroupId": "0",
"createrId": "0",
"agentId": "128789",
"ticketSource": "9",
"ticketTemplateId": "0",
"ccGroupIdList": "",
"customTemplateId": "0",
"createrType": "0",
"currentNodeField": "",
"currentNodeFieldValue": "",
"nodeFieldIntoTime": "0",
"queryIDs": "",
"descriptattachments": [],
"custom_fields": []
},
{
"ticketId": "1045327",
"custUserId": "8471229",
"subject": "欢迎使用腾讯企业邮箱",
"descript": "欢迎使用腾讯企业邮箱",
"servicerUserId": "0",
"ccUserIdList": "",
"ticketType": "0",
"priorityLevel": "0",
"tagList": "",
"ticketStatus": "1",
"createDT": "2018-02-03 18:10:58",
"updateDT": "",
"solveDT": "",
"waitDT": "",
"openDT": "",
"closeDT": "",
"servicerGroupId": "",
"createrId": "0",
"agentId": "128789",
"ticketSource": "9",
"ticketTemplateId": "0",
"ccGroupIdList": "",
"customTemplateId": "0",
"createrType": "0",
"currentNodeField": "",
"currentNodeFieldValue": "",
"nodeFieldIntoTime": "0",
"queryIDs": "",
"descriptattachments": [],
"custom_fields": []
},
{
"ticketId": "1045329",
"custUserId": "8471229",
"subject": "欢迎使用腾讯企业邮箱",
"descript": "欢迎使用腾讯企业邮箱",
"servicerUserId": "0",
"ccUserIdList": "",
"ticketType": "0",
"priorityLevel": "0",
"tagList": "",
"ticketStatus": "1",
"createDT": "2018-02-03 18:10:59",
"updateDT": "",
"solveDT": "",
"waitDT": "",
"openDT": "",
"closeDT": "",
"servicerGroupId": "",
"createrId": "0",
"agentId": "128789",
"ticketSource": "9",
"ticketTemplateId": "0",
"ccGroupIdList": "",
"customTemplateId": "0",
"createrType": "0",
"currentNodeField": "",
"currentNodeFieldValue": "",
"nodeFieldIntoTime": "0",
"queryIDs": "",
"descriptattachments": [],
"custom_fields": []
},
{
"ticketId": "1045331",
"custUserId": "8471227",
"subject": "哎哟喂",
"descript": "哎哟喂",
"servicerUserId": "176853",
"ccUserIdList": "",
"ticketType": "0",
"priorityLevel": "0",
"tagList": "",
"ticketStatus": "1",
"createDT": "2018-02-03 18:13:21",
"updateDT": "2018-02-03 18:27:36",
"solveDT": "",
"waitDT": "",
"openDT": "",
"closeDT": "",
"servicerGroupId": "5399",
"createrId": "0",
"agentId": "128789",
"ticketSource": "9",
"ticketTemplateId": "0",
"ccGroupIdList": "",
"customTemplateId": "0",
"createrType": "0",
"currentNodeField": "",
"currentNodeFieldValue": "",
"nodeFieldIntoTime": "0",
"queryIDs": "",
"descriptattachments": [],
"custom_fields": []
},
{
"servicerGroupId": "279766",
"servicerUserId": "194589",
"ticketType": "",
"priorityLevel": "",
"tagList": "",
"subject": "聊天-u2_128789_668367159521",
"descript": "",
"ticketStatus": "1",
"ticketSource": "2",
"createrId": "194589",
"agentId": "128789",
"ticketTemplateId": "3",
"ccGroupIdList": "",
"custUserId": "24608353",
"createrType": "0",
"updateDT": "2020-07-31 15:03:44",
"createDT": "2020-07-31 15:03:44",
"ticketId": "10786366",
"descriptattachments": [],
"ccUserIdList": "",
"custom_fields": [
{
"key": "field_1",
"value": ""
},
{
"key": "servicesummary_default_field",
"value": ""
},
{
"key": "field_7",
"value": ""
},
{
"key": "field_17",
"value": ""
}
]
},
{
"servicerGroupId": "5399",
"servicerUserId": "194589",
"ticketType": "",
"priorityLevel": "",
"tagList": "",
"subject": "聊天-u2_128789_482048757029",
"descript": "",
"ticketStatus": "1",
"ticketSource": "2",
"createrId": "194589",
"agentId": "128789",
"ticketTemplateId": "3",
"ccGroupIdList": "",
"custUserId": "0",
"createrType": "0",
"updateDT": "2020-08-05 10:22:27",
"createDT": "2020-08-05 10:22:27",
"ticketId": "10846027",
"currentServiceUserId": "194589",
"firstResponse": true,
"descriptattachments": [],
"ccUserIdList": "",
"custom_fields": [
{
"key": "field_1",
"value": ""
},
{
"key": "servicesummary_default_field",
"value": ""
},
{
"key": "field_7",
"value": ""
},
{
"key": "field_17",
"value": ""
}
]
},
{
"servicerGroupId": "5399",
"servicerUserId": "194589",
"ticketType": "",
"priorityLevel": "",
"tagList": "",
"subject": "聊天-u2_128789_300697562938",
"descript": "",
"ticketStatus": "1",
"ticketSource": "2",
"createrId": "194589",
"agentId": "128789",
"ticketTemplateId": "3",
"ccGroupIdList": "",
"custUserId": "29406808",
"createrType": "0",
"updateDT": "2020-08-21 18:29:39",
"createDT": "2020-08-21 18:29:39",
"ticketId": "11074117",
"descriptattachments": [],
"ccUserIdList": "",
"custom_fields": [
{
"key": "field_1",
"value": ""
},
{
"key": "servicesummary_default_field",
"value": ""
},
{
"key": "field_7",
"value": ""
},
{
"key": "field_17",
"value": ""
}
]
},
{
"servicerGroupId": "5399",
"servicerUserId": "194589",
"ticketType": "",
"priorityLevel": "",
"tagList": "",
"subject": "聊天-u2_128789_300697562938",
"descript": "",
"ticketStatus": "1",
"ticketSource": "2",
"createrId": "194589",
"agentId": "128789",
"ticketTemplateId": "3",
"ccGroupIdList": "",
"custUserId": "29406808",
"createrType": "0",
"updateDT": "2020-08-21 18:30:56",
"createDT": "2020-08-21 18:30:56",
"ticketId": "11074132",
"descriptattachments": [],
"ccUserIdList": "",
"custom_fields": [
{
"key": "field_1",
"value": ""
},
{
"key": "servicesummary_default_field",
"value": ""
},
{
"key": "field_7",
"value": ""
},
{
"key": "field_17",
"value": ""
}
]
}
],
"count": "307",
"previous_page": "",
"next_page": "https://www.bangwo8.com/api/v1/tickets.json?per_page=10&page=2&state=&groupId=&servicerId=&userId=&companyId=&created_start=&created_end="
}修改于 2026-04-06 05:16:25