Changes for page b. Chats and Messaging

Last modified by teamwire001 on 2024/11/08 09:26

From version 1.1
edited by teamwire001
on 2021/06/10 09:56
Change comment: Imported from XAR
To version 1.2
edited by teamwire001
on 2021/12/06 10:04
Change comment: api 16 documenation

Summary

Details

Page properties
Content
... ... @@ -1,6 +1,6 @@
1 -Starting Teamwire, the **Chats** tab is shown by default. It shows all chats you have created or are involved in.
1 +Starting Teamwire, the **Chats** tab is shown by default. It shows all chats you are involved in.
2 2  
3 -As you receive new messages, you will find a badge counter on the Chats tab indicating the amount of unread texts.
3 +As you receive new messages, you will find a badge counter on the Chats tab indicating the number of unread texts.
4 4  
5 5  
6 6  {{id name="02-inbox"/}}
... ... @@ -7,7 +7,7 @@
7 7  
8 8  = Inbox =
9 9  
10 -When receiving new messages, the chat concerned is also provided with a badge on the amount of unread texts. This badge will disappear after you have opened/read the chat. In the chat itself, new messages are visually indicated from already read content by a separator.
10 +When receiving new messages, the chat concerned is also provided with a badge on the number of unread texts. This badge will disappear after you have visited the chat. Inside the chat, new messages are visually indicated from already read content by a separator.
11 11  
12 12  
13 13  {{id name="02-search"/}}
... ... @@ -14,193 +14,325 @@
14 14  
15 15  == Search ==
16 16  
17 -Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||queryString="height=20" height="20"]] in the right upper corner of the screen to open a search bar. The search will look up for chat titles, contacts, groups, and message content.
17 +Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||height="20"]] in the upper right corner of the screen to open a search bar. The search will look up for chat titles, contacts, circles and lists, and message content. To leave the search, tap the arrow at the upper left.
18 18  
19 19  
20 20  {{id name="02-createnewchat"/}}
21 21  
22 -= Create new chat =
22 += Create a chat =
23 23  
24 -To create a new chat, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-newchat.png||queryString="height=20" height="20"]] in the bottom right corner of the screen. The creation process has two steps:
24 +To create a new chat, use the button **New chat** in your inbox or tap the menu in the upper right corner of the screen. You can choose from the following options.
25 25  
26 -* [[Select participants>>doc:||anchor="02-selectparticipants"]]
27 -* Define a [[chat title>>doc:||anchor="02-definechattitle"]] and [[further settings>>doc:||anchor="02-definefurthersettings"]]
26 +* 1:1 Chat
27 +* Group Chat
28 +* Broadcast
29 +* Federated Chat
30 +## ##
28 28  
29 -You will enter the newly created chat automatically to send your message.
32 +{{id name="02-onetoonechat"/}}
30 30  
34 +== 1:1 chat ==
31 31  
32 -{{id name="02-selectparticipants"/}}
36 +Select a [[participant>>doc:||anchor="02-selectparticipants"]]. You will enter the new chat automatically and will be able to compose your first message. For 1:1 Chats Teamwire will show the name of the user you are talking to as title. Read here to find out which [[chat content and actions>>doc:||anchor="02-chatcontentsandactions"]] can be used.
33 33  
34 -== Select participants ==
38 +If you want to have topic-based 1:1 chats, use the option [[Group Chat>>doc:||anchor="02-groupchat"]] when creating the chat. It is possible to create a group chat with only one other user (see [[Group Chat>>doc:||anchor="02-groupchat"]]).
35 35  
36 -Select at least one user from your list of contacts and tap **Next.**
40 +(% class="box warningmessage" %)
41 +(((
42 +1:1 chats cannot be subsequently extended with additional users to form a group chat.
43 +)))
37 37  
45 +{{id name="02-groupchat"/}}
38 38  
39 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_create1.png||queryString="width=300" width="300"]]
47 +== Group chat ==
40 40  
49 +Select one or more [[participants>>doc:||anchor="02-selectparticipants"]], set a [[chat title>>doc:||anchor="02-definechattitle"]] and define [[further settings>>doc:||anchor="02-definefurthersettings"]]. You will enter the new chat automatically and will be able to compose your first message.
41 41  
42 -Teamwire classifies your contacts into three types:
51 +More information about chat content and actions are available [[here>>doc:||anchor="02-chatcontentsandactions"]].
43 43  
44 -* **Contacts**
45 -Single user accounts (usually employees and colleagues) your administrator has allowed to communicate with. If Teamwire has been granted access to your address book, you may also find some of these contacts in Teamwire - even though they do not belong to your company directly. For more information, see [[My Contacts>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-mycontacts"]].
46 46  
47 -* **Groups**
48 -Predefined groups of people (similar to a mailing list) your administrator has allowed to communicate with, or you have created yourself. For more information, see [[Groups>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-groups"]].
54 +{{id name="02-broadcastchat"/}}
49 49  
50 -* **Directory**
51 -You can manually search the Directory (former //Enterprise Directory//) for individual internal and external users that have not yet been synchronised. For more information, see [[Directory>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-directory"]].
56 +== Broadcast chat ==
52 52  
53 -The participants (so-called //members//) of your chat can be both individual contacts as well as groups. Please notice the **maximum of members** that can be added to a chat. The number of currently selected users will be shown during the creation (X / 1250 users).
58 +A broadcast chat is a group chat with the [[broadcast mode>>doc:||anchor="02-chatmode"]] enabled. This mode is very useful for sharing announcements or briefings in your organisation.
54 54  
55 -Your list of contacts is arranged in alphabetical order (by the last name) but it still might feel challenging finding your colleagues within an excessive number of users. **To find colleagues and groups more quickly, make use of the search bar** located atop the list of contacts. It will show all user accounts matching your input.
60 +Select one or more [[participants>>doc:||anchor="02-selectparticipants"]], set a [[chat title>>doc:||anchor="02-definechattitle"]] and define [[further settings>>doc:||anchor="02-definefurthersettings"]]. You will enter the new chat automatically and will be able to compose your first message.
56 56  
62 +More information about the broadcast chat mode [[here>>doc:||anchor="02-chatmode"]].
57 57  
58 -{{id name="02-definechattitle"/}}
59 59  
60 -== Define chat title ==
65 +{{id name="02-federatedchat"/}}
61 61  
62 -Define a matching title for your conversation. This title is not final and can be changed at any time via the [[Chat Settings>>doc:||anchor="02-chatsettings"]].
67 +== Federated chat ==
63 63  
69 +Federated chats allow communicating with users from other Teamwire Servers.
64 64  
65 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_create2.png||queryString="width=300" width="300"]]
71 +Select one or more [[participants>>doc:||anchor="02-selectparticipants"]], set a [[chat title>>doc:||anchor="02-definechattitle"]] and define [[further settings>>doc:||anchor="02-definefurthersettings"]]. You will enter the new chat automatically and will be able to compose your first message.
66 66  
67 67  
68 -(% class="box infomessage" %)
69 -(((
70 -**For group chats,** setting a title is **mandatory.**
74 +{{id name="02-federatedchat-contacts"/}}
71 71  
72 -The title is optional for 1:1 chats. If no title has been defined, Teamwire will show the name of the user you are talking to.
73 -)))
76 +=== Available contacts ===
74 74  
78 +The availability of chat participants is limited to contacts and circles that have been enabled for federated usage. Therefore, you cannot create a chat from your organisation's federated and non-federated contacts. In case an important user is not available in your contacts when creating a federated chat, please approach your Teamwire admin.
79 +
80 +Currently it is currently not possible to add more chat members to the chat later.
81 +
82 +
83 +{{id name="02-federatedchat-content"/}}
84 +
85 +=== Available chat content ===
86 +
87 +The range of [[chat content>>doc:||anchor="02-chatcontentsandactions"]] is limited.
88 +
89 +Currently, the following attachment types are supported: photos, (gallery), videos (gallery), files. Attention messages are not supported at the moment.
90 +
91 +
92 +{{id name="02-federatedchat-removed"/}}
93 +
94 +=== Removed federations ===
95 +
96 +If the federation with one or more Teamwire Servers is ended, federated chats are automatically closed. The participants cannot send new content. Unlike [[closed chats>>doc:||anchor="02-closechat"]], the chat history remains available for all members and can still be read.
97 +
98 +
99 +{{id name="02-selectparticipants"/}}
100 +
101 +== Select participants ==
102 +
103 +Select one or more users from your list of contacts by tapping the checkbox next to the user's name.
104 +
105 +Already selected contacts are indicated with an [[image:Public.Applications.Android.User-Manual.WebHome@icon-checked.png||height="20"]] and can be deselected by re-tapping.
106 +
107 +You can combine contacts, lists, circles and bots as chat members. Above the list of contacts, you will see an overview of all selected recipients and also be able to remove them from there.
108 +
109 +Please note the **maximum of members** that can be added to a chat, which will be shown above the overview (Members X / 500) during the creation. The default maximum for a chat is 500 members, but it may have been adjusted by your Teamwire administrator.
110 +
75 75  ## ##
112 +[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_CreateChat1.png||height="615" width="280"]]
113 +## ##
114 +
115 +Your contacts are split into four types and are listed per section.
116 +
117 +* [[Contacts>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-contacts"]]
118 +* [[Lists>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-lists"]]
119 +* [[Circles>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-circles"]]
120 +* [[Bots>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-bots"]]
121 +## ##
122 +
123 +Although all contacts are arranged in alphabetical order (by their last name), in a large organisation it can become challenging to find the right user quickly. Therefore, make use of the **search bar,** to find your contacts, lists, circles and bots per section. The search feature is located in the upper right corner via [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||height="20"]].
124 +
125 +
126 +{{id name="02-definechattitle"/}}
127 +
128 +== Define chat title ==
129 +
130 +Set a title for your conversation. This title is not final and can be changed at any time via [[Chat Settings>>doc:||anchor="02-chatsettings"]]. **For group chats,** setting a title is mandatory.
131 +
132 +## ##
133 +[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_CreateChat2.png||height="615" width="280"]]
134 +## ##
135 +
76 76  {{id name="02-definefurthersettings"/}}
77 77  
78 78  == Define further settings ==
79 79  
80 -* **Chat avatar**
81 -In order to recognise chats more easily, you can set a picture for chat avatar.
82 -
83 -* **Allow to send messages**
84 -You can prohibit other chat members from sending messages to the conversation. This is the so-called **broadcast mode** which allows composing and sending messages only to [[chat administrators>>doc:||anchor="02-chatadministrators"]]. For more information, see [[chat mode>>doc:||anchor="02-chatmode"]].
85 -
86 86  * **Allow to mute notifications**
87 -Decide whether chat members are allowed to mute this conversation.
141 +Decide whether chat members are allowed to mute this conversation so they will no longer receive push notifications.
88 88  
89 89  * **Alert Chat**
90 -This feature is meant for emergencies. An alert chat will always stay on top of its members messages inbox until the content has been read. For more information, see [[alert message>>doc:||anchor="02-alertmessages"]].
144 +This feature is meant for emergencies. An alert chat will always stay on top of its members inbox until its messages has been read. Beside alert chats, you can also create alert messages. More information about alert messages are available at the [[Attention messages>>doc:||anchor="02-attentionmessages"]] chapter.
145 +## ##
91 91  
92 -After defining all further settings, tap **Create** and you will enter the newly created chat automatically to compose and send your message.
147 +After defining all further settings, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-confirm.png||height="20"]] to enter the new chat automatically and you will be able to compose your first message.
93 93  
94 94  
95 95  {{id name="02-emergencyalert"/}}
96 96  
97 -= Emergency Alert (SOS Button) =
152 += Emergency alert (SOS button) =
98 98  
99 -With the Emergency Button you can quickly create a new alert chat with **a predefined group of people.** When creating an alert, your location data (via GPS) will be requested and a voice message will be recorded - both being shared with the chat members.
154 +By using the emergency button, you can quickly create a new alert chat with **a predefined group of users.** When creating an alert, your location data (GPS) will be requested and a voice message will be recorded - both being shared with the chat members.
100 100  
101 -An alert chat will always stay on top of its members messages inbox until the content has been read. For more information, see [[alert message>>doc:||anchor="02-alertmessages"]].
156 +An alert will use a special notification sound to be noticed by the chat members and becomes more prominent in their inboxes. More information are available at the [[Attention messages>>doc:||anchor="02-alertmessages"]] chapter.
102 102  
158 +(% class="box infomessage" %)
159 +(((
160 +If the SOS button is not available to you, the feature may have been disabled by your Teamwire administrator.
161 +)))
103 103  
104 -**Creating a chat with the Emergency Button**
163 +{{id name="02-emergencyalert-configure"/}}
105 105  
106 -When looking at your inbox, you can open the emergency menu by swiping your screen to the right.
165 +== Set up the SOS button ==
107 107  
167 +The group of chat members contacted via the SOS button can be defined at [[Profile > Message settings > SOS Group>>doc:Public.Applications.Android.User-Manual.Settings.WebHome||anchor="05-sosgroup"]]. If you do not define a recipient here, you will have to manually select a circle or list each time you use the button. If your device is managed by a mobile device management, your Teamwire admin may has already set an SOS group which you will not be able to change.
108 108  
109 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_sosbutton.png||queryString="width=300" width="300"]]
110 110  
170 +{{id name="02-emergencyalert-usage"/}}
111 111  
112 -Teamwire will locate your current position via GPS (if Teamwire has been granted access to your location) and will request you to record a voice message (if Teamwire has been granted access to your microphone) to send both information to the chat.
172 +== Use the SOS button ==
113 113  
174 +In your inbox, open the emergency menu by swiping your screen to the right.
175 +
176 +## ##
177 +[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_SOS_Mode.png||height="615" width="280"]]
178 +## ##
179 +
180 +The SOS button will locate your current position via GPS (if Teamwire has been granted access to your location) and will request you to record a voice message (if Teamwire has been granted access to your microphone) to send both information to the chat.
181 +
114 114  To record a voice message
115 115  
116 116  * tap the button once to start a 30 seconds record timer or
117 117  * tap and hold the button as long as you want to record your message.
186 +## ##
118 118  
119 -Afterwards, your location and voice message will be sent to a predefined group of people.
188 +Afterwards, your location and voice message will be sent to a predefined group of users.
120 120  
121 -You can configure the group for the Emergency Button via [[Profile > Message Settings > SOS Group>>doc:Public.Applications.Android.User-Manual.Settings.WebHome||anchor="05-sosgroup"]]. If you have not configured an SOS Group, you will have to select a group manually each time the SOS Button feature is being used. If your phone is being managed by a Mobile Device Management system, your Teamwire administrator might has already defined an SOS group for you which you cannot change.
122 122  
123 -(% class="box" %)
191 +{{id name="02-pushtotalk"/}}
192 +
193 += Push-to-Talk =
194 +
195 +This feature turns your Teamwire app into a walkie talkie by sending voice messages directly to your Push-to-Talk chats and listening to the voice messages you receive.
196 +
197 +(% class="box infomessage" %)
124 124  (((
125 -The Emergency Button feature has to be enabled by your Teamwire administrator. If it is not available to you, it may has been disabled.
199 +If Push-to-Talk is not available to you, the feature may have been disabled by your Teamwire administrator.
126 126  )))
127 127  
202 +{{id name="02-pushtotalk-configure"/}}
203 +
204 +== Set up Push-to-Talk ==
205 +
206 +In you inbox, use the [[image:Public.Applications.Android.User-Manual.WebHome@icon-ptt.png||height="20"]] icon in the upper right corner to open the Push-to-Talk selection menu. Enable the Push-to-Talk ability for all chats required.
207 +
208 +As soon as you have defined at least one Push-to-Talk chat, you can decide via [[image:Public.Applications.Android.User-Manual.WebHome@icon-pttmute.png||height="20"]] whether new messages received in your active channel will be played via **speaker** or if they are **muted.**
209 +
210 +Use [[image:Public.Applications.Android.User-Manual.WebHome@icon-pttdeselect.png||height="20"]] to remove your current selection of chats.
211 +
128 128  ## ##
213 +[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_PTTselection.png||width="280"]]
214 +## ##
215 +
216 +{{id name="02-pushtotalk-usage"/}}
217 +
218 +== Use Push-to-Talk ==
219 +
220 +Your Push-to-Talk chats are displayed at the bottom of the inbox. Simply swipe to switch between your Push-to-Talk chats.
221 +
222 +Tap and hold the button for as long as you want to record your message. As soon as you let go of the button, your message will be shared. The maximum duration of a voice message is 180 seconds.
223 +
224 +## ##
225 +[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_PTTinbox.png||height="615" width="280"]]
226 +## ##
227 +
129 129  {{id name="02-chatcontentsandactions"/}}
130 130  
131 -= Chat contents and actions =
230 += Chat content and actions =
132 132  
133 133  
134 134  {{id name="02-attachments"/}}
135 135  
136 -== Attachments ==
235 +== Attachments and features ==
137 137  
138 -In addition to texts and emojis, you can send various attachments via Teamwire.
237 +In addition to texts and emojis, you can send various attachments via Teamwire. If you want to attach a photo, appointment or the like to your current conversation, choose one of the following options.
139 139  
140 -If you want to attach a photo, appointment, or the like to your current conversation, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attach.png||queryString="height=20" height="20"]] next to your text input field and select the type of file you want to share with the chat.
141 141  
142 -* **Gallery**
143 -Grant access to your gallery to send stored photos and videos.
240 +[[image:Public.Applications.Android.User-Manual.WebHome@icon-camera.png||height="20"]] **Take photo**
241 +
242 +Grant access to your camera to take and send photos or videos. Video recording is limited to 180 seconds.
243 +
244 +
245 +[[image:Public.Applications.Android.User-Manual.WebHome@icon-gallery.png||height="20"]] **Photos and images from gallery**
246 +
247 +Grant access to your gallery to send photos and videos stored on your device.
248 +
249 +
250 +[[image:Public.Applications.Android.User-Manual.WebHome@icon-microphone.png||height="20"]] **Record voice message**
251 +
252 +Grant access to your microphone to record and send a voice message. Voice recording is limited to 180 seconds.
253 +
254 +
255 +[[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png||height="20"]] **Further attachments and features**
256 +
257 +You will be listed further options for sharing content.
258 +
259 +
260 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-alert.png||height="20"]] **Alert,** [[image:Public.Applications.Android.User-Manual.WebHome@icon-annoucement.png||height="20"]] **Announcement** or [[image:Public.Applications.Android.User-Manual.WebHome@icon-note.png||height="20"]] **Note**
261 +These are so-called attention messages. More information about attention messages are available [[here>>doc:||anchor="02-attentionmessages"]].
144 144  
145 -* **Camera**
146 -Grant access to your camera to create and send photos or videos. Video recording is limited to 180 seconds.
263 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-file.png||height="20"]] **File**
264 +Select any further file type via your file manager to share them (e.g. PDF, text file, presentation etc.).
147 147  
148 -* **Voice Message**
149 -Grant access to your microphone to record and send a voice message. The voice message is limited to 180 seconds.
150 -You can also create a voice message by tapping the quick record button [[image:Public.Applications.Android.User-Manual.WebHome@icon-voicerecord.png||queryString="height=20" height="20"]] next to your text input.
266 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-location.png||height="20"]] **Location**
267 +If Teamwire has been granted access to your location data and GPS is enabled, you can either select your current position or choose a POI from the map, to send it to the chat.
151 151  
152 -* **Location**
153 -If Teamwire has been granted access to your location data and your mobile GPS is active, you will be able to select either your current position or choose a POI from the map, to send it to the chat.
154 -
155 -* **Calendar**
269 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-calendar.png||height="20"]] **Calendar**
156 156  Grant access to your calendar to select appointments from your calendar app and attach them.
157 157  
158 -* **File**
159 -Select any further file type via your file manager and attach them (e.g. PDF, text file, presentation, etc.).
160 -
161 -* **Poll**
272 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-poll.png||height="20"]] **Poll**
162 162  Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
274 +## ##
163 163  
164 -(% class="box" %)
276 +(% class="box infomessage" %)
165 165  (((
166 -Your Teamwire administrator is able to prohibit sending certain (or all) attachment types. If they are not available to you, they may have been disabled.
278 +Your Teamwire admin is able to prohibit sending certain attachment types. If one or more options are not available to you, they may have been disabled by your Teamwire administrator.
167 167  )))
168 168  
169 -## ##
170 -{{id name="02-alertmessages"/}}
281 +{{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
171 171  
172 -== Alert messages ==
283 +== Attention messages ==
173 173  
174 -The text input field allows labeling your message as alert by tapping [[image:Public.Applications.Android.User-Manual.WebHome@icon-alarmoff.png||queryString="height=20" height="20"]] If the alert label is activated, the icon and your text input field will turn red: [[image:Public.Applications.Android.User-Manual.WebHome@icon-alarmon.png||queryString="height=20" height="20"]]
285 +Via [[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png||height="20"]] next to the text input field, various attention message types are available in Teamwire.
175 175  
176 -Alerts cause a special ringtone and will create a different icon on the Android notification screen for its participants. A chat containing an alert message will be visually highlighted in its participants inbox, and will always stay on top until all new content has been read.
287 +Chat members can respond to your status messages with a predefined selection of reactions without disrupting the flow of an active conversation. Reactions can also be sent by members of a broadcast chat.
288 +## ##
177 177  
290 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-alert.png||height="20"]] **Alert**
291 +Label your message as an alert (text input turns red). Alerts cause a special ringtone and will create a different icon on the notification screen for its participants. A chat containing an alert message will be visually highlighted in its participants inbox, and will always stay on top until all new content has been read.
292 +The alert notification sound can be configured via [[Profile > Message settings > Alert notification sound>>doc:Public.Applications.Android.User-Manual.Settings.WebHome||anchor="05-notificationsounds"]].
293 +(% class="mark" %)Do not mix things up! An alert message is a single message labelled as alert. If you want to create an alert chat quickly, see [[Emergency alert>>doc:||anchor="02-emergencyalert"]].
178 178  
179 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_sosinbox.png||queryString="width=300" width="300"]]
295 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-annoucement.png||height="20"]] **Announcement**
296 +Label your message as an announcement (text input turns green). Chat members can react to your message via [[image:Public.Applications.Android.User-Manual.WebHome@icon-emptyActivities.png||height="20"]] with a range of reactions.
180 180  
298 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-note.png||height="20"]] **Note**
299 +Label your message as an note (text input turns yellow). Chat members can react to your message via [[image:Public.Applications.Android.User-Manual.WebHome@icon-emptyActivities.png||height="20"]] with a range of reactions.
300 +## ##
181 181  
182 -To remove the alert label, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-alarmon.png||queryString="height=20" height="20"]] again.
302 +All message types above can be removed before sending by tapping the respective option again. Your message will be sent as normal text then.
183 183  
184 -The alert notification sound can be configured via [[Profile > Message Settings > Alert notification sound>>doc:Public.Applications.Android.User-Manual.Settings.WebHome||anchor="05-notificationsounds"]].
185 -
186 186  (% class="box infomessage" %)
187 187  (((
188 -Do not mix things up: An alert message is **a single message labeled as alert.**
189 -
190 -If you want to create an alert chat quickly, see [[Emergency Button>>doc:||anchor="02-emergencyalert"]].
306 +If attention messages are not available to you, the feature may have been disabled by your Teamwire administrator.
191 191  )))
192 192  
193 -(% class="box" %)
309 +{{id name="02-ownattentionmessages"/}}
310 +
311 +=== Activity / Reactions ===
312 +
313 +You can view the **reactions** to one of your attention messages via the [[image:Public.Applications.Android.User-Manual.WebHome@icon-report.png||height="20"]] **report.**
314 +
315 +You can find a chronological list of all reactions to your attention messages via the icon [[image:Public.Applications.Android.User-Manual.WebHome@icon-bell.png||height="20"]] in the upper right corner of the chat.
316 +
317 +
318 +{{id name="02-readreceipts"/}}
319 +
320 +== Read receipts ==
321 +
322 +The [[image:Public.Applications.Android.User-Manual.WebHome@icon-readeye.png||height="15"]] read receipts of chat members are represented by their user avatars and can be found at the bottom of the conversation. Please note, that these read receipts **only apply to the latest message** of the chat and cannot be viewed for previous messages.
323 +
324 +If you are looking for a detailed view of the current read receipts, tap the line of user avatars to receive a complete list of members.
325 +
326 +(% class="box infomessage" %)
194 194  (((
195 -The feature of sending alert messages has to be enabled by your Teamwire administrator. If it is not available to you, it may has been disabled.
328 +Your Teamwire administrator may disable read receipts for all users.
196 196  )))
197 197  
198 -## ##
199 199  {{id name="02-replytomessage"/}}
200 200  
201 201  == Reply to message ==
202 202  
203 -Tap and hold the message or attachment concerned to open the context menu. Select **Reply** to quote the respective message when sending your answer. This is especially useful in conversations with a lot of users to not lose context.
335 +Tap and hold onto the respective message or attachment to open the context menu. Select **Reply** to add a quote of the original message when sending your answer. This is especially useful in conversations with a lot of users so you won't lose context.
204 204  
205 205  
206 206  {{id name="02-copymessage"/}}
... ... @@ -207,19 +207,18 @@
207 207  
208 208  == Copy message ==
209 209  
210 -Tap and hold the message concerned to open the context menu. Select **Copy** to copy the entire message content to your clipboard. You can paste the text into another chat or an external app.
342 +Tap and hold onto the respective message to open the context menu. Select **Copy** to copy the entire message content to your clipboard. You can paste the text to another chat or an external app.
211 211  
212 -(% class="box" %)
344 +(% class="box infomessage" %)
213 213  (((
214 -The feature of copying message content has to be enabled by your Teamwire administrator. If the feature is not available to you, it may has been disabled.
346 +If you cannot copy a message, the feature may have been disabled by your Teamwire administrator.
215 215  )))
216 216  
217 -## ##
218 218  {{id name="02-forwardmessage"/}}
219 219  
220 220  == Forward message ==
221 221  
222 -Tap and hold the message or attachment concerned to open the context menu and select **Forward.** A list of all existing chats to which you can forward the content to will be displayed. If you want to use a new chat to forward the content to, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-newchat.png||queryString="height=20" height="20"]] in the bottom right corner of the screen and continue selecting your participants.
353 +Tap and hold onto the respective message or attachment to open the context menu and select **Forward.** A list of all existing chats to which you can forward the content to will be displayed. If you want to forward to a user or circle that you don't have a chat with yet, tap **New chat** [[image:Public.Applications.Android.User-Manual.WebHome@icon-newchat.png||height="20"]] in the bottom right corner of the screen and continue selecting your participants.
223 223  
224 224  
225 225  {{id name="02-deletemessage"/}}
... ... @@ -226,48 +226,35 @@
226 226  
227 227  == Delete message ==
228 228  
229 -Tap and hold the message or attachment concerned to open the context menu and select **Delete** to remove the content.
360 +You can delete your own messages and attachments in Teamwire, even if they have already been read. Tap and hold the respective message or attachment to open the context menu and select **Delete** to remove it.
230 230  
231 -Please note, the content will be removed for your eyes only and only for the device at hand. Other members of this conversation will still be able to see the removed message/attachment; it will also remain visible to your other device(s) (e.g. your desktop app).
232 -
233 -
234 -{{id name="02-readreceipts"/}}
235 -
236 -== Read receipts ==
237 -
238 -The present [[image:Public.Applications.Android.User-Manual.WebHome@icon-readeye.png||queryString="width=20&height=12" height="12" width="20"]] read receipts of the chat members are represented by their avatars. They can be found at the bottom of the conversation.
239 -Please note, that these read receipts **only apply to the last message** of the chat and cannot be viewed for previous messages.
240 -
241 -If you are looking for a detailed view of the present read receipts, you can tap at the line of user avatars to receive a complete list.
242 -
243 -(% class="box" %)
362 +(% class="box infomessage" %)
244 244  (((
245 -Your Teamwire administrator may disable the feature of the read receipts for all users.
364 +If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
246 246  )))
247 247  
248 -## ##
249 249  {{id name="02-chatsettings"/}}
250 250  
251 -= Chat Settings =
369 += Chat settings =
252 252  
253 -Tap the chat avatar in the right upper corner of the screen to open the Chat Settings. Among other things, here you are able to change the chat title or add more users to the conversation.
371 +Open a chat and tap its chat title at the top to open the chat settings. Among other things, here you can edit the title or add more users to the conversation.
254 254  
255 255  (% class="box infomessage" %)
256 256  (((
257 -Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to the Chat Settings.
375 +Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
258 258  )))
259 259  
378 +## ##
379 +[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_Chatsettings1.png||height="615" width="280"]]
380 +## ##
260 260  
261 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_chatoptions.png||queryString="width=300" width="300"]]
262 -
263 -
264 264  {{id name="02-chatavatar"/}}
265 265  
266 266  == Chat avatar ==
267 267  
268 -Tap on the current chat avatar. You can choose an existing image from **Gallery** or take a photo by tapping **Camera.** The new avatar will be shown to all members of the conversation.
386 +Tap on the current chat avatar. You can choose an existing picture of your photos and images from your **Gallery** or take a photo with your **Camera.** The new avatar will be shown to all members of the conversation.
269 269  
270 -You can tap the current avatar again to **Change** or **Delete** it.
388 +Tap the avatar again to **change** or **remove** the image.
271 271  
272 272  
273 273  {{id name="02-chattitle"/}}
... ... @@ -276,7 +276,7 @@
276 276  
277 277  Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
278 278  
279 -If you want to reset a chat title, remove the current text input and confirm via Enter. The title will adopt the automatically generated name. For group chats, defining your own title is mandatory.
397 +If you want to reset a chat title, remove the current text and confirm via Enter. The title will adopt the automatically generated name. But remember that defining a title is mandatory for group chats.
280 280  
281 281  
282 282  {{id name="02-chatmode"/}}
... ... @@ -287,13 +287,13 @@
287 287  
288 288  * **Normal**
289 289  //Allow to send messages// enabled
290 -By default, the Chat Settings suggest to create a conversation with the //Normal// chat mode enabled. This mode allows all members to compose and send messages / attachments to the chat.
408 +By default, the chat settings suggest to create a conversation with the //Normal// chat mode enabled. This mode allows all members to compose and send messages / attachments to the chat.
291 291  
292 292  * **Broadcast**
293 293  //Allow to send messages// disabled
294 -The //Broadcast// mode will only allow [[chat administrators>>doc:||anchor="02-chatadministrators"]] to compose and send messages / attachments to the chat. This mode is very useful for sharing announcements or briefings in a company.
295 -
412 +The //Broadcast// mode will only allow [[chat administrators>>doc:||anchor="02-chatadministrators"]] to compose and send messages / attachments to the chat. This mode is very useful for sharing announcements or briefings in your organisation.
296 296  ## ##
414 +
297 297  {{id name="02-chatadministrators"/}}
298 298  
299 299  == Chat administrators ==
... ... @@ -300,32 +300,31 @@
300 300  
301 301  This section lists all administrators of the current chat.
302 302  
303 -Chat administrators are able to make changes in the Chat Settings, e.g. editing the chat title and chat mode, allowing to mute the chat, or promote other members to become chat administrator.
421 +Chat administrators are able to make changes in the chat settings, e.g. editing the chat title and chat mode, allowing users to mute the chat, or promote other members to become chat administrator.
304 304  
305 -In a 1:1 chat, both chat members are being administrator by default.
423 +In a 1:1 chat, both members become chat administrator by default.
306 306  
307 -**In a group chat, the creator of the chat is automatically promoted for being administrator** - whether by selecting individual users, by adding groups ([[Organisation Groups>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-organisationgroups"]] or [[User Groups>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-usergroups"]]), or by creating the chat with a mix of both.
425 +**In a group chat, the creator of the chat is automatically promoted to chat administrator.** This applies to all ways of group chats; whether the chat was created by selecting several individual users, by adding [[circles>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-circles"]] or [[lists>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-lists"]], or by a mix of all options mentioned.
308 308  
309 309  
310 310  {{id name="02-promotetoadmin"/}}
311 311  
312 -=== Promote to admin ===
430 +=== Promote to chat admin ===
313 313  
314 -In the Chat Settings, tap [[Members>>doc:||anchor="02-members"]] to see a complete list of the current chat's participants. If the chat was created with a group, you can tap the name of the group to view its list of members. Tap the user concerned and select **Make chat admin.**
432 +In the chat settings, tap [[Members>>doc:||anchor="02-members"]] to see a complete list of the current chat's participants. If the chat was created via circle, tap on its name to view the list of members. Tap the user of concern and select **Make chat admin.**
315 315  
316 316  (% class="box infomessage" %)
317 317  (((
318 -The promotion for being chat administrator cannot be revoked.
436 +The admin promotion cannot be revoked.
319 319  )))
320 320  
321 -## ##
322 322  {{id name="02-demoteadmin"/}}
323 323  
324 -=== Demote admin ===
441 +=== Demote chat admin ===
325 325  
326 -The promotion for being chat administrator cannot be revoked.
443 +The admin promotion cannot be revoked.
327 327  
328 -You may use the following workaround: Remove the user from the current chat and add them again afterwards. Thus the user is being removed from both the list of members and administrators, and will become a chat member only if you add them to the conversation again.
445 +You may use the following workaround: Remove the user from the current chat and add them again afterwards. Thus, the user is being removed from both the list of members and administrators, and will become a regular chat member after adding them again.
329 329  
330 330  
331 331  {{id name="02-members"/}}
... ... @@ -332,35 +332,30 @@
332 332  
333 333  == Members ==
334 334  
335 -This section lists all members of the current chat.
452 +This section lists all members of the current chat incl. chat administrators.
336 336  
337 -If the chat was created with a group (or if one has been added later), you can tap the name of the group to view its list of members.
454 +If the chat was created by adding a circle, its name will be shown. The members of the circle can be viewed by tapping the circle name and selecting **View members.**
338 338  
339 339  
340 340  {{id name="02-addmoremembers"/}}
341 341  
342 -=== Add more members ===
459 +=== Add more members to chat ===
343 343  
344 -In order to add further members to the chat, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attach.png||queryString="height=20" height="20"]] in the right upper corner of the screen to see your list of contacts.
461 +Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png||height="20"]] above the list of chat members. You will be forwarded to your directory from which you can add further users and/or circles and lists. Confirm your selection by tapping **Done.**
345 345  
346 -Select users and groups whom you would like to add and confirm your selection by tapping **Done.**
347 347  
348 -
349 349  {{id name="02-removemembers"/}}
350 350  
351 351  === Remove members ===
352 352  
353 -Tap on a user in the list of members and select **Remove from chat** to have them removed. Users that have been added via a group cannot be removed individually. A group will always need to be removed as a whole.
468 +To remove a user from the chat, tap their name in the list of chat members and select **Remove from chat.** You cannot remove individual users which have been added via circle. You have to remove the complete circle from the chat instead.
354 354  
355 -**Quick editing**
356 -When viewing the list of chat members, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attach.png||queryString="height=20" height="20"]] in the right upper corner of the screen to remove multiple contacts from the chat. Confirm your changes by tapping **Done.**
357 357  
358 -
359 359  {{id name="02-mediaoverview"/}}
360 360  
361 -= Media Overview =
473 += Media overview =
362 362  
363 -Below the Chat Settings you will find the **Media Overview,** which allows you to look up for all attachments and alarms that have been sent in the current chat. The media is filtered by its file type, but can also be viewed unfiltered via //All attachments.//
475 +Below the chat settings you will find the **Media overview,** which allows you to look up for all attachments and attention messages that have been shared in the current chat. The media is filtered by its file type, but can also be viewed unfiltered via //All attachments.//
364 364  
365 365  
366 366  {{id name="02-chatadministration"/}}
... ... @@ -367,53 +367,62 @@
367 367  
368 368  = Chat administration =
369 369  
370 -Below the Media Overview you will find options to manage the current conversation, like muting, archiving and exiting the chat, or sending the chat history via email.
482 +Below the media overview you will find the chat administration.
371 371  
484 +## ##
485 +[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_Chatsettings2.png||height="615" width="280"]]
486 +## ##
372 372  
373 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_chatoptions_archive.png||queryString="width=300" width="300"]]
374 -
375 -
376 376  {{id name="02-mutechat"/}}
377 377  
378 378  == Mute chat ==
379 379  
380 -Mute a chat to stop receiving notifications. When muted, the notification sound, vibration and push notifications will not be triggered **for this chat.** The app icon on your home screen will keep showing the amount of unread messages.
492 +This is a personal setting and will only affect your own user account.
381 381  
494 +Mute a chat to stop receiving notifications. When muted, the notification sound, vibration and push notifications will not be triggered **for this chat.** The app icon on your home screen will keep showing the number of unread messages.
495 +
382 382  There are two options to mute a chat
383 383  
384 -* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Mute** action is located below the Media Overview.
385 -* In your inbox, tap and hold the chat concerned to open the context menu and select **Mute.**
498 +* Open the respective chat and view its chat settings by tapping its avatar and title. The option **Mute** can be found below the media overview.
499 +* In your **inbox,** tap and hold the chat of concern to open the context menu and select **Mute.**
500 +## ##
386 386  
387 387  You can re-enable notifications for a chat in the same way.
388 388  
389 -(% class="box" %)
504 +(% class="box infomessage" %)
390 390  (((
391 -Chat administrators are able to prohibit muting a chat. If the feature is not available to you, it may has been disabled.
506 +If you cannot mute a chat, the feature may have been disabled by your Teamwire administrator or by a chat admin.
392 392  )))
393 393  
394 -## ##
395 395  {{id name="02-archivechat"/}}
396 396  
397 397  == Archive chat ==
398 398  
513 +This is a personal setting and will only affect your own user account.
514 +
399 399  Archive a chat when the conversation is no longer active or when a topic-based discussion is completed. Archived chats are not displayed in your message inbox by default.
400 400  
401 401  There are two options to archive a chat
402 402  
403 -* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Archive** action is located below the Media Overview.
404 -* In your inbox, tap and hold the chat concerned to open the context menu and select **Archive.**
519 +* Open the respective chat and view its chat settings by tapping its avatar and title. The option **Archive** can be found below the media overview.
520 +* In your **inbox,** tap and hold the chat of concern to open the context menu and select **Archive.**
521 +## ##
405 405  
406 -To display archived chats in your inbox, activate the option **Show archived chats** via the menu in the right upper corner of the screen. While viewing your archived chats, you can **unarchive** a conversation again in the same way as mentioned above.
523 +To display archived chats in your inbox, activate the option **Show archived chats** via the menu in the upper right corner of the inbox. While viewing your archived chats, you can **Unarchive** a conversation again as archiving was described above.
407 407  
408 408  
409 409  {{id name="02-emailchathistory"/}}
410 410  
411 -== Email chat history ==
528 +== Send chat history ==
412 412  
413 -Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. Tap **Email Chat History** to forward the conversation in plain text to your default mail app and send it. The action is located below the Media Overview.
530 +Open the respective chat and view its chat settings by tapping its avatar and title. Select [[image:Public.Applications.Android.User-Manual.WebHome@icon-send.png||height="20"]] **Send** to transfer the conversation in plain text to your default mail app. The action can be found below the media overview.
414 414  
415 415  Please note that attachments cannot be transferred to the mail.
416 416  
534 +(% class="box infomessage" %)
535 +(((
536 +If the "Send" option is not available to you, the feature may have been disabled by your Teamwire administrator.
537 +)))
417 417  
418 418  {{id name="02-leavechat"/}}
419 419  
... ... @@ -423,12 +423,37 @@
423 423  
424 424  There are two options to leave a chat
425 425  
426 -* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Leave chat** action is located below the Media Overview.
427 -* In your inbox, tap and hold the chat concerned to open the context menu and select **Leave.**
547 +* Open the respective chat and view its chat settings by tapping its avatar and title. The option **Leave** can be found below the media overview.
548 +* In your **inbox,** tap and hold the chat of concern to open the context menu and select **Leave.**
549 +## ##
428 428  
429 -(% class="box" %)
551 +(% class="box infomessage" %)
430 430  (((
431 -Please note that you cannot leave chats in which you have been added as part of a [[Organisation Group>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-organisationgroups"]]. If you were added as a member of a [[User Group>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-usergroups"]], you will have to confirm your withdrawal of the group first. You will then automatically leave the chat.
553 +If the "Leave" option is not available to you, the feature may have been disabled by your Teamwire administrator.
554 +
555 +Please note that you cannot leave chats in which you have been added as part of a [[circle>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-circles"]].
432 432  )))
433 433  
558 +{{id name="02-closechat"/}}
559 +
560 +== Close chat ==
561 +
562 +This is an administrative setting and will affect all members of the chat. Only chat administrators can close a chat.
563 +
564 +Close a chat when the conversation is over and no longer needed.
565 +After it has been closed, the chat will show an according info message and the chat history can no longer be read by its members.
566 +
567 +There are two options to close a chat
568 +
569 +* Open the respective chat and view its chat settings by tapping its avatar and title. The option **Close chat** can be found below the media overview.
570 +* In your **inbox,** tap and hold the chat of concern to open the context menu and select **Close.**
434 434  ## ##
572 +
573 +You can **reopen** the chat in the same way if you are the chat administrator.
574 +
575 +(% class="box infomessage" %)
576 +(((
577 +If the "Close" option is not available to you, the feature may have been disabled by your Teamwire administrator.
578 +)))
579 +
580 +## ##