调用CreateAgent创建悉犀客服工作台坐席账号,并返回坐席ID。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateAgent

系统规定参数。取值:CreateAgent。

ClientToken String 46c1341e-2648-447a-9b11-70b6a298d94d

客户请求唯一ID。用于幂等校验,可以用UUID生成。

InstanceId String ccc_xp_pre-cn-***

AICCS实例ID。可在智能联络中心控制台上获取。

AccountName String 123@123.com

坐席账号名称。实例内唯一(登录名)。

DisplayName String 刘测试

坐席对外显示名称。

SkillGroupId.N Integer 123456

技能组。

SkillGroupIdList.N Integer 123456,145678

技能组列表。

返回数据

名称 类型 示例值 描述
Message String xxxx

状态码描述。

RequestId String EE338D98-9BD3-4413-B165

请求ID。

Data Long 666666

坐席ID。

Code String Success

状态码。返回Success表示请求成功。

Success Boolean true

接口调用是否成功。

示例

请求示例

http(s)://aiccs.aliyuncs.com/?Action=46c1341e-2648-447a-9b11-70b6a298d94d
&ClientToken=46c1341e-2648-447a-9b11-70b6a298d94d
&InstanceId=ccc_xp_pre-cn-***
&AccountName=123@123.com
&DisplayName=刘测试
&SkillGroupId=[123456]
&SkillGroupIdList=[]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateAgentResponse>
<Message>xxxx</Message>
<RequestId>EE338D98-9BD3-4413-B165</RequestId>
<Data>666666</Data>
<Code>Success</Code>
<Success>true</Success>
</CreateAgentResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "xxxx",
  "RequestId" : "EE338D98-9BD3-4413-B165",
  "Data" : 666666,
  "Code" : "Success",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
500 NoSkillGroupSetFound The specified skill group set does not exist. 没有找到技能组分组
500 NoTenantFound The specified tenant does not exist. 没有发现租户实例
500 SystemError A system error occurred. Please contact the administrator. 系统错误,请联系管理员!

访问错误中心查看更多错误码。