通过

在 Direct Line API 1.1 中从机器人接收消息

  • 项目

重要

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

使用 Direct Line 1.1 协议时，客户端必须轮询 HTTP GET 接口以接收消息。

通过 HTTP GET 检索消息

若要检索特定聊天的消息，请向 api/conversations/{conversationId}/messages 终结点发出 GET 请求，根据需要指定 watermark 参数以指示客户端看到的最新消息。 即使没有包含消息，也会在 JSON 响应中返回更新的 watermark 值。

以下代码段提供了“获取消息”请求和响应的示例。 “获取消息”响应包含 watermark 作为 MessageSet 的属性。 客户端应通过增加 watermark 值来按页浏览提供的消息，直到不返回任何消息。

请求

GET https://directline.botframework.azure.cn/api/conversations/abc123/messages?watermark=0001a-94
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0

响应

HTTP/1.1 200 OK
[other headers]

{
    "messages": [
        {
            "conversation": "abc123",
            "id": "abc123|0000",
            "text": "hello",
            "from": "user1"
        }, 
        {
            "conversation": "abc123",
            "id": "abc123|0001",
            "text": "Nice to see you, user1!",
            "from": "bot1"
        }
    ],
    "watermark": "0001a-95"
}

计时注意事项

尽管 Direct Line 是一个具有潜在计时间隙的多部分协议，但协议和服务旨在轻松简单地生成可靠的客户端。 发送到“获取消息”中的 watermark 属性很可靠。 客户端只要一字不差地重播水印，就不会错过任何消息。

客户端应选择匹配其预期用途的轮询间隔。

  • 服务到服务应用程序通常使用 5 秒或 10 秒的轮询间隔。

  • 面向客户端的应用程序通常使用 1 秒的轮询间隔，并在客户端发送的每条消息之后 ~300ms 发出额外的请求（以快速检索机器人的响应）。 应根据机器人的速度和传输时间调整此 300ms 延迟。

其他资源