创建一个座席。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnterpriseId |
integer |
是 |
呼叫中心 id |
7000002 |
| Cno |
string |
是 |
座席工号；正整数，取值 3-10 位数字 |
1111 |
| Name |
string |
是 |
座席姓名；需进行 UTF-8 格式的 URLEncode 编码 |
张三 |
| AreaCode |
string |
是 |
座席所属区号 |
010 |
| Active |
integer |
否 |
是否激活；取值 0 或 1，取值说明 0：不激活，1 激活，默认激活 |
1 |
| Power |
integer |
否 |
座席权限；取值 1 或 0，取值说明 1：班长席，0：普通座席，默认为 0 普通座席 |
0 |
| CallPower |
integer |
否 |
呼叫权限；取值说明 0：无限制，1：国内长途，2：国内本市，3：内部呼叫，默认无限制 |
0 |
| Wrapup |
integer |
否 |
整理时间；单位秒数，默认 10 秒 |
20 |
| IsOb |
integer |
否 |
是否允许外呼；取值说明 0：不允许，1：允许，默认允许 |
1 |
| ObClidType |
integer |
否 |
外显规则；取值：1:默认 2:随机 3:按区号 4 动态外显 ，默认值为 1 |
1 |
| ObClid |
string |
否 |
透传号码；可传入企业中继号码或设置好的客户侧外显号码，当 obClidType 值为 2 或 3 时必选 |
22223333 |
| ObClidProperty |
string |
否 |
外显属性；取值：{"isMatchCapital":0,"areaCodeRule":1,"isRandom":1}；obClidType=4 时，isMatchCapital 表示是否匹配省会号码，1 是 0 否，areaCodeRule 表示区号匹配规则，1 座席区号 2 客户号码区号 ;isRandom 随机外显 |
{"isMatchCapital":0,"areaCodeRule":1,"isRandom":1} |
| IbRecord |
integer |
否 |
呼入是否录音；取值说明 0：不录用，1：录音，默认录音 |
1 |
| ObRecord |
integer |
否 |
外呼是否录音；取值说明 0：不录音，1：录音，默认录音 |
1 |
| SkillIds |
string |
否 |
所选的技能 id；可选择多个，多个之间使用英文标点逗号间隔.例如:"1,2,3"；传入 skillIds 时，需要同时传入 skillLevels |
1,2,3 |
| SkillLevels |
string |
否 |
所选的技能的等级；值越小技能越高，多个间用英文标点逗号间隔。(与技能 id 相对应) 例如:"5,1,1"表示技能 id 为 1 的等级是 5; 技能 id 为 2 的等级是 1; 技能 id 为 3 的等级是 1. |
5,1,1 |
| IsAsr |
integer |
否 |
是否开启 ASR 转写；取值说明：0：不开启，1：开启，默认不开启 |
0 |
| IsQualityCheck |
integer |
否 |
是否开启座席质检；取值说明：0：不开启，1：开启，默认开启 |
1 |
| WebrtcUrlType |
integer |
否 |
webrtc 软电话返回地址；取值说明：0：企业默认 1：公网域名 2：专线域名 3：公网 IP 4：专线 IP |
0 |
| IsObRemember |
string |
否 |
外呼主叫记忆开关；取值说明：0：关闭 1：开启；默认开启 |
1 |
| Comment |
string |
否 |
备注 |
备注 |
| PermitObPreviewTime |
string |
否 |
可外呼时间段；格式：08:00,20:00 |
08:00,20:00 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
访问被拒绝详细信息。 |
无 |
| RequestId |
string |
请求 ID。 |
D9CB3933-9FE3-4870-BA8E-2BEE91B69D23 |
| Message |
string |
返回结果的提示信息。 |
OK |
| Data |
object |
返回结果。 |
|
| Agent |
object |
座席配置信息 |
|
| Status |
string |
座席状态，0:离线，1：在线 |
0 |
| IsQualityCheck |
string |
是否开启座席质检，取值说明：0：不开启，1：开启，默认开启 |
1 |
| CallPower |
string |
呼叫权限，0：无限制，1：国内长途，2：国内本市，3：内部呼叫，默认无限制 |
0 |
| ObClid |
string |
外显号码 |
xxxxxxxx |
| Cno |
string |
座席工号 |
1111 |
| CreateTime |
string |
创建时间，格式: yyyy-MM-dd HH:mm:ss |
2026-01-30 08:00:00 |
| IbRecord |
string |
呼入是否录音，0：不录音，1：录音，默认录音 |
1 |
| BindTelType |
string |
电话类型，1:固话 2:手机 3:分机 4:软电话 |
1 |
| Wrapup |
string |
整理时间，秒数，默认 10 秒 |
10 |
| ObRecord |
string |
外呼是否录音，0：不录音，1：录音，默认录音 |
1 |
| EnterpriseId |
string |
企业编号 |
7000002 |
| Name |
string |
座席姓名 |
张三 |
| IsAsr |
string |
是否开启 ASR 转写：0：不开启，1：开启，默认不开启 |
0 |
| Active |
string |
是否启用，0：停用，1：启用，默认启用 |
1 |
| ObClidType |
string |
外显规则 1：企业默认 2：随机 3：按区号 4：动态外显 |
1 |
| WebrtcUrlType |
string |
webrtc 软电话返回地址，0：企业默认 1：公网域名 2：专线域名 3：公网 IP 4：专线 IP |
0 |
| AreaCode |
string |
区号 |
010 |
| ObClidProperty |
string |
外显规则属性，JSON 格式 |
{"isMatchCapital":0,"areaCodeRule":1,"isRandom":1} |
| BindTel |
string |
座席绑定电话 |
2222333 |
| Id |
string |
座席 id |
355 |
| Power |
string |
1：班长席，0：普通座席，默认普通座席 |
0 |
| IsOb |
string |
是否允许外呼，0：不允许，1：允许，默认允许 |
1 |
| AgentSkills |
array<object> |
座席技能数组 |
|
|
object |
|||
| SkillLevel |
string |
技能值 |
2 |
| Cno |
string |
座席工号 |
1111 |
| CreateTime |
string |
创建时间，格式: yyyy-MM-dd HH:mm:ss |
2026-01-30 08:00:00 |
| SkillId |
string |
skill 的 id |
233 |
| Id |
string |
queueSkill 关系表中 id |
355 |
| AgentId |
string |
座席 id |
2333 |
| EnterpriseId |
string |
企业编号 |
7000002 |
| Code |
string |
状态码。返回 OK 代表请求成功，其他错误码详见错误码列表。 |
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "无",
"RequestId": "D9CB3933-9FE3-4870-BA8E-2BEE91B69D23",
"Message": "OK",
"Data": {
"Agent": {
"Status": "0",
"IsQualityCheck": "1",
"CallPower": "0",
"ObClid": "xxxxxxxx",
"Cno": "1111",
"CreateTime": "2026-01-30 08:00:00",
"IbRecord": "1",
"BindTelType": "1",
"Wrapup": "10",
"ObRecord": "1",
"EnterpriseId": "7000002",
"Name": "张三",
"IsAsr": "0",
"Active": "1",
"ObClidType": "1",
"WebrtcUrlType": "0",
"AreaCode": "010",
"ObClidProperty": "{\"isMatchCapital\":0,\"areaCodeRule\":1,\"isRandom\":1}",
"BindTel": "2222333",
"Id": "355",
"Power": "0",
"IsOb": "1"
},
"AgentSkills": [
{
"SkillLevel": "2",
"Cno": "1111",
"CreateTime": "2026-01-30 08:00:00",
"SkillId": "233",
"Id": "355",
"AgentId": "2333",
"EnterpriseId": "7000002"
}
]
},
"Code": "OK"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。