对话接口
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | Dialogue |
系统规定参数。取值：Dialogue。 |
| ConversationId | String | 是 | da37319b-6c83-4268-9f19-814aed62e401 |
会话id |
| InstanceId | String | 是 | 21e0b2a3-168d-4ba7-9009-afc42666eb54 |
实例id |
| Utterance | String | 是 | 是的 |
用户表述 |
| CalledNumber | String | 否 | 10086 |
被叫号码 |
| CallingNumber | String | 否 | 125815***** |
主叫号码 |
| AdditionalContext | String | 否 | {} |
会话上下文 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Action | String | Broadcast |
动作指令 |
| ActionParams | String | {} |
动作参数 |
| Interruptible | Boolean | true |
ivr 播报是否可打断 |
| RequestId | String | 14C39896-AE6D-4643-9C9A-E0566B2C2DDD |
请求id |
| TextResponse | String | 您好，欢迎致电智能助手 |
播报内容 |
示例
请求示例
http(s)://[Endpoint]/?Action=Dialogue
&ConversationId=da37319b-6c83-4268-9f19-814aed62e401
&InstanceId=21e0b2a3-168d-4ba7-9009-afc42666eb54
&Utterance=是的
&<公共请求参数>正常返回示例
XML 格式
<RequestId>14C39896-AE6D-4643-9C9A-E0566B2C2DDD</RequestId>
<TextResponse>您好，欢迎致电智能助手</TextResponse>
<Interruptible>false</Interruptible>
<Action>Broadcast</Action>JSON 格式
{
"RequestId": "14C39896-AE6D-4643-9C9A-E0566B2C2DDD",
"TextResponse" : "您好，欢迎致电智能助手",
"Interruptible" : false,
"Action" : "Broadcast"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 500 | InternalError | An error occurred while processing your request. Please try again later. Submit a ticket if the error still exists. | 内部错误。建议重试，如果多次重试报错请提交工单。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例ID不存在。 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。