Changes for page b. Chats and Messaging

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

From version 2.4
edited by teamwire001
on 2022/08/19 14:30
Change comment: DOC-125: Update available chat content / attachments in federation chats
To version 5.1
edited by teamwire001
on 2024/11/08 09:03
Change comment: DOC-345

Summary

Details

Page properties
Content
... ... @@ -1,40 +1,36 @@
1 -Starting Teamwire, the [[image:Public.Applications.iOS.User-Manual.WebHome@icon-tabmessages.png||height="20"]] **Messages** tab is shown by default. It shows all chats you are involved in.
1 +When starting Teamwire, the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-messages.svg]] **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 number of unread texts.
3 +As you receive new messages, you will find a badge on the Chats tab showing the number of **unread chats**. The respective chat which received new messages will have a badge showing the number of **unread messages**. Inside the chat, new messages are visually indicated from already read content by a separator.
4 4  
5 5  
6 -{{id name="02-inbox"/}}
6 +{{id name="02-filter"/}}
7 7  
8 8  = Inbox =
9 9  
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.
10 +Your inbox provides four tabs which allow you to switch between the most important chat type criteria.
11 11  
12 +* **All**
13 +The default tab which will show you read and unread, favourite and non-favourite, 1:1 and group chats or broadcasts alike. Archived chats are not shown.
12 12  
13 -{{id name="02-filter"/}}
15 +* **Favourites**
16 +This tab lists all your [[favourite chats>>doc:||anchor="chaction-favourite"]].
14 14  
15 -== Filter ==
18 +* **Unread**
19 +This tab lists all chats with new messages and chats you have [[marked as unread>>doc:||anchor="chaction-unread"]].
16 16  
17 -You can filter your inbox by four criteria. To do so, tap the [[image:Public.Applications.iOS.User-Manual.WebHome@icon-dropdown.png||height="12"]] **drop-down menu** atop your messages and select the type of chat concerned.
21 +* **Archived**
22 +This tab lists all your [[archived chats>>doc:||anchor="02-archivechat"]].
23 +## ##
18 18  
19 -* **All chats**
20 -As the app is being started, this is its default view. This filter shows both 1:1 chats and group chats. Archived chats are not being shown.
21 -
22 -* **1:1 chats**
23 -This filter shows 1:1 conversations only. Archived 1:1 chats are being displayed as well.
24 -A 1:1 chat is a conversation with exactly one other user.
25 -
26 -* **Group chats**
27 -Only group conversations are being shown. Archived group chats are being displayed as well.
28 -
29 -* **Archived chats**
30 -All archived chats are being shown - for both 1:1 chats and group chats.
31 31  ## ##
26 +[[image:Public.Applications.iOS.User-Manual.WebHome@inbox-1.png||width="280px"]]
27 +## ##
32 32  
33 33  {{id name="02-search"/}}
34 34  
35 -== Search ==
31 += Search =
36 36  
37 -Swiping down in your inbox will make the search bar appear atop your messages. The search will look up for chat titles, contacts, circles and lists, and message content. To stop and leave the search bar, tap **Cancel.**
33 +Swiping down in your inbox will make the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-search.svg]] search bar appear atop your chats. The search will look up for chat titles, contacts, lists and circles, bots, and message content. To stop and leave the search bar, tap **Cancel**.
38 38  
39 39  
40 40  {{id name="02-createnewchat"/}}
... ... @@ -41,12 +41,16 @@
41 41  
42 42  = Create a chat =
43 43  
44 -To create a new chat, use the button [[image:Public.Applications.iOS.User-Manual.WebHome@icon-newchat.png||height="20"]] in the upper right corner of the screen. You can choose from the following options.
40 +To create a new chat, use the button [[image:Public.Applications.iOS.User-Manual.WebHome@icons-chat-new.svg]] in the lower-right corner of the screen, where you can then choose from the following options.
45 45  
46 -* 1:1 Chat
47 -* Group Chat
48 -* Broadcast
49 -* Federated Chat
42 +
43 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-user.svg||height="20"]] [[1:1 Chat>>doc:||anchor="02-onetoonechat"]]
44 +
45 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-group.svg||height="22"]] [[Group Chat>>doc:||anchor="02-groupchat"]]
46 +
47 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-broadcast.svg||height="21"]] [[Broadcast>>doc:||anchor="02-broadcastchat"]]
48 +
49 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-federated.svg||height="20"]] [[Federated Chat>>doc:||anchor="02-federatedchat"]]
50 50  ## ##
51 51  
52 52  {{id name="02-onetoonechat"/}}
... ... @@ -97,7 +97,7 @@
97 97  
98 98  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.
99 99  
100 -Currently it is currently not possible to add more chat members to the chat later.
100 +Currently, it is not possible to add more chat members to the chat later.
101 101  
102 102  
103 103  {{id name="02-federatedchat-content"/}}
... ... @@ -122,36 +122,37 @@
122 122  
123 123  Select one or more users from your list of contacts by tapping the checkbox next to the user's name.
124 124  
125 -Already selected contacts are indicated with an [[image:Public.Applications.iOS.User-Manual.WebHome@icon-checked.png||height="20"]] and can be deselected by re-tapping.
125 +Already selected contacts are indicated with an  [[image:Public.Applications.iOS.User-Manual.WebHome@icons_box_selected.svg]] and can be deselected by re-tapping.
126 126  
127 -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.
127 +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.
128 128  
129 129  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.
130 130  
131 -## ##
132 -[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__CreateChat1.png||height="581" width="280"]]
133 -## ##
134 134  
135 135  Your contacts are split into four types and are listed per section.
136 136  
137 -* [[Contacts>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-contacts"]]
138 -* [[Lists>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-lists"]]
139 -* [[Circles>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-circles"]]
140 -* [[Bots>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-bots"]]
134 +
135 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-user.svg||height="20"]] [[Contacts>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-contacts"]]
136 +
137 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-userlist.svg]] [[Lists>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-lists"]]
138 +
139 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-circle.svg||height="21"]] [[Circles>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-circles"]]
140 +
141 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-bot.svg||height="22"]] [[Bots>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-bots"]]
141 141  ## ##
142 142  
143 -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.
144 +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 [[image:Public.Applications.iOS.User-Manual.WebHome@icons-search.svg]] search bar, to find your contacts, lists, circles and bots per section.
144 144  
146 +## ##
147 +[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-create1.png||width="280px"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-create2.png||width="280px"]]
148 +## ##
145 145  
146 146  {{id name="02-definechattitle"/}}
147 147  
148 -== Define chat title ==
152 +== Define title ==
149 149  
150 150  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.
151 151  
152 -## ##
153 -[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__CreateChat2.png||height="581" width="280"]]
154 -## ##
155 155  
156 156  {{id name="02-definefurthersettings"/}}
157 157  
... ... @@ -159,12 +159,12 @@
159 159  
160 160  * **Allow to mute notifications**
161 161  Decide whether chat members are allowed to mute this conversation so they will no longer receive push notifications.
162 -
163 +
163 163  * **Alert Chat**
164 164  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.
165 165  ## ##
166 166  
167 -After defining all further settings, tap **Create** to enter the new chat automatically and you will be able to compose your first message.
168 +After defining all further settings, tap **Create** to enter the new chat automatically, and you will be able to compose your first message.
168 168  
169 169  
170 170  {{id name="02-voipcall"/}}
... ... @@ -188,9 +188,9 @@
188 188  
189 189  Open an existing chat or [[create a new chat>>doc:||anchor="02-createnewchat"]] with your favoured participants.
190 190  
191 -Start the call by tapping the respective button in the upper right corner of the screen.
192 +Start the call by tapping the respective button in the upper-right corner of the screen.
192 192  
193 -Use ## ##[[image:Public.Applications.iOS.User-Manual.WebHome@icon-voipvoice11.png||height="20"]]## ## to start a voice call and ## ##[[image:Public.Applications.iOS.User-Manual.WebHome@icon-voipvideo11.png||height="20"]]## ## to start a video call. You may enable your camera at any time during the voice call and turn it into a video call. You may disable your camera at any time of the video call, too.
194 +Use  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-call-voice.svg]] to start a voice call and [[image:Public.Applications.iOS.User-Manual.WebHome@icons-call-video.svg]] to start a video call. You may enable your camera at any time during the voice call and turn it into a video call. You may disable your camera at any time of the video call, too.
194 194  
195 195  The other call participants will be notified, even if they are currently not actively using the Teamwire app.
196 196  
... ... @@ -197,8 +197,11 @@
197 197  
198 198  **The number of participants for group calls is limited** and given by your Teamwire server admin.
199 199  
200 -If your group chat has more participants than the number of members allowed in a group call, the icons will change a bit into ## ##[[image:Public.Applications.iOS.User-Manual.WebHome@icon-voipvoicegroup.png||height="20"]]## ## for voice and ## ##[[image:Public.Applications.iOS.User-Manual.WebHome@icon-voipvideogroup.png||height="20"]]## ## for video calls. Before the call can begin, you will be shown the list of all chat members from which you have to select one or more users (up to the max. number of call members) for the call.
201 +If your group chat has more participants than the number of members allowed in a group call, the icons will change a bit into  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-call-voice-plus.svg]] for voice and [[image:Public.Applications.iOS.User-Manual.WebHome@icons-call-video-plus.svg]] for video calls. Before the call can begin, you will be shown the list of all chat members from which you have to select one or more users (up to the max. number of call members) for the call.
201 201  
203 +## ##
204 +[[image:Public.Applications.iOS.User-Manual.WebHome@chatview-1||width="280px"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@videocall-1.png||width="280px"]]
205 +## ##
202 202  
203 203  {{id name="02-voipcall-join"/}}
204 204  
... ... @@ -208,6 +208,9 @@
208 208  
209 209  Open the chat you were invited into to participate in the voice or video call. If the call is still ongoing, tap **Join** to access the call.
210 210  
215 +## ##
216 +[[image:Public.Applications.iOS.User-Manual.WebHome@chatview-2.png||width="280px"]]
217 +## ##
211 211  
212 212  {{id name="02-voipcall-features"/}}
213 213  
... ... @@ -221,55 +221,65 @@
221 221  * Screen sharing
222 222  * Raise hand
223 223  * Toggle between front and backside camera
224 -
225 225  ## ##
226 226  
227 227  {{id name="02-emergencyalert"/}}
228 228  
229 -= Emergency alert (SOS button) =
235 += Emergency alert =
230 230  
231 -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.
237 +This feature is meant for emergencies, allowinyou to quickly create a new chat with a selected group of contacts, including an alert, a voice message (which you will record), and your current location.
232 232  
233 -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.
239 +The emergency alert won't ask for a chat title or additional settings. Alerts use a distinct notification sound in contrast to regular chat messages to captivate the attention of its recipients. Alerts stay on top of their inbox until they react to the message. In addition, alerts can bypass the silent mode of the other chat members, if they have granted the respective permission to Teamwire.
234 234  
235 235  (% class="box infomessage" %)
236 236  (((
237 -If the SOS button is not available to you, the feature may have been disabled by your Teamwire administrator.
243 +If the emergency alert is not available to you, the feature may have been disabled by your Teamwire administrator.
238 238  )))
239 239  
240 -{{id name="02-emergencyalert-configure"/}}
246 +## ##
247 +[[image:Public.Applications.iOS.User-Manual.WebHome@emergency-1.png||width="280px"]]
248 +## ##
241 241  
242 -== Set up the SOS button ==
250 +{{id name="02-emergencyalert-usage"/}}
243 243  
244 -The group of chat members contacted via the SOS button can be defined at [[Profile > Message settings > SOS Group>>doc:Public.Applications.iOS.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.
252 +== Usage ==
245 245  
254 +(% class="box infomessage" %)
255 +(((
256 +This feature requires permission to use your location and microphone in order to work correctly.
257 +)))
246 246  
247 -{{id name="02-emergencyalert-usage"/}}
259 +Tap the  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-emergency.svg]] **Emergency **icon at the top of your inbox to open the screen.
248 248  
249 -== Use the SOS button ==
261 +Select one of your circles or lists in the **Send to** section. If you have predefined a [[Default circle>>doc:||anchor="02-emergencyalert-configure"]], you can skip this step, or change the selected circle or list.
250 250  
251 -In your inbox, open the emergency menu by swiping your screen to the right.
263 +You have two options for recording your voice message, which will be sent together with an alert and your current location.
252 252  
265 +* Tap the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-emergency-record.svg||height="38px" width="38px"]] **Record button** once to start recording a voice message (of 30 seconds)  without keeping your device at hand. You will see a respective countdown.
266 +** After 30 seconds, the alert will be sent automatically, including your voice message and your location.
267 +** Cancel your recording during the countdown by tapping the record button again **(X)**.
268 +
269 +* Tap and hold the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-emergency-record.svg||height="38px" width="38px"]] **Record button** to record a voice message for as long as you want to.
270 +** Release the button to send the alert, including your voice message and your location.
271 +** Swipe up to cancel the recording and the process.
253 253  ## ##
254 -[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__SOS_Button.png||height="581" width="280"]]
255 -## ##
256 256  
257 -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.
274 +{{id name="02-emergencyalert-configure"/}}
258 258  
259 -To record a voice message
276 +== Default circle ==
260 260  
261 -* tap the button once to start a 30 seconds record timer or
262 -* tap and hold the button as long as you want to record your message.
263 -## ##
278 +Define a default group of contacts (in the form of a circle or list) to avoid selecting the recipients manually every time you use the emergency alert. Go to [[Account ~> App settings ~> Emergency alerts>>doc:Public.Applications.iOS.User-Manual.Profile.WebHome||anchor="05-sosgroup"]] and select a circle or list from your directory.
264 264  
265 -Afterwards, your location and voice message will be sent to a predefined group of users.
280 +Despite configuring a Default circle, you can still edit the **Send to** section, if you'd like to, before starting to record your message.
266 266  
282 +If your device is managed by a mobile device management, your Teamwire administrator may have already set a Default Circle, which you will not be able to change.
267 267  
284 +
268 268  {{id name="02-pushtotalk"/}}
269 269  
270 270  = Push-to-Talk =
271 271  
272 -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.
289 +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.
273 273  
274 274  (% class="box infomessage" %)
275 275  (((
... ... @@ -278,79 +278,67 @@
278 278  
279 279  {{id name="02-pushtotalk-configure"/}}
280 280  
281 -== Set up Push-to-Talk ==
298 +== Setup ==
282 282  
283 -In your inbox, use the [[image:Public.Applications.iOS.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.
300 +In your inbox, use the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-voice.svg]] icon in the upper-right corner to open the Push-to-Talk selection menu. Enable the Push-to-Talk ability for all chats required.
284 284  
285 -As soon as you have defined at least one Push-to-Talk chat, you can decide via [[image:Public.Applications.iOS.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.**
302 +As soon as you have defined at least one Push-to-Talk chat, you can decide via [[image:Public.Applications.iOS.User-Manual.WebHome@icons-sound-on.svg]] whether new messages received in your active channel will be played via **speaker** or if they are **muted.**
286 286  
287 -Use [[image:Public.Applications.iOS.User-Manual.WebHome@icon-pttdeselect.png||height="20"]] to remove your current selection of chats.
304 +Use [[image:Public.Applications.iOS.User-Manual.WebHome@icons-dnd.svg]] to remove your current selection of chats.
288 288  
289 289  ## ##
290 -[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__PTT_Selection.png||height="583" width="280"]]
307 +[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-ptt1.png||width="280px"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@pushtt-1.png||width="280px"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@pushtt-2.png||width="280px"]]
291 291  ## ##
292 292  
293 293  {{id name="02-pushtotalk-usage"/}}
294 294  
295 -== Use Push-to-Talk ==
312 +== Usage ==
296 296  
297 297  Your Push-to-Talk chats are displayed at the bottom of the inbox. Simply swipe to switch between your Push-to-Talk chats.
298 298  
299 299  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.
300 300  
301 -## ##
302 -[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__PTT_Inbox.png||height="583" width="280"]]
303 -## ##
304 304  
305 -{{id name="02-chatcontentsandactions"/}}
319 +{{id name="02-attachments"/}} {{id name="02-chatcontentsandactions"/}}
306 306  
307 -= Chat content and actions =
321 += Attachments =
308 308  
323 +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.
309 309  
310 -{{id name="02-attachments"/}}
311 311  
312 -== Attachments and features ==
313 -
314 -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.
315 -
316 -
317 -[[image:Public.Applications.iOS.User-Manual.WebHome@icon-camera.png||height="20"]] **Take photo**
318 -
326 +[[image:Public.Applications.iOS.User-Manual.WebHome@icons-camera.svg]] **Take photo**
319 319  Grant access to your camera to take and send photos or videos. Video recording is limited to 180 seconds.
320 320  
321 321  
322 -[[image:Public.Applications.iOS.User-Manual.WebHome@icon-gallery.png||height="20"]] **Photos and images from gallery**
323 -
330 +[[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-image.svg]] **Photos and images from gallery**
324 324  Grant access to your gallery to send photos and videos stored on your device.
325 325  
326 326  
327 -[[image:Public.Applications.iOS.User-Manual.WebHome@icon-microphone.png||height="20"]] **Record voice message**
328 -
334 +[[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-voice.svg]] **Record voice message**
329 329  Grant access to your microphone to record and send a voice message. Voice recording is limited to 180 seconds.
330 330  
331 331  
332 -[[image:Public.Applications.iOS.User-Manual.WebHome@icon-attachments.png||height="20"]] **Further attachments and features**
333 -
338 +[[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach.svg]] **Further attachments and features**
334 334  You will be listed further options for sharing content.
335 335  
336 336  
337 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-alert.png||height="20"]] **Alert,** [[image:Public.Applications.iOS.User-Manual.WebHome@icon-annoucement.png||height="20"]] **Announcement** or [[image:Public.Applications.iOS.User-Manual.WebHome@icon-note.png||height="20"]] **Note**
342 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-am-alert.svg]] **Alert,** ## ##[[image:Public.Applications.iOS.User-Manual.WebHome@icons-am-announce.svg]] **Announcement** or ## ##[[image:Public.Applications.iOS.User-Manual.WebHome@icons-am-note.svg]] **Note**
338 338  These are so-called attention messages. More information about attention messages are available [[here>>doc:||anchor="02-attentionmessages"]].
339 339  
340 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-file.png||height="20"]] **File**
345 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-file.svg]] **File**
341 341  Select any further file type via your file manager to share them (e.g. PDF, text file, presentation etc.).
342 342  
343 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-location.png||height="20"]] **Location**
348 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-location.svg]] **Location**
344 344  If Teamwire has been granted access to your location data and GPS is enabled, you can send your current position or a POI to the chat.
345 345  You can also choose to share your live location with the chat members. More information about the live location feature are available [[here>>doc:||anchor="02-livelocation"]].
346 346  
347 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-calendar.png||height="20"]] **Calendar**
352 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-calendar.svg]] **Calendar**
348 348  Grant access to your calendar to select appointments from your calendar app and attach them.
349 349  
350 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-poll.png||height="20"]] **Poll**
355 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-poll.svg]] **Poll**
351 351  Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
352 352  
353 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-dracoon.png||height="20"]] **Dracoon**
358 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-dracoon.svg]] **Dracoon**
354 354  This option is available if you have the [[Dracoon app>>https://apps.apple.com/gb/app/dracoon/id1382260906||rel="noopener noreferrer" target="_blank"]] installed. Select **Dracoon** and log in to your Dracoon user account to grant access to Teamwire. When sharing a Dracoon file in a chat, instead of sending the media itself, a link to the Dracoon exchange server is automatically generated. The chat participants can click on the link to view and download the file.
355 355  ## ##
356 356  
... ... @@ -359,25 +359,52 @@
359 359  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.
360 360  )))
361 361  
367 +## ##
368 +[[image:Public.Applications.iOS.User-Manual.WebHome@chatview-3.png||width="280px"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@chatview-4.png||width="280px"]]
369 +## ##
370 +
371 +{{id name="02-mentions"/}}
372 +
373 += Mentions =
374 +
375 +Mention other chat members by typing an **@-symbol**.
376 +
377 +You can mention single users, multiple users, or use **@All** to include all members of your conversation. Continue typing a colleagues name after the @ to limit the selection of available user mentions.
378 +
379 +## ##
380 +[[image:Public.Applications.iOS.User-Manual.WebHome@EN__mobile-mentions_001.png||width="280"]]
381 +## ##
382 +
383 +When mentioned, you will receive a push notification and the respective chat will dispaly the mention with an **@-symbol** in your inbox.
384 +
385 +## ##
386 +[[image:Public.Applications.iOS.User-Manual.WebHome@EN__mobile-mentions_002.png||width="280"]]
387 +## ##
388 +
389 +When selecting a chat where you have been mentioned, you will see the number of mentions. Tap the **@-button** to jump directly to the mention(s).
390 +
391 +## ##
392 +[[image:Public.Applications.iOS.User-Manual.WebHome@EN__mobile-mentions_003.png||width="280"]]
393 +## ##
394 +
362 362  {{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
363 363  
364 -== Attention messages ==
397 += Attention messages =
365 365  
366 -Via [[image:Public.Applications.iOS.User-Manual.WebHome@icon-attachments.png||height="20"]] next to the text input field, various attention message types are available in Teamwire.
399 +Via [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach.svg]] next to the text input field, various attention message types are available in Teamwire.
367 367  
368 368  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.
369 369  ## ##
370 370  
371 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-alert.png||height="20"]] **Alert**
372 -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.
373 -The alert notification sound can be configured via [[Profile > Message settings > Alert notification sound>>doc:Public.Applications.iOS.User-Manual.Settings.WebHome||anchor="05-notificationsounds"]].
404 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-am-alert.svg]] **Alert**
405 +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. The alert notification sound can be configured via [[Account ~> App settings ~> Notifications>>doc:Public.Applications.iOS.User-Manual.Profile.WebHome||anchor="05-notificationsounds"]].
374 374  (% 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"]].
375 375  
376 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-annoucement.png||height="20"]] **Announcement**
377 -Label your message as an announcement (text input turns green). Chat members can react to your message via [[image:Public.Applications.iOS.User-Manual.WebHome@icon-emptyActivities.png||height="20"]] with a range of reactions.
408 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-am-announce.svg]] **Announcement**
409 +Label your message as an announcement (text input turns green). Chat members can react to your message via  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-emojithumb.svg]] with a range of reactions.
378 378  
379 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-note.png||height="20"]] **Note**
380 -Label your message as a note (text input turns yellow). Chat members can react to your message via [[image:Public.Applications.iOS.User-Manual.WebHome@icon-emptyActivities.png||height="15"]] with a range of reactions.
411 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-am-note.svg]] **Note**
412 +Label your message as a note (text input turns yellow). Chat members can react to your message via  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-emojithumb.svg]] with a range of reactions.
381 381  ## ##
382 382  
383 383  All message types above can be removed before sending by tapping the respective option again. Your message will be sent as normal text then.
... ... @@ -389,30 +389,30 @@
389 389  
390 390  {{id name="02-ownattentionmessages"/}}
391 391  
392 -=== Activity / Reactions ===
424 +== Activity / Reactions ==
393 393  
394 -You can view the **reactions** to one of your attention messages via the [[image:Public.Applications.iOS.User-Manual.WebHome@icon-report.png||height="20"]] **report.**
426 +You can view the **reactions** to one of your attention messages via the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-report.svg]] **report.**
395 395  
396 -You can find a chronological list of all reactions to your attention messages via the icon [[image:Public.Applications.iOS.User-Manual.WebHome@icon-bell.png||height="20"]] in the upper right corner of the chat.
428 +You can find a chronological list of all reactions to your attention messages via the icon [[image:Public.Applications.iOS.User-Manual.WebHome@icons-notification.svg]] in the upper-right corner of the chat.
397 397  
398 398  
399 399  {{id name="02-livelocation"/}}
400 400  
401 -== Live location ==
433 += Live location =
402 402  
403 403  This feature allows other users to track your current location live on a map.
404 404  
405 -To share your live location, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icon-attachments.png||height="20"]] next to the text input field, select [[image:Public.Applications.iOS.User-Manual.WebHome@icon-location.png||height="20"]] **Location** and **Share your live location.**
437 +To share your live location, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach.svg]] next to the text input field, select [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-location.svg]] **Location** and [[image:Public.Applications.iOS.User-Manual.WebHome@icons-livelocation.svg]] **Share your live location.**
406 406  
407 407  Open the live map and check your current position by tapping on the map preview in the chat.
408 408  
409 409  ## ##
410 -[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__Livelocation.png||width="280"]]
442 +[[image:Public.Applications.iOS.User-Manual.WebHome@livelocation-1.png||width="280px"]]
411 411  ## ##
412 412  
413 413  {{id name="02-livelocation-duration"/}}
414 414  
415 -=== Sharing duration ===
447 +== Sharing duration ==
416 416  
417 417  As you start the live location feature, you can select for how long you want to share it.
418 418  
... ... @@ -423,7 +423,7 @@
423 423  
424 424  {{id name="02-livelocation-stop"/}}
425 425  
426 -=== Stop sharing manually ===
458 +== Stop sharing manually ==
427 427  
428 428  If you want to cancel sharing your live location before the selected duration, you can do so in the chat or map view by tapping **Stop sharing.**
429 429  
... ... @@ -430,7 +430,7 @@
430 430  
431 431  {{id name="02-livelocation-multiple"/}}
432 432  
433 -=== Multiple users sharing ===
465 +== Multiple users sharing ==
434 434  
435 435  In one chat, multiple users can share their live location at the same time. Their locations will be shown in a single map.
436 436  
... ... @@ -439,25 +439,27 @@
439 439  
440 440  {{id name="02-livelocation-additional"/}}
441 441  
442 -=== Additional features ===
474 +== Additional features ==
443 443  
444 444  The live map offers different tools and settings to view users and map material.
445 445  
446 446  * **Focus user**
447 -Tap on one of the users to focus on them. This way, the user will always remain in the center of the map view.
448 -You can also select the user from the list of all chat members currently sharing their location.
449 -
450 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-locationcenter.png||height="18"]] **Center map**
479 +Tap on one of the users to focus on them. This way, the user will always remain in the center of the map view. You can also select the user from the list of all chat members currently sharing their location.
480 +
481 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-near.svg]] **Center map**
451 451  Tap on the symbol to center the view on your current location.
452 -
453 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-locationregroup.png||height="18"]] **Regroup**
483 +
484 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-regroup.svg]] **Regroup**
454 454  When you tap on this symbol, Teamwire automatically zooms out until all currently shared locations fit on one map view. Users that are close to each other will be grouped together.
455 -
456 -* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-locationsettings.png||height="20"]] **Map settings**
486 +
487 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-draw.svg]] **Draw on map**
488 +Tap on the symbol to [[draw an area on the map>>doc:||anchor="02-drawonmap"]].
489 +
490 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-tune.svg]] **Map settings**
457 457  Tap on the symbol to open the map settings.
458 458  ## ##
459 459  ** **Map type**
460 -Select from one of the available map types (Standard, Satellite, Hybrid).
494 +Select from one of the available map types (Standard, Satellite, Hybrid). If your Teamwire administrator has enabled using [[ArcGIS Maps>>https://enterprise.arcgis.com/en/||rel="noopener noreferrer" target="_blank"]], the default maps will be replaced by ArcGIS Maps and you will receive a list of available map types. More information about enabling ArcGIS Maps in the Teamwire Dashboard are available [[here>>doc:Customer.Administration.Dashboard-User-Manual.App-Permissions.WebHome||anchor="app-orgasettings"]].
461 461  
462 462  ** **Show user names**
463 463  If enabled, in addition to the user photos, their names will be displayed on the map, too.
... ... @@ -464,35 +464,114 @@
464 464  
465 465  ** **Show user role**
466 466  If enabled, in addition to the user photos, their role will be displayed on the map, too (the information is taken from the user's profile).
501 +
502 +** **Group users**
503 +Enabled by default. Users who are in close proximity to each other are grouped together.
467 467  ## ##
468 468  
469 -{{id name="02-readreceipts"/}}
506 +{{id name="02-drawonmap"/}}
470 470  
471 -== Read receipts ==
508 += Draw on map =
472 472  
473 -The [[image:Public.Applications.iOS.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.
474 -Please note, that these read receipts **only apply to the latest message** of the chat and cannot be viewed for previous messages.
510 +This feature allows you to manually draw areas on the maps of shared locations and label them.
475 475  
476 -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.
512 +## ##
513 +[[image:Public.Applications.iOS.User-Manual.WebHome@livelocation-2.png||width="280px"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@livelocation-3.png||width="280px"]]
514 +## ##
477 477  
516 +{{id name="02-drawonmap-draw"/}}
517 +
518 +== Draw area ==
519 +
520 +Before sharing your location or live location, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icons-draw.svg]] in the upper-right corner of the map. Draw an area on the available map view with your finger. When you are finished, this area will be highlighted and a dialog box will open. There you have the possibility to define a label for the area (optional), e.g. "Festival area", "Search radius" or "Living street".
521 +
522 +Tap **Redraw area** to draw the area anew.
523 +
524 +Tap **Done** to save the area and share it with other chat participants.
525 +
526 +Tap **Cancel** to end the process and discard the area you've drawn.
527 +
478 478  (% class="box infomessage" %)
479 479  (((
480 -Your Teamwire administrator may disable read receipts for all users.
530 +When sharing a [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-location.svg]] **single location,** you will not be able to edit the drawn area at a later time.
531 +
532 +When sharing you [[image:Public.Applications.iOS.User-Manual.WebHome@icons-livelocation.svg]] **live location,** you will be able to add or edit an area later.
481 481  )))
482 482  
535 +{{id name="02-drawonmap-remove"/}}
536 +
537 +== Remove area ==
538 +
539 +Tap on your area in the map view to open the dialog box and select **Remove area** to delete it.
540 +
541 +You can only remove those areas which you have drawn yourself.
542 +
543 +(% class="box infomessage" %)
544 +(((
545 +Areas can be removed **when sharing your live location only.**
546 +
547 +When sharing a single location, you will not be able to remove an area later.
548 +)))
549 +
550 +{{id name="02-drawonmap-label"/}}
551 +
552 +== Area labels ==
553 +
554 +After drawing an area, a dialog box will open and prompting you to add a label.
555 +
556 +Labels are optional. Leave the text input field empty, if you do not want to add a label.
557 +
558 +You can edit or remove an area label at a later time. To do so, tap on your area in the map view to open the dialog box and edit / remove the text from the input field.
559 +
560 +Tap **Cancel** to end the process and discard your changes.
561 +
562 +You can only edit / remove labels for those areas which you have drawn yourself.
563 +
564 +(% class="box infomessage" %)
565 +(((
566 +Labels can be edited / removed **when sharing your live location only.**
567 +
568 +When sharing a single location, you will not be able to edit / remove an area label later.
569 +)))
570 +
571 +{{id name="02-drawonmap-multiple"/}}
572 +
573 +== Multiple user areas ==
574 +
575 +Since multiple live locations can be shared on one map at the same time, all the areas drawn by the chat participants and their labels will appear, too.
576 +
577 +If the areas of one or more users overlap, the labels appear as a single pin. Zoom into the map to be able to read the individual labels of the respective areas.
578 +
579 +You cannot edit / remove areas and labels of other chat participants.
580 +
581 +## ##
582 +[[image:Public.Applications.iOS.User-Manual.WebHome@livelocation-4.png||width="280px"]]
583 +## ##
584 +
585 +{{id name="meaction"/}}
586 +
587 += Message actions =
588 +
589 +When you're in the chat view, you have different actions, which you can perform on your and other chat member's sent messages and attachments.
590 +
591 +
483 483  {{id name="02-replytomessage"/}}
484 484  
485 -== Reply to message ==
594 +== Reply ==
486 486  
487 -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.
596 +Tap and hold the respective message or attachment to open the actions menu.
488 488  
598 +Select [[image:Public.Applications.iOS.User-Manual.WebHome@icons-reply.svg]] **Reply** to add a quote of the original message when sending your answer. This is especially useful in chats with numerous users and mixed conversations. Replies help you and others to remember the context of messages.
489 489  
600 +
490 490  {{id name="02-copymessage"/}}
491 491  
492 -== Copy message ==
603 +== Copy ==
493 493  
494 -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.
605 +Tap and hold the respective message to open the actions menu.
495 495  
607 +Select  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-copy.svg]] **Copy** to copy the message content to your clipboard. You can paste the text to another chat or an external app.
608 +
496 496  (% class="box infomessage" %)
497 497  (((
498 498  If you cannot copy a message, the feature may have been disabled by your Teamwire administrator.
... ... @@ -500,233 +500,347 @@
500 500  
501 501  {{id name="02-forwardmessage"/}}
502 502  
503 -== Forward message ==
616 +== Forward ==
504 504  
505 -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.iOS.User-Manual.WebHome@icon-newchat.png||height="20"]] in the bottom right corner of the screen and continue selecting your participants.
618 +Tap and hold the respective message or attachment to open the actions menu.
506 506  
620 +Select  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-forward.svg]] **Forward** to see a list of existing chats which you can forward the content to. If you want to forward a message to a user, list, or circle who you don't yet have a chat with, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icons-chat-new.svg]] **New chat** in the bottom-right corner of the screen and continue selecting your participants.
507 507  
622 +
508 508  {{id name="02-deletemessage"/}}
509 509  
510 -== Delete message ==
625 +== Delete ==
511 511  
512 -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.
627 +You can delete your own messages and attachments in Teamwire, even if they have already been read by others.
513 513  
629 +Tap and hold the respective message or attachment to open the actions menu.
630 +
631 +Select  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-delete.svg]] **Delete** to remove it permanently.
632 +
514 514  (% class="box infomessage" %)
515 515  (((
516 516  If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
517 517  )))
518 518  
519 -{{id name="02-chatsettings"/}}
520 520  
521 -= Chat settings =
639 +{{id name="02-chatadministration"/}}
522 522  
523 -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.
641 += Chat actions =
524 524  
525 -(% class="box infomessage" %)
526 -(((
527 -Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
528 -)))
643 +These are actions that can be performed on your existing chats.
529 529  
530 -## ##
531 -[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__Chat_Settings__1of3.png||height="581" width="280"]]
532 -## ##
533 533  
534 -{{id name="02-chatavatar"/}}
646 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-unread.svg]] [[Mark chat as read / unread>>doc:||anchor="chaction-unread"]]
535 535  
536 -== Chat avatar ==
648 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-pin.svg]] [[Pin chat>>doc:||anchor="chaction-pin"]]
537 537  
538 -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.
650 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-favourite.svg]] [[Favourite chat>>doc:||anchor="chaction-favourite"]]
539 539  
540 -Tap the avatar again to **change** or **remove** the image.
652 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-mute.svg]] [[Mute chat>>doc:||anchor="02-mutechat"]]
541 541  
654 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-archive.svg]] [[Archive chat>>doc:||anchor="02-archivechat"]]
542 542  
543 -{{id name="02-chattitle"/}}
656 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-leave.svg]] [[Leave chat>>doc:||anchor="02-leavechat"]]
544 544  
545 -== Chat title ==
658 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-lock.svg]] [[Close chat>>doc:||anchor="02-closechat"]]
546 546  
547 -Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
660 +* [[image:Public.Applications.iOS.User-Manual.WebHome@icons-email.svg]] [[Email chat history>>doc:||anchor="02-emailchathistory"]]
661 +## ##
548 548  
549 -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.
663 +{{id name="chaction-unread"/}}
550 550  
665 +== Mark as read / unread ==
551 551  
552 -{{id name="02-chatmode"/}}
667 +**Mark a chat as read**, if you don't want to read new messages intentionally. The other chat members will still receive your [[read receipt>>doc:||anchor="02-readreceipts"]].
553 553  
554 -== Chat mode ==
669 +You have multiple options to perform the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-read.svg]] **Mark as read** action on a chat.
555 555  
556 -Teamwire supports two chat modes. Change the current mode by enabling or disabling the **Allow to send messages** feature.
557 -
558 -* **Normal**
559 -//Allow to send messages// enabled
560 -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.
561 -
562 -* **Broadcast**
563 -//Allow to send messages// disabled
564 -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.
671 +* In your inbox, swipe right on the chat you want to mark as read and select the action.
672 +* In your inbox, tap and hold down on the chat you want to mark as read to open the actions menu.
565 565  ## ##
566 566  
567 -{{id name="02-chatadministrators"/}}
675 +**Mark a chat as unread**, after you open it, either intentionally or accidentally. This can help you to remember you coming back to the conversation at a later point of time. This action will also show the chat in the [[**Unread** tab>>doc:||anchor="02-filter"]] in your inbox.
568 568  
569 -== Chat administrators ==
677 +You have multiple options to perform the [[image:Public.Applications.iOS.User-Manual.WebHome@icons-unread.svg]] **Mark as unread** action on a chat.
570 570  
571 -This section lists all administrators of the current chat.
679 +* In your inbox, swipe right on the chat you want to mark as unread and select the action.
680 +* In your inbox, tap and hold down on the chat you want to mark as unread to open the actions menu.
681 +## ##
572 572  
573 -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.
683 +## ##
684 +[[image:Public.Applications.iOS.User-Manual.WebHome@inbox-2.png||width="280px"]]
685 +## ##
574 574  
575 -In a 1:1 chat, both members become chat administrator by default.
687 +{{id name="chaction-pin"/}}
576 576  
577 -**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.iOS.User-Manual.Contacts.WebHome||anchor="03-circles"]] or [[lists>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-lists"]], or by a mix of all options mentioned.
689 +== Pin ==
578 578  
691 +This is a personal setting and will only affect your own chats and inbox.
579 579  
580 -{{id name="02-promotetoadmin"/}}
581 581  
582 -=== Promote to chat admin ===
694 +Pinned chats stay on top of your inbox, even if other chats have newer messages.
583 583  
584 -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.**
696 +You have multiple options to [[image:Public.Applications.iOS.User-Manual.WebHome@icons-pin.svg]] **Pin** a chat.
585 585  
698 +* In your inbox, swipe right on the chat you want to pin and select the action.
699 +* In your inbox, tap and hold down on the chat you want to pin to open the actions menu.
700 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
701 +## ##
702 +
703 +In the same way, you can [[image:Public.Applications.iOS.User-Manual.WebHome@icons-unpin.svg]] **Unpin** a chat again.
704 +
586 586  (% class="box infomessage" %)
587 587  (((
588 -The admin promotion cannot be revoked.
707 +A chat that receives an [[image:Public.Applications.iOS.User-Manual.WebHome@icons-am-alert.svg]] **alert **will continue to move **atop of your pinned chats** until its messages have been read.
589 589  )))
590 590  
591 -{{id name="02-demoteadmin"/}}
710 +{{id name="chaction-favourite"/}}
592 592  
593 -=== Demote chat admin ===
712 +== Favourite ==
594 594  
595 -The admin promotion cannot be revoked.
714 +This is a personal setting and will only affect your own chats and inbox.
596 596  
597 -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.
598 598  
717 +Favourite chats are additionally shown in the [[**Favourites** tab>>doc:||anchor="02-filter"]] in your inbox. This feature helps you find your favourite conversations faster. Especially when forwarding messages or attachments, as your Favourites will be shown first in the list of available chats.
599 599  
600 -{{id name="02-members"/}}
719 +You have multiple options to [[image:Public.Applications.iOS.User-Manual.WebHome@icons-favourite.svg]] **Favourite** a chat.
601 601  
602 -== Members ==
721 +* In your inbox, swipe right on the chat you want to favourite and select the action.
722 +* In your inbox, tap and hold down on the chat you want to favourite to open the actions menu.
723 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
724 +## ##
603 603  
604 -This section lists all members of the current chat incl. chat administrators.
726 +In the same way, you can [[image:Public.Applications.iOS.User-Manual.WebHome@icons-unfavourite.svg]] **Unfavourite** a chat again.
605 605  
606 -If the chat was created with a group (or if one has been added later), you can tap the circle and select **View members** to view its list of users.
607 607  
729 +{{id name="02-mutechat"/}}
608 608  
609 -{{id name="02-addmoremembers"/}}
731 +== Mute ==
610 610  
611 -=== Add more members to chat ===
733 +This is a personal setting and will only affect your own chats and inbox.
612 612  
613 -Tap the uppermost option **Add a Colleague to this Chat** 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.**
614 614  
736 +Muted chats will no longer notify you about new messages via sound, vibration or push notification. This applies only per muted chat. The app badge on your home screen will include muted chats when showing the number of unread conversations.
615 615  
616 -{{id name="02-removemembers"/}}
738 +You have multiple options to [[image:Public.Applications.iOS.User-Manual.WebHome@icons-mute.svg]] **Mute** a chat.
617 617  
618 -=== Remove members ===
740 +* In your inbox, swipe left on the chat you want to mute and select the action.
741 +* In your inbox, tap and hold down on the chat you want to mute to open the actions menu.
742 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
743 +## ##
619 619  
620 -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.
745 +In the same way, you can [[image:Public.Applications.iOS.User-Manual.WebHome@icons-notification.svg]] **Unmute** a chat to receive its notifications again.
621 621  
747 +(% class="box infomessage" %)
748 +(((
749 +If you cannot mute a chat, the feature may have been disabled by your Teamwire administrator or by a [[chat admin>>doc:||anchor="02-chatadministrators"]].
750 +)))
622 622  
623 -{{id name="02-mediaoverview"/}}
752 +## ##
753 +[[image:Public.Applications.iOS.User-Manual.WebHome@inbox-3.png||width="280px"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@inbox-4.png||width="280px"]]
754 +## ##
624 624  
625 -= Media overview =
756 +{{id name="02-archivechat"/}}
626 626  
627 -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.//
758 +== Archive ==
628 628  
760 +This is a personal setting and will only affect your own chats and inbox.
629 629  
630 -{{id name="02-chatadministration"/}}
631 631  
632 -= Chat administration =
763 +You can archive a chats if it's no longer active or when a topic-based discussion is completed. Archived chats are not displayed in your regular **All** tab and are moved to the [[**Archived** tab>>doc:||anchor="02-filter"]] in your inbox.
633 633  
634 -Below the media overview you will find the chat administration.
765 +You have multiple options to [[image:Public.Applications.iOS.User-Manual.WebHome@icons-archive.svg]] **Archive** a chat.
635 635  
767 +* In your inbox, swipe left on the chat you want to archive and select the action.
768 +* In your inbox, tap and hold down on the chat you want to archive to open the actions menu.
769 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
636 636  ## ##
637 -[[image:Public.Applications.iOS.User-Manual.WebHome@iPhone_EN__Chat_Settings__3of3.png||height="581" width="280"]]
638 -## ##
639 639  
640 -{{id name="02-mutechat"/}}
772 +In the same way, you can [[image:Public.Applications.iOS.User-Manual.WebHome@icons-unarchive.svg]] **Unarchive** a chat from the Archived tab.
641 641  
642 -== Mute chat ==
643 643  
644 -This is a personal setting and will only affect your own user account.
775 +{{id name="02-leavechat"/}}
645 645  
646 -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.
777 +== Leave ==
647 647  
648 -There are two options to mute a chat
779 +You may leave a chat if you no longer want to be part of the conversation, or your participation is no longer required.
649 649  
650 -* 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.
651 -* **In your inbox, left swipe** the chat concerned and tap **Mute.**
781 +You have multiple options to [[image:Public.Applications.iOS.User-Manual.WebHome@icons-leave.svg]] **Leave** a chat.
782 +
783 +* In your inbox, swipe left on the chat you want to leave and select the action.
784 +* In your inbox, tap and hold down on the chat you want to leave to open the actions menu.
785 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
652 652  ## ##
653 653  
654 -You can re-enable notifications for a chat in the same way.
788 +To rejoin a chat, one of the [[chat admins>>doc:||anchor="02-chatadministrators"]] can add you again.
655 655  
656 656  (% class="box infomessage" %)
657 657  (((
658 -If you cannot mute a chat, the feature may have been disabled by your Teamwire administrator or by a chat admin.
792 +If you cannot leave a chat, the feature may have been disabled by your Teamwire administrator.
793 +
794 +Please note that you cannot leave chats in which you have been added as part of a [[Circle>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-circles"]].
659 659  )))
660 660  
661 -{{id name="02-archivechat"/}}
797 +{{id name="02-closechat"/}}
662 662  
663 -== Archive chat ==
799 +== Close ==
664 664  
665 -This is a personal setting and will only affect your own user account.
801 +This is an administrative setting and will affect all members of the chat.
666 666  
667 -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.
668 668  
669 -There are two options to archive a chat
804 +Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] can close a chat.
805 +Close a chat when the conversation is over and no longer needed. After a chat has been closed, the conversation can no longer be read by its members.
670 670  
671 -* 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.
672 -* **In your inbox, left swipe** the chat concerned and tap **Archive.**
807 +You have multiple options to [[image:Public.Applications.iOS.User-Manual.WebHome@icons-lock.svg]] **Close** a chat.
808 +
809 +* In your inbox, swipe left on the chat you want to close and select the action.
810 +* In your inbox, tap and hold down on the chat you want to close to open the actions menu.
811 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
673 673  ## ##
674 674  
675 -You can view archived chats using the [[inbox filter>>doc:||anchor="02-filter"]]. While viewing the archived chats, you can **unarchive** a conversation again in the same way as mentioned above.
814 +If you are a chat admin, you can [[image:Public.Applications.iOS.User-Manual.WebHome@icons-unlock.svg]] **Reopen** the chat in the same way.
676 676  
816 +(% class="box infomessage" %)
817 +(((
818 +If you cannot close a chat, the feature may have been disabled by your Teamwire administrator.
819 +)))
677 677  
821 +## ##
822 +[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-closed1.png||width="280"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-closed2.png||width="280"]]
823 +## ##
824 +
678 678  {{id name="02-emailchathistory"/}}
679 679  
680 680  == Email chat history ==
681 681  
682 -Open the respective chat and view its chat settings by tapping its avatar and title. Select [[image:Public.Applications.iOS.User-Manual.WebHome@icon-send.png||height="20"]] **Email Chat History** to transfer the conversation in plain text to your default mail app. The action can be found below the media overview.
829 +Open the [[Chat settings>>doc:||anchor="02-chatsettings"]] of the conversation you want to share. Select [[image:Public.Applications.iOS.User-Manual.WebHome@icons-email.svg]] **Email Chat History** to transfer the conversation in plain text to your default mail app.
683 683  
684 684  Please note that attachments cannot be transferred to the mail.
685 685  
686 686  (% class="box infomessage" %)
687 687  (((
688 -If the "Email Chat History" option is not available to you, the feature may have been disabled by your Teamwire administrator.
835 +If this option is not available to you, the feature may have been disabled by your Teamwire administrator.
689 689  )))
690 690  
691 -{{id name="02-closechat"/}}
692 692  
693 -== Close chat ==
839 +{{id name="02-chatsettings"/}}
694 694  
695 -This is an administrative setting and will affect all members of the chat. Only chat administrators can close a chat.
841 += Chat settings =
696 696  
697 -Close a chat when the conversation is over and no longer needed.
698 -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.
843 +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.
699 699  
700 -There are two options to close a chat
845 +(% class="box infomessage" %)
846 +(((
847 +Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
848 +)))
701 701  
702 -* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Close chat** action is located below the Media Overview.
703 -* **In your inbox, left swipe** the chat concerned and tap **Close.**
704 704  ## ##
851 +[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-chatset1.png||width="280"]]
852 +## ##
705 705  
706 -You can **reopen** the chat in the same way, if you are a chat administrator.
854 +{{id name="02-chatavatar"/}}
707 707  
708 -(% class="box infomessage" %)
709 -(((
710 -If the "Close chat" option is not available to you, the feature may have been disabled by your Teamwire administrator.
711 -)))
856 +== Avatar ==
712 712  
713 -{{id name="02-leavechat"/}}
858 +Tap on the current chat avatar. You can choose an existing picture of your photos and images from your [[image:Public.Applications.iOS.User-Manual.WebHome@icons-attach-image.svg]] **Gallery** or take a photo with your  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-camera.svg]] **Camera.** The new avatar will be shown to all members of the conversation.
714 714  
715 -== Leave chat ==
860 +Tap the avatar again to **change** or **remove** the image.
716 716  
717 -Leave a chat when you no longer want to be part of the conversation or your participation is no longer needed.
718 718  
719 -There are two options to leave a chat
863 +{{id name="02-chattitle"/}}
720 720  
721 -* 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.
722 -* **In your inbox, left swipe** the chat concerned and tap **Leave.**
865 +== Title ==
866 +
867 +Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
868 +
869 +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.
870 +
871 +
872 +{{id name="02-chatmode"/}}
873 +
874 +== Mode ==
875 +
876 +Teamwire supports two chat modes. Change the current mode by enabling or disabling the **Allow to send messages** feature.
877 +
878 +* **Normal**
879 +//Allow to send messages// enabled
880 +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.
881 +
882 +* **Broadcast**
883 +//Allow to send messages// disabled
884 +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.
723 723  ## ##
724 724  
887 +{{id name="02-chatadministrators"/}}
888 +
889 +== Administrators ==
890 +
891 +This section lists all [[image:Public.Applications.iOS.User-Manual.WebHome@icons-admin.svg]] administrators of the current chat.
892 +
893 +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.
894 +
895 +In a 1:1 chat, both members become chat administrator by default.
896 +
897 +**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.iOS.User-Manual.Contacts.WebHome||anchor="03-circles"]] or [[lists>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-lists"]], or by a mix of all options mentioned.
898 +
899 +
900 +{{id name="02-promotetoadmin"/}}
901 +
902 +=== Promote to chat admin ===
903 +
904 +In the chat settings, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icons-group.svg]] [[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.**
905 +
906 +
907 +{{id name="02-demoteadmin"/}}
908 +
909 +=== Demote chat admin ===
910 +
911 +In the chat settings, tap  [[image:Public.Applications.iOS.User-Manual.WebHome@icons-admin.svg]] [[Admins>>doc:||anchor="02-chatadministrators"]] to see the list of the current chat's admins. Tap the user of concern and select **Remove** to demote them.
912 +
913 +Chat admins can only remove the privileges of another chat admin, but not their own.
914 +
915 +
916 +{{id name="02-members"/}}
917 +
918 +== Members ==
919 +
920 +This section lists all [[image:Public.Applications.iOS.User-Manual.WebHome@icons-group.svg]] members of the current chat incl. chat administrators.
921 +
922 +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.**
923 +
924 +
925 +{{id name="02-addmoremembers"/}}
926 +
927 +=== Add members ===
928 +
929 +Tap the uppermost option [[image:Public.Applications.iOS.User-Manual.WebHome@icons-adduser.svg]] **Add a Colleague to this Chat** 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.**
930 +
931 +
932 +{{id name="02-removemembers"/}}
933 +
934 +=== Remove members ===
935 +
936 +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.
937 +
938 +
939 +{{id name="02-readreceipts"/}}
940 +
941 += Read receipts =
942 +
943 +The 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.
944 +
945 +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.
946 +
725 725  (% class="box infomessage" %)
726 726  (((
727 -If the "Leave" option is not available to you, the feature may have been disabled by your Teamwire administrator.
728 -
729 -Please note that you cannot leave chats in which you have been added as part of a [[circle>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-circles"]].
949 +Your Teamwire administrator may disable read receipts for all users.
730 730  )))
731 731  
952 +
953 +{{id name="02-mediaoverview"/}}
954 +
955 += Media overview =
956 +
957 +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.
958 +
732 732  ## ##