You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/rest-api/bot-framework-rest-direct-line-3-0-receive-activities.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ Using the Direct Line 3.0 protocol, clients can receive activities via `WebSocke
16
16
17
17
## WebSocket vs HTTP GET
18
18
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.
20
20
21
21
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.
22
22
@@ -94,7 +94,7 @@ The WebSocket stream contains live updates and very recent messages (since the c
94
94
95
95
## <aid="http-get"></a> Retrieve activities with HTTP GET
96
96
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`.
98
98
99
99
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.
100
100
@@ -160,7 +160,7 @@ Clients that poll using `HTTP GET` should choose a polling interval that matches
160
160
161
161
- Service-to-service applications often use a polling interval of 5s or 10s.
162
162
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.
164
164
165
165
## Additional resources
166
166
@@ -169,4 +169,4 @@ Clients that poll using `HTTP GET` should choose a polling interval that matches
169
169
-[Start a conversation](bot-framework-rest-direct-line-3-0-start-conversation.md)
170
170
-[Reconnect to a conversation](bot-framework-rest-direct-line-3-0-reconnect-to-conversation.md)
171
171
-[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