文档首页 > > API参考> 话务机器人API> 会话管理> 发起会话

发起会话

分享
更新时间: 2020/07/31 GMT+08:00

功能介绍

发起话务机器人会话。

URI

  • URI格式
    POST /v1/{project_id}/taskbot/voicecall/bots/{bot_id}/sessions

  • 参数说明
    表1 URI参数说明

    名称

    是否必选

    说明

    project_id

    项目ID,用于资源隔离。请参见获取项目ID

    bot_id

    话务机器人ID。

    进入话务机器人的Console界面,在“机器人名称/ID”列显示对应的bot_id。

请求消息

请求参数

无。

响应消息

响应参数如 表2所示。
表2 响应参数

名称

参数类型

说明

session_id

String

会话ID。每轮会话有效时间为5分钟,若5分钟内无响应则session_id失效。

question_id

String

问题ID。

question

String

问题。

action

Integer

0表示继续, 1表示直接中断, 2表示播放结束音后中断。

error_code

String

调用失败时的错误码。

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求示例
    POST https://{endpoint}/v1/E9993fc787d94b6c886cbaa340f9c0f4/taskbot/voicecall/bots/b1e2e409-d3f3-4916-9802-b489b5582f97/sessions
    
    Request Header:
        Content-Type: application/json
        X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  • 响应示例
    • 成功响应示例
      {
          "question":"string",
          "action":0,
          "session_id": "***",
          "question_id":"***"
      }
    • 失败响应示例
      {
          "error_code":"CBS.6824",
          "error_msg":"session resource does not exist"
      }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问