API > 员工接口定义
员工接口定义
更新时间：2021/07/06 10：34
员工编辑
接口地址：https://api.51lianlian.cn/api/v1/emps
请求参数
字段名称 字段类型 约束限制 说明
token string(50) 必选 密钥
ts int 必选 时间戳
reqId string(50) 请求唯一ID，可使用UUID
data
Array
Object
用户信息(最大50个)
data
userId string(20) 必选 员工编号 不存在新创建员工
name string(20) 姓名 (新增没传时默认员工编号)
sex string(10) 性别 男女
userNo string(20) 员工扩展工号
phone1 string(20) 必选 常用手机号码(外呼主叫号码)
phone2 string(20) 备用手机号码(外呼主叫号码)
dept string(200) 员工所在部门，如：客户部 默认放入企业根节点部门
deptPath string(200) 部门路径，如果不存在会创建路径 如: 上级部门/上级部门/上级部门/dept
userType int 员工类型 默认0员工 1管理员
status int 状态 默认0正常 1冻结
joinPoolCalled int 加入接听号池 0不加入 1加入
joinPoolName string(20) 加入号池名称
unbindPhone int 解绑原坐席的所有小号 0不解绑 1解绑
phones
Array
Object
 号码绑定
phones
xphone string(20) 绑定的小号，为空由系统分配空闲的号码
channel string(20) 号码绑定渠道，需要提前配置渠道
status int 号码状态 默认0上线 1下线
返回格式
字段名称 字段类型 约束限制 说明
code int 必选 状态码
0成功
1签名验证错误
2参数错误
3坐席员工错误
4号码错误
5企业相关错误
6其他错误
message string 结果消息
data
Array
Object
 绑定完成后的用户信息
员工查询
接口地址：https://api.51lianlian.cn/api/v1/emp/query
请求参数
字段名称 字段类型 约束限制 说明
token string(50) 必选 密钥
ts int 必选 时间戳
userId string(20) 员工编号
xphone string(20) 小号
phone string(20) 员工手机号码
page int 必选 页码
pageSize int 必选 每页大小，不超过50
返回格式
字段名称 字段类型 约束限制 说明
code int 必选
0 成功
1 错误
message string 结果消息
total int 坐席总数
pageSize int 当前查询结果数量
users
Array
Object
 员工列表
users
userId string(20) 必选 员工编号
name string(20) 姓名
userNo string(20) 员工扩展工号
phone1 string(20) 常用手机号码(外呼主叫号码)
phone2 string(20) 备用手机号码(外呼主叫号码)
dept string(200) 必选 员工所在部门
userType int 必选 员工类型 0员工 1管理员
status int 必选 状态 0正常 1冻结
phones
Array
Object
 员工绑定的号码
phones
xphone string(20) 必选 小号
channel string(20) 渠道
status int 状态 0上线 1下线
员工删除
接口地址：https://api.51lianlian.cn/api/user/delUsers
请求参数
字段名称 字段类型 约束限制 说明
token string(50) 必选 密钥
ts int 时间戳
reqId string(50) 请求唯一ID，可使用UUID
data
Array
string
 必选 员工编号(最大50个)
返回格式
字段名称 字段类型 约束限制 说明
code int 必选
0 成功
其他错误
message string 结果消息
员工编辑
员工查询
员工删除