1. 3.1 客服管理
帮我吧API接口文档v1
  • 接口地图
  • 一、快速入门
    • 帮我吧数据接口 - 开发向导
    • 1.1 获取 Token
      POST
  • 二、核心业务实体
    • 2.1 客户与联系人
      • 联系人管理
        • 获取联系人列表
        • 获取多个联系人详情
        • 批量联系人详情
        • 搜索联系人
        • 创建联系人
        • 修改联系人
        • 删除联系人
        • 批量删除联系人
      • 客户分组
        • 获取分组列表
        • 获取分组详情
        • 批量分组详情
        • 创建分组
        • 修改分组
        • 获取分组用户
      • 联系人字段
        • 获取联系人字段列表
      • 公司管理
        • 获取公司列表
        • 获取公司详情
        • 批量公司详情
        • 创建公司
        • 修改公司
        • 删除公司
        • 批量删除公司
        • 搜索公司
      • 公司字段
        • 获取公司字段列表
        • 获取公司联系人
      • 远程 ID 管理
        • 获取远程ID信息
        • 修改远程ID备注
        • 远程ID绑定联系人
        • 解绑远程 ID
    • 2.2 工单
      • 工单管理
        • 获取工单列表
        • 获取工单详情
        • 批量工单详情
        • 搜索工单
        • 创建工单
        • 修改工单
        • 批量修改工单
        • 工单拆单
      • 工单回复
        • 获取工单回复列表
      • 工单附件
        • 上传工单附件
      • 工单字段
        • 获取工单自定义字段
        • 获取工单所有字段
        • 覆盖字段选项
        • 更新字段选项
        • 删除字段选项
      • 工单模板
        • 获取模板列表
        • 批量工单模板
        • 获取模板详情
        • 获取模板字段
      • 工单查询器
        • 获取查询器列表
        • 获取查询器详情
        • 获取查询器的工单列表
        • 获取查询器的工单总数
        • 批量获取查询器工单数量
    • 2.3 服务记录
      • IM 服务记录
        • 获取 IM 聊天记录
        • 获取 IM 会话列表
        • 获取 IM 会话详情
        • 获取服务总结(IM)
      • CC 服务记录
        • 获取呼叫中心记录列表
        • 获取呼叫中心记录详情
        • 获取指定客服的通话记录列表
        • 获取服务总结(CC)
        • 录音解冻
      • 远程协助记录
        • 获取远程记录列表
        • 获取坐席远程记录
        • 获取远程记录的聊天记录
        • 获取服务总结(远程协助)
      • 服务总结
        • 获取业务模板列表
        • 获取业务模板详情
        • 获取业务记录列表
        • 获取业务记录详情
        • 修改业务记录
    • 2.4 知识库
      • 知识库条目
        • 获取知识库列表
        • 获取知识库详情
        • 获取多条知识库
        • 创建知识库
        • 修改知识库
        • 上传知识库附件
      • 知识库分类
        • 获取知识库分类列表
        • 新增知识库分类
        • 修改知识库分类
        • 删除知识库分类
      • 附件上传
        • 上传附件
  • 三、人员与组织
    • 3.1 客服管理
      • 获取客服列表
        GET
      • 获取客服详情
        GET
      • 搜索客服
        GET
      • 获取多个客服信息
        GET
      • 创建客服
        POST
      • 修改客服信息
        PUT
      • 删除客服信息
        DELETE
      • 恢复删除的客服
        PUT
      • 客服授权
        PUT
      • 查看客服状态
        GET
      • 修改客服状态
        PUT
      • 获取客服签到列表
        GET
      • 创建客服签到
        POST
      • 获取客服排班列表
        GET
      • 新增客服排班
        POST
      • 更新客服排班
        PUT
      • 删除客服排班
        DELETE
    • 3.2 客服组管理
      • 获取客服组列表
      • 获取客服组详情
      • 获取客服组下的客服
      • 创建客服组
      • 修改客服组
      • 删除客服组
  • 四、系统配置
    • 4.1 表单管理
      • 获取表单列表
      • 获取表单详情
      • 创建表单
      • 修改表单
      • 删除表单
    • 4.2 表单字段
      • 查询指定表单的字段列表
      • 表单字段选项增加、更新
    • 4.3 资产表
      • 获取指定资产表的所有数据
      • 给指定资产表添加一行数据
      • 给指定资产表添加多行数据
      • 根据唯一值更新指定资产表一行数据
      • 更新指定资产表一行数据
      • 删除一行数据
      • 搜索资产表中的资产数据
    • 4.4 自定义字段配置
      • 查询联系人字段列表
      • 查询公司字段列表
      • 查询工单自定义字段列表
      • 查询工单字段列表(包含系统字段)
      • 下拉字段选项全量覆盖
      • 新增、修改字段选项内容
      • 删除字段选项内容
    • 4.5 客服分组管理
      • 获取客服分组列表
      • 获取客服分组详情
      • 创建客服分组
      • 修改客服分组
      • 删除客服分组
    • 4.6 工单查询器管理
      • 获取查询器列表
      • 获取查询器详情
      • 获取查询器的工单列表
      • 获取查询器的工单总数
      • 批量获取查询器工单数量
    • 4.7 工单模板管理
      • 获取模板列表
      • 批量工单模板
      • 获取模板详情
      • 获取模板字段
    • 4.8 客户分组管理
      • 获取分组列表
      • 获取分组详情
      • 批量分组详情
      • 创建分组
      • 修改分组
      • 获取分组用户
    • 4.9 短信接口
      • 获取模板列表
      • 发送短信
    • 4.10 服务商设置
      • 获取服务商账号到期时间
    • 4.11 外部扩展集成
      • 扩展系统配置文档
      • 扩展页接口文档
      • 适用客户
  • 五、呼叫中心
    • 5.1 获取客服话机状态
      • 获取客服话机状态
    • 5.2 接听模式切换
      • 切换接听模式
    • 5.3 SDK网页集成(CC)
      • 适用场景
      • 快速集成
      • 高级对接
  • 六、在线客服
    • 6.1 SDK网页集成(IM)
      • 适用场景
      • 快速集成
      • 高级对接
  • 七、公共接口
    • 7.1 获取 Token
      • 获取 OAuth2 Token
    • 7.2 标签接口
      • 获取标签列表
  1. 3.1 客服管理

