调用AddAgentDevice当坐席上线时,保存坐席设备的基本信息。
可与ModifyAgentDevice接口连用来保存更新坐席设备的相关信息。一般为定位双登(坐席账号在多个电脑设备或者浏览器登录)或者网络问题引起的掉线等情况提供参考数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AddAgentDevice |
系统规定参数。取值:AddAgentDevice。 |
BrowserVersion | String | 是 | Chrome/74.0.3729.169 |
浏览器版本信息 |
ClientIp | String | 是 | 127.0.0.1 |
客户端IP地址 |
InstanceId | String | 是 | 9cfad875-6260-4a53-ab6e-b13e3fb31f7d |
呼叫中心实例ID |
ClientPort | String | 否 | 8080 |
客户端IP端口 |
Remark | String | 否 | 备注 |
其他备注信息 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
AgentDeviceId | Long | 456 |
保存数据的ID。 用于给ModifyAgentDevice提供数据来记录登录是否成功。 |
Code | String | OK |
响应码 |
HttpStatusCode | Integer | 200 |
HTTP状态码 |
Message | String | 无 |
响应信息 |
RequestId | String | A13BB835-94AA-4E55-8D9E-5EA585CE6555" |
请求ID |
Success | Boolean | true |
是否成功 |
示例
请求示例
http(s)://ccc.cn-shanghai.aliyuncs.com/?Action=AddAgentDevice
&BrowserVersion=Chrome/74.0.3729.169
&ClientIp=127.0.0.1
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&<公共请求参数>
正常返回示例
XML
格式
<AddAgentDeviceResponse>
<AgentDeviceId>456</AgentDeviceId>
<HttpStatusCode>200</HttpStatusCode>
<RequestId>A13BB835-94AA-4E55-8D9E-5EA585CE6555</RequestId>
<Success>true</Success>
<Code>OK</Code>
</AddAgentDeviceResponse>
JSON
格式
{
"AgentDeviceId":456,
"HttpStatusCode":200,
"RequestId":"A13BB835-94AA-4E55-8D9E-5EA585CE6555",
"Success":true,
"Code":"OK"
}
错误码
访问错误中心查看更多错误码。