調用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. 系統錯誤，請聯系管理員！

訪問錯誤中心查看更多錯誤碼。