获取客服排班列表

GET
https://www.bangwo8.com/api/v1/schedules.json
最后修改时间:2026-04-06 05:16:25
责任人:未设置
我将为您把这个获取客服排班列表接口整理成 Markdown 格式。

获取客服排班列表接口文档#

接口说明#

获取客服排班列表,支持按日期范围查询。

获取客服排班列表#

请求方法: GET
请求路径: /api/v1/schedules.json
调用者权限: 管理员
注意: 文档标题写的是 /api/v1/supports.json,但调用示例使用的是 /api/v1/schedules.json,请以实际调用示例为准。

请求参数#

Query 参数#

名称必需的类型注释
startDT否datetime开始日期(格式:2023-12-01)
endDT否datetime结束日期(格式:2023-12-01)

调用示例#


返回参数#

名称类型注释
codestring状态码(0表示成功)
messagestring状态信息
data.dutyobject排班对象
data.duty 参数:
名称类型注释
sidint客服ID
datedatetime日期
schedulesarray排班列表(二维数组)
schedules 数组元素参数:
名称类型注释
dutyIdint排班ID
namevarchar排班名称(最大30个汉字)
remarkvarchar备注
start_timedatetime开始时间(格式:20:00:00)
end_timedatetime结束时间(格式:20:00:00)
statusint排班状态

返回值示例#

{
    "code": "0",
    "message": "ok",
    "data": {
        "duty": {
            "sid": "10591",
            "date": "2023-12-04",
            "schedules": [
                [
                    {
                        "dutyId": "10591_2023-12-04_656d4229600fa",
                        "name": "测试排班修改接口",
                        "remark": "测试修改",
                        "start_time": "12:01",
                        "end_time": "18:01",
                        "status": "1"
                    }
                ]
            ]
        }
    }
}

请求参数

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/schedules.json?startDT=2023-12-01&endDT=2023-12-31' \
--header 'Authorization: Basic <encoded-value>'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "0",
    "message": "ok",
    "data": {
        "718120": [
            {
                "_id": "13",
                "sid": "718120",
                "date": "2023-12-07",
                "schedules": [
                    {
                        "name": "Maxie.Carroll",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-07_6571961f3cef5",
                        "status": "1"
                    },
                    {
                        "name": "Wilmer71",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-07_6571962047e2e",
                        "status": "1"
                    },
                    {
                        "name": "Tito83",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-07_65719c3748233",
                        "status": "1"
                    }
                ]
            },
            {
                "_id": "16",
                "sid": "718120",
                "date": "2023-12-08",
                "schedules": [
                    {
                        "name": "Nils_Schumm73",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-08_65727cbab45a9",
                        "status": "1"
                    },
                    {
                        "name": "Jocelyn.Stroman95",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-08_65727da69b26a",
                        "status": "1"
                    }
                ]
            }
        ],
        "718153": [
            {
                "_id": "14",
                "sid": "718153",
                "date": "2023-12-07",
                "schedules": [
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-07_65719765ce39b",
                        "status": "1"
                    },
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-07_65719765cea8d",
                        "status": "1"
                    },
                    {
                        "name": "Fidel4",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "11:30",
                        "dutyId": "718153_2023-12-07_65719765cf12a",
                        "status": "1"
                    },
                    {
                        "name": "Jean.Ernser",
                        "remark": "备注备注",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718153_2023-12-07_65719c3318e08",
                        "status": "1"
                    },
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-07_65719c3748a32",
                        "status": "1"
                    },
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-07_65719c374917e",
                        "status": "1"
                    },
                    {
                        "name": "Trudie.Runolfsdottir12",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "11:30",
                        "dutyId": "718153_2023-12-07_65719c3749a67",
                        "status": "1"
                    }
                ]
            },
            {
                "_id": "15",
                "sid": "718153",
                "date": "2023-12-08",
                "schedules": [
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-08_65727da69f3c6",
                        "status": "1"
                    },
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-08_65727da6a152b",
                        "status": "1"
                    },
                    {
                        "name": "Angus_Willms",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "11:30",
                        "dutyId": "718153_2023-12-08_65727da6a1d11",
                        "status": "1"
                    }
                ]
            }
        ]
    }
}
修改于 2026-04-06 05:16:25
上一页
创建客服签到
下一页
新增客服排班
Built with