调用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
AccessKeyId String 否 xxx

您的AccessKey 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 格式 

{
	"HttpStatusCode":200,
	"AgentDeviceId":456,
	"RequestId":"A13BB835-94AA-4E55-8D9E-5EA585CE6555",
	"Success":true,
	"Code":"OK"
}

错误码

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