调用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"
}

错误码

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