对话接口
调试
您可以在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不存在。 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。