Skip to content

Commit 54ee47f

Browse files
vincec-msftKaiqb
authored andcommitted
Update bot-framework-rest-direct-line-3-0-receive-activities.md (MicrosoftDocs#748)
Websockets support conversation history so remove the parts that say they don't.
1 parent 07aa4bf commit 54ee47f

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

articles/rest-api/bot-framework-rest-direct-line-3-0-receive-activities.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Using the Direct Line 3.0 protocol, clients can receive activities via `WebSocke
1616

1717
## WebSocket vs HTTP GET
1818

19-
A streaming WebSocket efficiently pushes messages to clients, whereas the GET interface enables clients to explicitly request messages. Although the WebSocket mechanism is often preferred due to its efficiency, the GET mechanism can be useful for clients that are unable to use WebSockets or for clients that want to retrieve conversation history.
19+
A streaming WebSocket efficiently pushes messages to clients, whereas the GET interface enables clients to explicitly request messages. Although the WebSocket mechanism is often preferred due to its efficiency, the GET mechanism can be useful for clients that are unable to use WebSockets.
2020

2121
Not all [activity types](bot-framework-rest-connector-activities.md) are available both via WebSocket and via HTTP GET. The following table describes the availability of the various activity types for clients that use the Direct Line protocol.
2222

@@ -94,7 +94,7 @@ The WebSocket stream contains live updates and very recent messages (since the c
9494

9595
## <a id="http-get"></a> Retrieve activities with HTTP GET
9696

97-
Clients that are unable to use WebSockets or clients that want to get conversation history can retrieve activities by using `HTTP GET`.
97+
Clients that are unable to use WebSockets can retrieve activities by using `HTTP GET`.
9898

9999
To retrieve messages for a specific conversation, issue a `GET` request to the `/v3/directline/conversations/{conversationId}/activities` endpoint, optionally specifying the `watermark` parameter to indicate the most recent message seen by the client.
100100

@@ -160,7 +160,7 @@ Clients that poll using `HTTP GET` should choose a polling interval that matches
160160

161161
- Service-to-service applications often use a polling interval of 5s or 10s.
162162

163-
- Client-facing applications often use a polling interval of 1s, and issue an additional request ~300ms after every message that the client sends (to rapidly retrieve a bot's response). This 300ms delay should be adjusted based on the bot's speed and transit time.
163+
- Client-facing applications often use a polling interval of 1s, and issue a single additional request shortly after every message that the client sends (to rapidly retrieve a bot's response). This delay can be as short at 300ms but should be tuned based on the bot's speed and transit time. Polling should not be more frequent than once per second for any extended period of time.
164164

165165
## Additional resources
166166

@@ -169,4 +169,4 @@ Clients that poll using `HTTP GET` should choose a polling interval that matches
169169
- [Start a conversation](bot-framework-rest-direct-line-3-0-start-conversation.md)
170170
- [Reconnect to a conversation](bot-framework-rest-direct-line-3-0-reconnect-to-conversation.md)
171171
- [Send an activity to the bot](bot-framework-rest-direct-line-3-0-send-activity.md)
172-
- [End a conversation](bot-framework-rest-direct-line-3-0-end-conversation.md)
172+
- [End a conversation](bot-framework-rest-direct-line-3-0-end-conversation.md)

0 commit comments

Comments
 (0)