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/communication-services/concepts/chat/concepts.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,11 +2,11 @@
2
2
title: Chat concepts in Azure Communication Services
3
3
titleSuffix: An Azure Communication Services concept document
4
4
description: Learn about Communication Services Chat concepts.
5
-
author: tophpalmer
6
-
manager: chpalm
5
+
author: kaperla
6
+
manager: sundraman
7
7
services: azure-communication-services
8
8
ms.author: chpalm
9
-
ms.date: 02/22/2023
9
+
ms.date: 02/27/2023
10
10
ms.topic: conceptual
11
11
ms.service: azure-communication-services
12
12
ms.subservice: chat
@@ -18,31 +18,31 @@ Azure Communication Services Chat can help you add real-time text communication
18
18
19
19
The Chat APIs provide an **auto-scaling** service for persistently stored text and data communication. Other key features include:
20
20
21
-
-**Custom Identity and Addressing** - Azure Communication Services provides generic [identities](../identity-model.md)that are used to address communication endpoints. Clients use these identities to authenticate to the Azure service and communicate with each other in `chat threads` you control.
21
+
-**Custom Identity and Addressing** - Azure Communication Services provides generic [identities](../identity-model.md) to address communication endpoints. Clients use these identities to authenticate to the Azure service and communicate with each other in `chat threads` you control.
22
22
-**Encryption** - Chat SDKs encrypt traffic and prevents tampering on the wire.
23
23
-**Microsoft Teams Meetings** - Chat SDKs can [join Teams meetings](../../quickstarts/chat/meeting-interop.md) and communicate with Teams chat messages.
24
24
-**Real-time Notifications** - Chat SDKs use efficient persistent connectivity (WebSockets) to receive real-time notifications such as when a remote user is typing. When apps are running in the background, built-in functionality is available to [fire pop-up notifications](../notifications.md) ("toasts") to inform end users of new threads and messages.
25
-
**Service & Bot Extensibility** - REST APIs and server SDKs allow services to send and receive messages. Bots can be added easily with [Azure Bot Framework integration](../../quickstarts/chat/quickstart-botframework-integration.md).
25
+
-**Service & Bot Extensibility** - REST APIs and server SDKs allow services to send and receive messages. It is easy to add bots with [Azure Bot Framework integration](../../quickstarts/chat/quickstart-botframework-integration.md).
26
26
27
27
28
28
29
29
## Chat overview
30
30
31
31
Chat conversations happen within **chat threads**. Chat threads have the following properties:
32
32
33
-
- A chat thread is uniquely identified by its `ChatThreadId`.
33
+
- A chat thread is identified by its `ChatThreadId`.
34
34
- Chat threads have between zero to 250 users as participants who can send messages to it.
35
35
- A user can be a part an unlimited number of chat threads.
36
36
- Only thread participants can send or receive messages, add participants, or remove participants.
37
-
- Users are automatically added as a participant to any chat threads that they create.
37
+
- Users are added as a participant to any chat threads that they create.
38
38
39
39
### User access
40
-
Typically the thread creator and participants have same level of access to the thread and can execute all related operations available in the SDK, including deleting it. Participants don't have write access to messages sent by other participants, which means only the message sender can update or delete their sent messages. If another participant tries to do that, they'll get an error.
40
+
Typically the thread creator and participants have same level of access to the thread and can execute all related operations available in the SDK, including deleting it. Participants don't have write access to messages sent by other participants, which means only the message sender can update or delete their sent messages. If another participant tries to do that, they get an error.
41
41
42
42
### Chat Data
43
-
Azure Communication Services stores chat messages for 90 days. Chat thread participants can use `ListMessages` to view message history for a particular thread, please note that the API will not return messages once the 90 day period has passed. Users that are removed from a chat thread will be able to view previous message history for 90 days but cannot send or receive new messages. To learn more about data being stored by Communication Services, refer to the [data residency and privacy page](../privacy.md).
43
+
Azure Communication Services stores chat messages for 90 days. Chat thread participants can use `ListMessages` to view message history for a particular thread, please note that the API does not return messages once the 90 day period has passed. Users that are removed from a chat thread will be able to view previous message history for 90 days but cannot send or receive new messages. To learn more about data being stored by Communication Services, refer to the [data residency and privacy page](../privacy.md).
44
44
45
-
For customers that use Virtual appointments, please refer to our Teams interoprability[user privacy] (../interop/guest/privacy#chat-storage) for storage of chat messages in Teams meetings.
45
+
For customers that use Virtual appointments, refer to our Teams Interoperability[user privacy] (../interop/guest/privacy#chat-storage) for storage of chat messages in Teams meetings.
46
46
47
47
### Service limits
48
48
- The maximum number of participants allowed in a chat thread is 250.
@@ -90,7 +90,7 @@ Some SDKs (like the JavaScript Chat SDK) support real-time notifications. This f
90
90
91
91
## Push notifications
92
92
To send push notifications for messages missed by your users while they were away, Communication Services provides two different ways to integrate:
93
-
- Use an Event Grid resource to subscribe to chat related events (post operation) which can be plugged into your custom app notification service. For more details, see [Server Events](../../../event-grid/event-schema-communication-services.md?bc=/azure/bread/toc.json&toc=/azure/communication-services/toc.json).
93
+
- Use an Event Grid resource to subscribe to chat related events (post operation) which can be plugged into your custom app notification service. For more information, see [Server Events](../../../event-grid/event-schema-communication-services.md?bc=/azure/bread/toc.json&toc=/azure/communication-services/toc.json).
94
94
- Connect a Notification Hub resource with Communication Services resource to send push notifications and notify your application users about incoming chats and messages when the mobile app is not running in the foreground.
95
95
96
96
IOS and Android SDK can support the below event:
@@ -105,7 +105,7 @@ To send push notifications for messages missed by your users while they were awa
105
105
-`participantsAdded` - when a user is added as a chat thread participant.
106
106
-`participantsRemoved` - when an existing participant is removed from the chat thread.
107
107
108
-
For more details, see [Push Notifications](../notifications.md).
108
+
For more information, see [Push Notifications](../notifications.md).
109
109
110
110
> [!NOTE]
111
111
> Currently sending chat push notifications with Notification Hub is generally available in Android version 1.1.0 and in IOS version 1.3.0.
0 commit comments