Wiki source code of b. Chats and Messaging

Version 2.4 by teamwire001 on 2022/08/19 14:31

Show last authors
1 Starting Teamwire, the **Chats** tab is shown by default. It shows all chats you are involved in.
2
3 As you receive new messages, you will find a badge counter on the Chats tab indicating the number of unread texts.
4
5
6 {{id name="02-inbox"/}}
7
8 = Inbox =
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.
11
12
13 {{id name="02-search"/}}
14
15 == Search ==
16
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
19
20 {{id name="02-createnewchat"/}}
21
22 = Create a chat =
23
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
26 * 1:1 Chat
27 * Group Chat
28 * Broadcast
29 * Federated Chat
30 ## ##
31
32 {{id name="02-onetoonechat"/}}
33
34 == 1:1 chat ==
35
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.
37
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"]]).
39
40 (% class="box warningmessage" %)
41 (((
42 1:1 chats cannot be subsequently extended with additional users to form a group chat.
43 )))
44
45 {{id name="02-groupchat"/}}
46
47 == Group chat ==
48
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.
50
51 More information about chat content and actions are available [[here>>doc:||anchor="02-chatcontentsandactions"]].
52
53
54 {{id name="02-broadcastchat"/}}
55
56 == Broadcast chat ==
57
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.
59
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.
61
62 More information about the broadcast chat mode [[here>>doc:||anchor="02-chatmode"]].
63
64
65 {{id name="02-federatedchat"/}}
66
67 == Federated chat ==
68
69 Federated chats allow communicating with users from other Teamwire Servers.
70
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.
72
73
74 {{id name="02-federatedchat-contacts"/}}
75
76 === Available contacts ===
77
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 and locations.
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
111 ## ##
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
136 {{id name="02-definefurthersettings"/}}
137
138 == Define further settings ==
139
140 * **Allow to mute notifications**
141 Decide whether chat members are allowed to mute this conversation so they will no longer receive push notifications.
142
143 * **Alert Chat**
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 ## ##
146
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.
148
149
150 {{id name="02-voipcall"/}}
151
152 = Voice and video calls =
153
154 You can contact one or multiple users in your existing chats via voice or video call.
155
156 This feature is available for 1:1 chats and group chats.
157
158 There can only be one call in progress per chat. In case other participants are already having a call in the same chat, you will receive a notice.
159
160 (% class="box infomessage" %)
161 (((
162 If voice and video calls are not available to you, the feature may have been disabled by your Teamwire administrator.
163 )))
164
165 {{id name="02-voipcall-start"/}}
166
167 == Start a call ==
168
169 Open an existing chat or [[create a new chat>>doc:||anchor="02-createnewchat"]] with your favoured participants.
170
171 Start the call by tapping the respective button in the upper right corner of the screen.
172
173 Use ## ##[[image:Public.Applications.Android.User-Manual.WebHome@icon-voipvoice11.png||height="20"]]## ## to start a voice call and ## ##[[image:Public.Applications.Android.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.
174
175 The other call participants will be notified, even if they are currently not actively using the Teamwire app.
176
177
178 **The number of participants for group calls is limited** and given by your Teamwire server admin.
179
180 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.Android.User-Manual.WebHome@icon-voipvoicegroup.png||height="20"]]## ## for voice and ## ##[[image:Public.Applications.Android.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.
181
182
183 {{id name="02-voipcall-join"/}}
184
185 == Join a call ==
186
187 If you have missed a call, you can also join it later.
188
189 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.
190
191
192 {{id name="02-voipcall-features"/}}
193
194 == Features during a call ==
195
196 The following primary features are available during the call.
197
198 * Enable / disable microphone
199 * Enable / disable camera
200 * Select sound device
201 * Screen sharing
202 * Raise hand
203 * Toggle between front and backside camera
204
205 ## ##
206
207 {{id name="02-emergencyalert"/}}
208
209 = Emergency alert (SOS button) =
210
211 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.
212
213 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.
214
215 (% class="box infomessage" %)
216 (((
217 If the SOS button is not available to you, the feature may have been disabled by your Teamwire administrator.
218 )))
219
220 {{id name="02-emergencyalert-configure"/}}
221
222 == Set up the SOS button ==
223
224 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.
225
226
227 {{id name="02-emergencyalert-usage"/}}
228
229 == Use the SOS button ==
230
231 In your inbox, open the emergency menu by swiping your screen to the right.
232
233 ## ##
234 [[image:Public.Applications.Android.User-Manual.WebHome@mobEN_SOS_Mode.png||height="615" width="280"]]
235 ## ##
236
237 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.
238
239 To record a voice message
240
241 * tap the button once to start a 30 seconds record timer or
242 * tap and hold the button as long as you want to record your message.
243 ## ##
244
245 Afterwards, your location and voice message will be sent to a predefined group of users.
246
247
248 {{id name="02-pushtotalk"/}}
249
250 = Push-to-Talk =
251
252 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.
253
254 (% class="box infomessage" %)
255 (((
256 If Push-to-Talk is not available to you, the feature may have been disabled by your Teamwire administrator.
257 )))
258
259 {{id name="02-pushtotalk-configure"/}}
260
261 == Set up Push-to-Talk ==
262
263 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.
264
265 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.**
266
267 Use [[image:Public.Applications.Android.User-Manual.WebHome@icon-pttdeselect.png||height="20"]] to remove your current selection of chats.
268
269 ## ##
270 [[image:Public.Applications.Android.User-Manual.WebHome@mobEN_PTTselection.png||width="280"]]
271 ## ##
272
273 {{id name="02-pushtotalk-usage"/}}
274
275 == Use Push-to-Talk ==
276
277 Your Push-to-Talk chats are displayed at the bottom of the inbox. Simply swipe to switch between your Push-to-Talk chats.
278
279 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.
280
281 ## ##
282 [[image:Public.Applications.Android.User-Manual.WebHome@mobEN_PTTinbox.png||height="615" width="280"]]
283 ## ##
284
285 {{id name="02-chatcontentsandactions"/}}
286
287 = Chat content and actions =
288
289
290 {{id name="02-attachments"/}}
291
292 == Attachments and features ==
293
294 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.
295
296
297 [[image:Public.Applications.Android.User-Manual.WebHome@icon-camera.png||height="20"]] **Take photo**
298
299 Grant access to your camera to take and send photos or videos. Video recording is limited to 180 seconds.
300
301
302 [[image:Public.Applications.Android.User-Manual.WebHome@icon-gallery.png||height="20"]] **Photos and images from gallery**
303
304 Grant access to your gallery to send photos and videos stored on your device.
305
306
307 [[image:Public.Applications.Android.User-Manual.WebHome@icon-microphone.png||height="20"]] **Record voice message**
308
309 Grant access to your microphone to record and send a voice message. Voice recording is limited to 180 seconds.
310
311
312 [[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png||height="20"]] **Further attachments and features**
313
314 You will be listed further options for sharing content.
315
316
317 * [[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**
318 These are so-called attention messages. More information about attention messages are available [[here>>doc:||anchor="02-attentionmessages"]].
319
320 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-file.png||height="20"]] **File**
321 Select any further file type via your file manager to share them (e.g. PDF, text file, presentation etc.).
322
323 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-location.png||height="20"]] **Location**
324 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.
325 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"]].
326
327 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-calendar.png||height="20"]] **Calendar**
328 Grant access to your calendar to select appointments from your calendar app and attach them.
329
330 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-poll.png||height="20"]] **Poll**
331 Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
332
333 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-dracoon.png||height="20"]] **Dracoon**
334 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.
335 ## ##
336
337 (% class="box infomessage" %)
338 (((
339 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.
340 )))
341
342 {{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
343
344 == Attention messages ==
345
346 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.
347
348 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.
349 ## ##
350
351 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-alert.png||height="20"]] **Alert**
352 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.
353 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"]].
354 (% 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"]].
355
356 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-annoucement.png||height="20"]] **Announcement**
357 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.
358
359 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-note.png||height="20"]] **Note**
360 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.
361 ## ##
362
363 All message types above can be removed before sending by tapping the respective option again. Your message will be sent as normal text then.
364
365 (% class="box infomessage" %)
366 (((
367 If attention messages are not available to you, the feature may have been disabled by your Teamwire administrator.
368 )))
369
370 {{id name="02-ownattentionmessages"/}}
371
372 === Activity / Reactions ===
373
374 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.**
375
376 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.
377
378
379 {{id name="02-livelocation"/}}
380
381 == Live location ==
382
383 This feature allows other users to track your current location live on a map.
384
385 To share your live location, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png||height="20"]] next to the text input field, select [[image:Public.Applications.Android.User-Manual.WebHome@icon-location.png||height="20"]] **Location** and **Share your live location.**
386
387 Open the live map and check your current position by tapping on the map preview in the chat.
388
389 ## ##
390 [[image:Public.Applications.Android.User-Manual.WebHome@mobEN_Livelocation.png||width="280"]]
391 ## ##
392
393 {{id name="02-livelocation-duration"/}}
394
395 === Sharing duration ===
396
397 As you start the live location feature, you can select for how long you want to share it.
398
399 The remaining minutes / hours of the duration are shown in the chat and map view.
400
401 The app will automatically stop sharing when the duration has been exceeded without further notification.
402
403
404 {{id name="02-livelocation-stop"/}}
405
406 === Stop sharing manually ===
407
408 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.**
409
410
411 {{id name="02-livelocation-multiple"/}}
412
413 === Multiple users sharing ===
414
415 In one chat, multiple users can share their live location at the same time. Their locations will be shown in a single map.
416
417 A list of all chat members currently sharing their location is available in the bottom of the screen (expand).
418
419
420 {{id name="02-livelocation-additional"/}}
421
422 === Additional features ===
423
424 The live map offers different tools and settings to view users and map material.
425
426 * **Focus user**
427 Tap on one of the users to focus on them. This way, the user will always remain in the center of the map view.
428 You can also select the user from the list of all chat members currently sharing their location.
429
430 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-locationcenter.png||height="18"]] **Center map**
431 Tap on the symbol to center the view on your current location.
432
433 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-locationregroup.png||height="18"]] **Regroup**
434 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.
435
436 * [[image:Public.Applications.Android.User-Manual.WebHome@icon-locationsettings.png||height="20"]] **Map settings**
437 Tap on the symbol to open the map settings.
438 ## ##
439 ** **Map type**
440 Select from one of the available map types (Standard, Satellite, Hybrid).
441
442 ** **Show user names**
443 If enabled, in addition to the user photos, their names will be displayed on the map, too.
444
445 ** **Show user role**
446 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).
447 ## ##
448
449 {{id name="02-readreceipts"/}}
450
451 == Read receipts ==
452
453 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.
454
455 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.
456
457 (% class="box infomessage" %)
458 (((
459 Your Teamwire administrator may disable read receipts for all users.
460 )))
461
462 {{id name="02-replytomessage"/}}
463
464 == Reply to message ==
465
466 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.
467
468
469 {{id name="02-copymessage"/}}
470
471 == Copy message ==
472
473 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.
474
475 (% class="box infomessage" %)
476 (((
477 If you cannot copy a message, the feature may have been disabled by your Teamwire administrator.
478 )))
479
480 {{id name="02-forwardmessage"/}}
481
482 == Forward message ==
483
484 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.
485
486
487 {{id name="02-deletemessage"/}}
488
489 == Delete message ==
490
491 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.
492
493 (% class="box infomessage" %)
494 (((
495 If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
496 )))
497
498 {{id name="02-chatsettings"/}}
499
500 = Chat settings =
501
502 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.
503
504 (% class="box infomessage" %)
505 (((
506 Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
507 )))
508
509 ## ##
510 [[image:Public.Applications.Android.User-Manual.WebHome@mobEN_Chatsettings1.png||height="615" width="280"]]
511 ## ##
512
513 {{id name="02-chatavatar"/}}
514
515 == Chat avatar ==
516
517 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.
518
519 Tap the avatar again to **change** or **remove** the image.
520
521
522 {{id name="02-chattitle"/}}
523
524 == Chat title ==
525
526 Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
527
528 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.
529
530
531 {{id name="02-chatmode"/}}
532
533 == Chat mode ==
534
535 Teamwire supports two chat modes. Change the current mode by enabling or disabling the **Allow to send messages** feature.
536
537 * **Normal**
538 //Allow to send messages// enabled
539 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.
540
541 * **Broadcast**
542 //Allow to send messages// disabled
543 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.
544 ## ##
545
546 {{id name="02-chatadministrators"/}}
547
548 == Chat administrators ==
549
550 This section lists all administrators of the current chat.
551
552 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.
553
554 In a 1:1 chat, both members become chat administrator by default.
555
556 **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.
557
558
559 {{id name="02-promotetoadmin"/}}
560
561 === Promote to chat admin ===
562
563 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.**
564
565 (% class="box infomessage" %)
566 (((
567 The admin promotion cannot be revoked.
568 )))
569
570 {{id name="02-demoteadmin"/}}
571
572 === Demote chat admin ===
573
574 The admin promotion cannot be revoked.
575
576 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.
577
578
579 {{id name="02-members"/}}
580
581 == Members ==
582
583 This section lists all members of the current chat incl. chat administrators.
584
585 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.**
586
587
588 {{id name="02-addmoremembers"/}}
589
590 === Add more members to chat ===
591
592 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.**
593
594
595 {{id name="02-removemembers"/}}
596
597 === Remove members ===
598
599 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.
600
601
602 {{id name="02-mediaoverview"/}}
603
604 = Media overview =
605
606 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.//
607
608
609 {{id name="02-chatadministration"/}}
610
611 = Chat administration =
612
613 Below the media overview you will find the chat administration.
614
615 ## ##
616 [[image:Public.Applications.Android.User-Manual.WebHome@mobEN_Chatsettings2.png||height="615" width="280"]]
617 ## ##
618
619 {{id name="02-mutechat"/}}
620
621 == Mute chat ==
622
623 This is a personal setting and will only affect your own user account.
624
625 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.
626
627 There are two options to mute a chat
628
629 * 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.
630 * In your **inbox,** tap and hold the chat of concern to open the context menu and select **Mute.**
631 ## ##
632
633 You can re-enable notifications for a chat in the same way.
634
635 (% class="box infomessage" %)
636 (((
637 If you cannot mute a chat, the feature may have been disabled by your Teamwire administrator or by a chat admin.
638 )))
639
640 {{id name="02-archivechat"/}}
641
642 == Archive chat ==
643
644 This is a personal setting and will only affect your own user account.
645
646 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.
647
648 There are two options to archive a chat
649
650 * 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.
651 * In your **inbox,** tap and hold the chat of concern to open the context menu and select **Archive.**
652 ## ##
653
654 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.
655
656
657 {{id name="02-emailchathistory"/}}
658
659 == Send chat history ==
660
661 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.
662
663 Please note that attachments cannot be transferred to the mail.
664
665 (% class="box infomessage" %)
666 (((
667 If the "Send" option is not available to you, the feature may have been disabled by your Teamwire administrator.
668 )))
669
670 {{id name="02-leavechat"/}}
671
672 == Leave chat ==
673
674 Leave a chat when you no longer want to be part of the conversation or your participation is no longer needed.
675
676 There are two options to leave a chat
677
678 * 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.
679 * In your **inbox,** tap and hold the chat of concern to open the context menu and select **Leave.**
680 ## ##
681
682 (% class="box infomessage" %)
683 (((
684 If the "Leave" option is not available to you, the feature may have been disabled by your Teamwire administrator.
685
686 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"]].
687 )))
688
689 {{id name="02-closechat"/}}
690
691 == Close chat ==
692
693 This is an administrative setting and will affect all members of the chat. Only chat administrators can close a chat.
694
695 Close a chat when the conversation is over and no longer needed.
696 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.
697
698 There are two options to close a chat
699
700 * 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.
701 * In your **inbox,** tap and hold the chat of concern to open the context menu and select **Close.**
702 ## ##
703
704 You can **reopen** the chat in the same way if you are the chat administrator.
705
706 (% class="box infomessage" %)
707 (((
708 If the "Close" option is not available to you, the feature may have been disabled by your Teamwire administrator.
709 )))
710
711 ## ##