调用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-***	实例ID。请登录智能联络中心控制台，在实例管理中查看实例ID。
AccountName	String	是	username@example.com	坐席账号名称，即账号注册时填写的手机或邮箱。实例内唯一。
DisplayName	String	是	XX测试	坐席对外显示名称。
SkillGroupId	Array of Long	否	1234****	技能组。
SkillGroupIdList	Array of Long	否	1223**,1456**	技能组列表。

返回数据


名称	类型	示例值	描述
Message	String	OK	状态码描述。
RequestId	String	EE338D98-9BD3-4413-B165	请求ID。
Data	Long	2578****	坐席ID。
Code	String	Success	状态码。返回Success表示请求成功。
Success	Boolean	true	接口调用是否成功。
HttpStatusCode	Long	200	HTTP状态码。

示例

请求示例

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

正常返回示例

XML格式

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

<CreateAgentResponse>
    <Message>OK</Message>
    <RequestId>EE338D98-9BD3-4413-B165</RequestId>
    <Code>Success</Code>
    <Success>true</Success>
    <HttpStatusCode>200</HttpStatusCode>
</CreateAgentResponse>

JSON格式

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

{
  "Message" : "OK",
  "RequestId" : "EE338D98-9BD3-4413-B165",
  "Code" : "Success",
  "Success" : true,
  "HttpStatusCode" : 200
}

错误码


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.	系统错误，请联系管理员！

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