使用ListDialog查询智能联络机器人对话记录-智能联络中心-阿里云-智能联络中心(AICCS)-阿里云帮助中心

接口说明

您可调用此接口查询智能联络机器人对话记录，也可在任务管理>详情>查看对话记录界面查看智能联络机器人对话记录。
在调用此接口前，请确保您创建的智能联络机器人呼叫任务已有成功拨通的号码。
若您没有已创建的智能联络机器人呼叫任务，可在任务管理界面创建并启动任务或通过 CreateTask 、 StartTask 接口创建并启动任务。

QPS 限制

单用户调用频率：不限流。
API 频率：500 次/秒。

说明

如果多个用户的总调用超过 API 频率也会触发流控。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aiccs:ListDialog

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
TaskId	integer	是	机器人呼叫任务的唯一任务 ID。在任务管理界面查看或通过 CreateTask 接口获取。	12****
Called	string	是	被叫号码。在任务管理>详情界面查看被叫号码或通过 ListTaskDetail 接口获取被叫号码，接口返回的参数 Called 即为被叫号码。	130****0000

返回参数

名称	类型	描述	示例值
	object	返回数据。
RequestId	string	请求 ID。	D9CB3933-9FE3-4870-BA8E-2BEE91B69D23
Message	string	状态码描述。	OK
Data	array<object>	通话交互内容。
	object	通话交互内容列表。
Role	string	说话的角色。取值： robot：机器人。 user：用户。	robot
Content	string	话术内容。	您好
NodeType	string	节点类型。	normal
Time	string	开始时间。时间戳格式，单位：毫秒。	1619763900718
Tag	string	意图标签。	肯定
Code	string	请求状态码。返回 OK 代表请求成功。	OK
Success	boolean	调用接口是否成功。取值： true：成功。 false：失败。	true

示例

正常返回示例

JSON格式

{
  "RequestId": "D9CB3933-9FE3-4870-BA8E-2BEE91B69D23",
  "Message": "OK",
  "Data": [
    {
      "Role": "robot",
      "Content": "您好",
      "NodeType": "normal",
      "Time": "1619763900718",
      "Tag": "肯定"
    }
  ],
  "Code": "OK",
  "Success": true
}

错误码

HTTP status code	错误码	错误信息	描述
400	PermissionInsufficient	Insufficient permissions. Please contact the Alibaba Cloud account administrator.	权限不足，请联系主账号管理员
400	ParameterError	The parameter is invalid.	参数错误

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

变更历史

更多信息，参考变更详情。