通过

在 Direct Line API 1.1 中开始会话

  • 项目

重要

本文介绍如何使用 Direct Line API 1.1 启动会话。 如果要在客户端应用程序和机器人之间创建新连接，请改用 Direct Line API 3.0。

Direct Line 会话由客户端显式打开，只要机器人和客户端参与并拥有有效凭据，就可以运行。 打开会话时，机器人和客户端可能会发送消息。 多个客户端可以连接到一个给定会话，并且每个客户端都可以代表多个用户参与。

打开新会话

若要使用机器人打开一个新会话，请发出以下请求：

POST https://directline.botframework.azure.cn/api/conversations
Authorization: Bearer SECRET_OR_TOKEN

以下代码段提供了“启动会话”请求和响应的示例。

请求

POST https://directline.botframework.azure.cn/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn

响应

如果请求成功，响应将包含会话 ID、令牌和指示令牌过期之前的秒数的值。

HTTP/1.1 200 OK
[other headers]

{
  "conversationId": "abc123",
  "token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
  "expires_in": 1800
}

启动会话和生成令牌

启动会话操作 (POST /api/conversations) 类似于生成令牌操作 (POST /api/tokens/conversation)，因为这两个操作都返回可用于访问单个会话的 token。 但是，启动会话操作也会启动会话并与机器人联系，而生成令牌操作则不会执行这些操作。

如果打算立即启动会话，请使用启动会话操作。 如果计划将令牌分发给客户端并希望它们启动会话，请改用生成令牌操作。

其他资源