客服排班接口文档

接口说明

为客服创建排班计划，支持批量为多个客服添加排班。

新增客服排班

请求方法: POST

请求路径: /api/v1/schedules.json

调用者权限: 管理员

请求参数

名称	必需的	类型	注释
`duty`	是	array	排班对象数组

duty 数组元素参数：

名称	必需的	类型	注释
`sid`	是	int	客服 sId
`date`	是	datetime	排班日期（格式：2023-11-29）
`schedules`	是	array	排班列表

schedules 数组元素参数：

名称	必需的	类型	注释
`name`	否	varchar	排班名称（最大30个汉字）
`remark`	否	varchar	备注
`start_time`	是	datetime	开始时间（格式：15:00）
`end_time`	是	datetime	结束时间（格式：15:00）
`url`	否	string	点击排班后的跳转链接

调用示例

返回参数

名称	类型	注释
`code`	string	状态码（0表示成功）
`message`	string	状态信息
`data.duty`	array	排班结果列表

data.duty 数组元素参数：

名称	类型	注释
`sid`	int	客服 ID
`date`	datetime	日期
`schedules`	array	排班列表

schedules 数组元素参数：

名称	类型	注释
`dutyId`	int	排班 ID（格式：`{sid}_{date}_{序号}`）
`name`	varchar	排班名称
`remark`	varchar	备注
`start_time`	datetime	开始时间（格式：20:00）
`end_time`	datetime	结束时间（格式：20:00）
`url`	string	点击排班后的跳转链接

返回值示例

{
    "code": "0",
    "message": "success",
    "data": {
        "duty": [
            {
                "sid": "5675570",
                "date": "2023-11-07",
                "schedules": [
                    {
                        "dutyId": "5675570_2023-11-07_23",
                        "name": "周三15:00-16:00",
                        "remark": "备注备注一些东西",
                        "start_time": "15:00",
                        "end_time": "16:00",
                        "url": "http://www.baidu.com"
                    }
                ]
            },
            {
                "sid": "2235666",
                "date": "2023-11-07",
                "schedules": [
                    {
                        "dutyId": "2235666_2023-11-07_24",
                        "name": "是个名",
                        "remark": "备注备注一些东西",
                        "start_time": "15:00",
                        "end_time": "16:00"
                    },
                    {
                        "dutyId": "2235666_2023-11-07_25",
                        "name": "周三18:00-19:00",
                        "start_time": "15:00",
                        "end_time": "16:00"
                    }
                ]
            }
        ]
    }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Body 参数application/json

示例

{
    "duty": [
        {
            "sid": "5675570",
            "date": "2023-11-07",
            "schedules": [
                {
                    "name": "周三15:00-16:00",
                    "remark": "备注备注一些东西",
                    "start_time": "15:00",
                    "end_time": "16:00",
                    "url": "http://www.baidu.com"
                }
            ]
        },
        {
            "sid": "2235666",
            "date": "2023-11-07",
            "schedules": [
                {
                    "name": "备注排班",
                    "remark": "备注备注一些东西",
                    "start_time": "15:00",
                    "end_time": "16:00"
                },
                {
                    "name": "周三18:00-19:00",
                    "start_time": "15:00",
                    "end_time": "16:00"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

新增客服排班

客服排班接口文档#

接口说明#

新增客服排班#

请求参数#

调用示例#

返回参数#

返回值示例#

请求参数

请求示例代码

返回响应

客服排班接口文档

接口说明

新增客服排班

请求参数

调用示例

返回参数

返回值示例