新增座席。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnterpriseId |
integer |
是 |
呼叫中心 id |
8004970 |
| Cno |
integer |
是 |
座席工号，长度为 4-11 个字符，必须全部为数字，要求唯一 |
1111 |
| Name |
string |
是 |
座席名称，只允许输入中文、字母、数字、下划线，长度不超过 20 个字符 |
示例值 |
| AreaCode |
string |
是 |
所属区号 |
010 |
| Password |
string |
是 |
座席密码，采用 AES 加密 ，默认长度为 8 位。如果企业开启了密码安全设置，则需要按照设置的规则设置 |
xxxx |
| Role |
integer |
否 |
座席角色，0: 普通座席；1: 班长座席，默认值为 0 |
0 |
| Active |
integer |
否 |
启用状态，0: 停用；1: 启用，默认值为 1 |
1 |
| Qnos |
array |
否 |
所属队列号集合 |
|
|
string |
否 |
队列号 |
123,124 |
|
| HiddenTel |
integer |
否 |
号码隐藏类型，0: 不隐藏；1: 隐藏规则与全局设置保持一致，默认值为 0 |
0 |
| WrapupTime |
integer |
否 |
整理时长，座席进行外呼操作后的整理时间。取值范围 0-300 秒，默认值为 30 |
24 |
| CrmId |
integer |
否 |
CRM 编号，与第三方 CRM 系统对接时，可作为唯一标识 |
87 |
| ClidType |
integer |
否 |
外显号码类型，0: 全部；2: 座席指定；3: 智能外显；默认值为 0 |
0 |
| ClidRule |
integer |
否 |
外显规则，默认值为 1 当 clidType（外显号码类型）值为 0（全部）时，1:随机；2: 轮选。 当 clidType（外显号码类型）值为 3（智能外显）时，1:动态；2: 自定义。 |
1 |
| AssignType |
integer |
否 |
号码类型，默认值为 0，0: 号码；1: 动态号码组 |
0 |
| DynamicTelGroupName |
string |
否 |
动态号码组名称，当 assignType（号码类型）值为 1（动态号码组）时为必填项 |
示例值示例值 |
| Clid |
array |
否 |
可外显号码集合，当 clidType（外显号码类型）值为非 0 时为必填项 |
|
|
string |
否 |
外显号码；外显的号码 |
41008502 |
|
| ClidDefault |
array |
否 |
缺省外显号码集合，当 clidType（外显号码类型）值为 3 且 clidRule（外显规则）值为 1（动态）时，支持配置缺省外显 |
|
|
string |
否 |
外显号码 |
41008502 |
|
| ClidArea |
array<object> |
否 |
按地区外显配置，当 clidType（外显号码类型）值为 3 且 clidRule（外显规则）值为 2（自定义）时有意义，具体配置项见 clidArea 对象 |
|
|
object |
否 |
|||
| AreaGroupName |
string |
否 |
地区组名称 |
示例值示例值示例值 |
| ObClids |
array |
否 |
外显号码 |
|
|
string |
否 |
外显号码 |
41008502 |
|
| AssignType |
integer |
否 |
号码类型，默认值为 0，0: 号码；1: 动态号码组 |
0 |
| DynamicTelGroupName |
string |
否 |
动态号码组名称，当 assignType（号码类型）值为 1（动态号码组）时为必填项 |
示例值示例值 |
| RecurrentselectionType |
integer |
否 |
轮选方式，1: 按天轮选；2: 按次轮选，当外显号码类型为全部、外显规则为轮选时配置才生效 |
1 |
| RecurrentselectionValue |
integer |
否 |
轮选值设置，当外显号码类型为全部、外显规则为轮选时配置才生效 1: 按天轮选，每 n 天外呼更换一次外显号码，可设置 1-30 天 2: 按次轮选，每 n 次外呼更换一次外显号码，可设置 1-30 次 |
1 |
| Permission |
object |
是 |
permission |
|
| Cdr |
integer |
否 |
通话记录查看权限，1: 全部；2: 所属队列；3:本座席，默认值为 1 |
1 |
| Asr |
integer |
否 |
语音转写，0: 关闭；1: 呼入开启；2 外呼开启；3 全部开启；默认值为 0 |
0 |
| Call |
integer |
否 |
外呼权限，0: 关闭；1: 无限制；2: 国内长途；3: 国内本地，默认值为 1 |
1 |
| RecordDownload |
integer |
否 |
录音试听下载权限，0: 关闭；1: 试听下载；2：试听，默认值 1 |
1 |
| OtherData |
integer |
否 |
其他数据查看权限：1：全部 2：所属员工组 3：自己 4:指定员工组 ,默认所属员工组 |
1 |
| Sms |
integer |
否 |
短信发送权限，0: 关闭；1: 开启，默认值为 0 |
0 |
| Chat |
integer |
否 |
在线客服查看会话记录权限 ，0：全部、1：所属队列、2：本座席； 默认值为 0 |
0 |
| Transfer |
integer |
否 |
通话转移/咨询权限，可选范围，0：全部，1：所属员工组, 默认所属员工组 |
0 |
| TaskInventory |
integer |
否 |
外呼任务查看权限，1：全部 3：自己，默认全部 |
1 |
| Record |
integer |
否 |
通话录音权限，0: 关闭；1: 呼入；2: 外呼；3: 全部，默认值为 3 |
3 |
| Type |
integer |
否 |
座席类型，1：全渠道、2：呼叫中心、3：在线客服；默认值为 2 |
2 |
| WechatMiniProgramRtc |
integer |
否 |
微信小程序 RTC 开关 1：开启 0：关闭 默认关闭 |
0 |
| ObClidDefaultType |
integer |
否 |
缺省号码类型 0：号码 1：动态号码组 默认 0 |
0 |
| DynamicTelGroupIdDefault |
integer |
否 |
缺省动态外呼组 id，当 obClidDefaultType 值为 1 时为必填项 |
17 |
| ServeArea |
array |
否 |
座席服务地区，区号数组 配置座席服务的地区，可用于外呼任务中“按服务地区分配”的策略。 |
|
|
string |
否 |
区号 |
021 |
|
| CloudNumberEnabled |
integer |
否 |
云号码外呼开关，0-关，1-开 |
0 |
| CloudNumberModes |
array |
否 |
云号码四种呼叫模式；数组长度 为 4，依次对应云号码外呼的四种模式（实体卡、工作卡、两端呼、RTC)的开启状态； 例如：[0,0,0,1] 表示 座席只可使用 RTC 外呼模式。 注意：仅当企业开启了云手机外呼功能，才能为座席设置该属性，否则，座席将创建失败 |
|
|
integer |
否 |
呼叫模式 |
0 |
|
| ObHangupSms |
integer |
否 |
外呼挂机短信开关 0：关闭， 1：开启。开启后，当座席发起外呼时，系统会依据【短信中心 - 短信设置 - 外呼双方接听通知 / 外呼客户未接听通知】中的配置条件发送短信。 |
0 |
| PauseLogin |
integer |
否 |
是否可置忙登录，关闭后，座席不允许置忙登录，0：关闭，1：开启，默认 1。 |
1 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
废弃参数 |
无 |
| RequestId |
string |
请求 ID。 |
A90E4451-FED7-49D2-87C8-00700A8C4D0D |
| Message |
string |
返回信息。 |
OK |
| Data |
object |
返回数据。 |
|
| ClinkRequestId |
string |
请求 id |
示例值 |
| Client |
object |
座席信息 |
|
| HiddenTel |
integer |
号码隐藏类型，0: 不隐藏；1: 隐藏规则与全局设置保持一致 |
0 |
| WrapupTime |
integer |
整理时长，座席进行外呼操作后的整理时间 |
42 |
| CloudNumberModes |
array |
云号码四种呼叫模式；数组长度 为 4，依次对应云号码外呼的四种模式（实体卡、工作卡、两端呼、RTC)的开启状态； |
|
|
integer |
呼叫模式 |
[0,0,0,1] |
|
| Clid |
array |
可外显号码集合 |
|
|
string |
外显号码 |
41008502 |
|
| ClidRule |
integer |
外显规则，根据外显号码类型值来定义，1: 随机；2: 轮选 或 1: 动态；2: 自定义 |
1 |
| Cno |
integer |
座席工号 |
1111 |
| RecurrentselectionValue |
integer |
轮选值设置 1: 按天轮选，每 n 天外呼更换一次外显号码，可设置 1-30 天 2: 按次轮选，每 n 次外呼更换一次外显号码，可设置 1-30 次 |
1 |
| Qnos |
array |
所属队列号集合 |
|
|
string |
队列号 |
0001 |
|
| RecurrentselectionType |
integer |
轮选方式，1: 按天轮选；2: 按次轮选 |
1 |
| CloudNumberEnabled |
integer |
云号码外呼开关，0-关，1-开 |
0 |
| ClidArea |
array<object> |
给地区指定可外显号码 |
|
|
object |
给地区指定可外显号码 |
||
| AreaGroupName |
string |
地区组名称 |
示例值示例值 |
| ObClids |
array |
外显号码 |
|
|
string |
外显号码 |
xxx |
|
| AssignType |
integer |
号码类型，默认值为 0，0: 号码；1: 动态号码组 |
0 |
| DynamicTelGroupName |
string |
动态号码组名称，当 assignType（号码类型）值为 1（动态号码组）时为必填项 |
示例值示例值 |
| Name |
string |
座席名称 |
示例值 |
| Role |
integer |
座席角色，0: 普通座席；1: 班长座席 |
0 |
| Active |
integer |
启用状态，0: 停用；1: 启用 |
0 |
| Type |
integer |
座席类型，1：全渠道、2：呼叫中心、3：在线客服 |
1 |
| ClidDefault |
array |
缺省外显号码集合，当 clidType（外显号码类型）值为 3 且 clidRule（外显规则）值为 1 时，支持配置缺省外显 |
|
|
string |
缺省外显号码 |
xxx |
|
| Permission |
object |
permission |
|
| Cdr |
integer |
通话记录查看权限，1: 全部；2: 所属队列；3:本座席，默认值为 1 |
1 |
| Asr |
integer |
语音转写，0: 关闭；1: 呼入开启；2 外呼开启；3 全部开启；默认值为 0 |
0 |
| Call |
integer |
外呼权限，0: 关闭；1: 无限制；2: 国内长途；3: 国内本地，默认值为 1 |
1 |
| RecordDownload |
integer |
录音试听下载权限，0: 关闭；1: 试听下载；2：试听，默认值 1 |
1 |
| OtherData |
integer |
其他数据查看权限：1：全部 2：所属员工组 3：自己 4:指定员工组 ,默认所属员工组 |
2 |
| Sms |
integer |
短信发送权限，0: 关闭；1: 开启，默认值为 0 |
0 |
| Chat |
integer |
在线客服查看会话记录权限 ，0：全部、1：所属队列、2：本座席； 默认值为 0 |
0 |
| Transfer |
integer |
通话转移/咨询权限，可选范围，0：全部，1：所属员工组, 默认所属员工组 |
1 |
| TaskInventory |
integer |
外呼任务查看权限，1：全部 3：自己，默认全部 |
1 |
| Record |
integer |
通话录音权限，0: 关闭；1: 呼入；2: 外呼；3: 全部，默认值为 3 |
3 |
| AreaCode |
string |
所属区号 |
010 |
| ClidType |
integer |
外显号码类型，0: 全部；2: 座席指定；3: 智能外显 |
0 |
| AssignType |
integer |
号码类型，默认值为 0，0: 号码；1: 动态号码组 |
0 |
| CrmId |
integer |
CRM 编号，与第三方 CRM 系统对接时，可作为唯一标识 |
20 |
| DynamicTelGroupName |
string |
动态号码组名称，当 assignType（号码类型）值为 1（动态号码组）时为必填项 |
xxx |
| Password |
string |
座席密码 |
xxx |
| Code |
string |
状态码。返回 OK 代表请求成功，其他错误码详见错误码列表。 |
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "无",
"RequestId": "A90E4451-FED7-49D2-87C8-00700A8C4D0D",
"Message": "OK",
"Data": {
"ClinkRequestId": "示例值",
"Client": {
"HiddenTel": 0,
"WrapupTime": 42,
"CloudNumberModes": [
0
],
"Clid": [
"41008502"
],
"ClidRule": 1,
"Cno": 1111,
"RecurrentselectionValue": 1,
"Qnos": [
"0001"
],
"RecurrentselectionType": 1,
"CloudNumberEnabled": 0,
"ClidArea": [
{
"AreaGroupName": "示例值示例值",
"ObClids": [
"xxx"
],
"AssignType": 0,
"DynamicTelGroupName": "示例值示例值"
}
],
"Name": "示例值",
"Role": 0,
"Active": 0,
"Type": 1,
"ClidDefault": [
"xxx"
],
"Permission": {
"Cdr": 1,
"Asr": 0,
"Call": 1,
"RecordDownload": 1,
"OtherData": 2,
"Sms": 0,
"Chat": 0,
"Transfer": 1,
"TaskInventory": 1,
"Record": 3
},
"AreaCode": "010",
"ClidType": 0,
"AssignType": 0,
"CrmId": 20,
"DynamicTelGroupName": "xxx",
"Password": "xxx"
}
},
"Code": "OK"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。