Wiki source code of b. Chats and Messaging

Last modified by teamwire003 on 2025/11/21 07:21

Show last authors
1 When starting Teamwire, the [[image:Public.Applications.Android.User-Manual.WebHome@icons-messages.svg]] **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 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
5
6 {{id name="02-filter"/}}
7
8 = Inbox =
9
10 Your inbox provides four tabs which allow you to switch between the most important chat type criteria.
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.
14
15 * **Favourites**
16 This tab lists all your [[favourite chats>>doc:||anchor="chaction-favourite"]].
17
18 * **Unread**
19 This tab lists all chats with new messages and chats you have [[marked as unread>>doc:||anchor="chaction-unread"]].
20
21 * **Archived**
22 This tab lists all your [[archived chats>>doc:||anchor="02-archivechat"]].
23 ## ##
24
25 ## ##
26 [[image:Public.Applications.Android.User-Manual.WebHome@inbox-1.png||width="280px"]]
27 ## ##
28
29 {{id name="02-search"/}}
30
31 = Search =
32
33 Tap [[image:Public.Applications.Android.User-Manual.WebHome@icons-search.svg]] in the upper-right corner of the screen to open a search bar. The search will look up for chat titles, contacts, lists and circles, bots, and message content. To leave the search, tap the arrow at the upper-left.
34
35
36 {{id name="02-createnewchat"/}}
37
38 = Create a chat =
39
40 To create a new chat, use the button [[image:Public.Applications.Android.User-Manual.WebHome@icons-chat-new.svg]] in the lower-right corner of the screen, where you can then choose from the following options.
41
42
43 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-user.svg||height="20"]] [[1:1 Chat>>doc:||anchor="02-onetoonechat"]]
44
45 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-group.svg||height="22"]] [[Group Chat>>doc:||anchor="02-groupchat"]]
46
47 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-broadcast.svg||height="21"]] [[Broadcast>>doc:||anchor="02-broadcastchat"]]
48
49 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-federated.svg||height="20"]] [[Federated Chat>>doc:||anchor="02-federatedchat"]]
50 ## ##
51
52 {{id name="02-onetoonechat"/}}
53
54 == 1:1 chat ==
55
56 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.
57
58 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"]]).
59
60 {{warning}}
61 1:1 chats cannot be subsequently extended with additional users to form a group chat.
62 {{/warning}}
63
64
65 {{id name="02-groupchat"/}}
66
67 == Group chat ==
68
69 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.
70
71 More information about chat content and actions are available [[here>>doc:||anchor="02-chatcontentsandactions"]].
72
73
74 {{id name="02-broadcastchat"/}}
75
76 == Broadcast chat ==
77
78 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.
79
80 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.
81
82 More information about the broadcast chat mode [[here>>doc:||anchor="02-chatmode"]].
83
84
85 {{id name="02-federatedchat"/}}
86
87 == Federated chat ==
88
89 Federated chats allow communicating with users from other Teamwire Servers.
90
91 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.
92
93
94 {{id name="02-federatedchat-contacts"/}}
95
96 === Available contacts ===
97
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
100 Currently, it is not possible to add more chat members to the chat later.
101
102
103 {{id name="02-federatedchat-content"/}}
104
105 === Available chat content ===
106
107 The range of [[chat content>>doc:||anchor="02-chatcontentsandactions"]] is limited.
108
109 Currently, the following attachment types are supported: photos, (gallery), videos (gallery), files, attention messages and locations.
110
111
112 {{id name="02-federatedchat-removed"/}}
113
114 === Removed federations ===
115
116 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.
117
118
119 {{id name="02-selectparticipants"/}}
120
121 == Select participants ==
122
123 Select one or more users from your list of contacts by tapping the checkbox next to the user's name.
124
125 Already selected contacts are indicated with an  [[image:Public.Applications.Android.User-Manual.WebHome@icons_box_selected.svg]] and can be deselected by re-tapping.
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.
128
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
131
132 Your contacts are split into four types and are listed per section.
133
134 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-user.svg||height="20"]] [[Contacts>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-contacts"]]
135
136 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-userlist.svg]] [[Lists>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-lists"]]
137
138 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-circle.svg||height="21"]] [[Circles>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-circles"]]
139
140 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-bot.svg||height="22"]] [[Bots>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-bots"]]
141 ## ##
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 [[image:Public.Applications.Android.User-Manual.WebHome@icons-search.svg]] search bar, to find your contacts, lists, circles and bots per section.
144
145 ## ##
146 [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-create1.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-create2.png||width="280px"]]
147 ## ##
148
149 {{id name="02-definechattitle"/}}
150
151 == Define title ==
152
153 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.
154
155
156 {{id name="02-definefurthersettings"/}}
157
158 == Define further settings ==
159
160 * **Allow to mute notifications**
161 Decide whether chat members are allowed to mute this conversation so they will no longer receive push notifications.
162
163 * **Alert Chat**
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 ## ##
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
169
170 {{id name="02-voipcall"/}}
171
172 = Voice and video calls =
173
174 You can contact one or multiple users in your existing chats via voice or video call.
175
176 This feature is available for 1:1 chats and group chats.
177
178 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.
179
180 {{info}}
181 If voice and video calls are not available to you, the feature may have been disabled by your Teamwire administrator.
182 {{/info}}
183
184
185 {{id name="02-voipcall-start"/}}
186
187 == Start a call ==
188
189 Open an existing chat or [[create a new chat>>doc:||anchor="02-createnewchat"]] with your favoured participants.
190
191 Start the call by tapping the respective button in the upper-right corner of the screen.
192
193 Use [[image:Public.Applications.Android.User-Manual.WebHome@icons-call-voice.svg]] to start a voice call and [[image:Public.Applications.Android.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
195 The other call participants will be notified, even if they are currently not actively using the Teamwire app.
196
197
198 **The number of participants for group calls is limited** and given by your Teamwire server admin.
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.Android.User-Manual.WebHome@icons-call-voice-plus.svg]] for voice and [[image:Public.Applications.Android.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
202 ## ##
203 [[image:Public.Applications.Android.User-Manual.WebHome@chatview-1.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@videocall-1.png||width="280px"]]
204 ## ##
205
206 {{id name="02-voipcall-join"/}}
207
208 == Join a call ==
209
210 If you have missed a call, you can also join it later.
211
212 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.
213
214 ## ##
215 [[image:Public.Applications.Android.User-Manual.WebHome@chatview-2.png||width="280px"]]
216 ## ##
217
218 {{id name="02-voipcall-features"/}}
219
220 == Features during a call ==
221
222 The following primary features are available during the call.
223
224 * Enable / disable microphone
225 * Enable / disable camera
226 * Select sound device
227 * Screen sharing
228 * Raise hand
229 * Toggle between front and backside camera
230 ## ##
231
232 {{id name="02-emergencyalert"/}}
233
234 = Emergency alert =
235
236 This feature is meant for emergencies, allowing you 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.
237
238 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.
239
240 {{info}}
241 If the emergency alert is not available to you, the feature may have been disabled by your Teamwire administrator.
242 {{/info}}
243
244 ## ##
245 [[image:Public.Applications.Android.User-Manual.WebHome@emergency-1.png||width="280px"]]
246 ## ##
247
248 {{id name="02-emergencyalert-usage"/}}
249
250 == Usage ==
251
252 {{info}}
253 This feature requires permission to use your location and microphone in order to work correctly.
254 {{/info}}
255
256 Tap the  [[image:Public.Applications.Android.User-Manual.WebHome@icons-emergency.svg]] **Emergency **icon at the top of your inbox to open the screen.
257
258 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.
259
260 You have two options for recording your voice message, which will be sent together with an alert and your current location.
261
262 * Tap the [[image:Public.Applications.Android.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.
263 ** After 30 seconds, the alert will be sent automatically, including your voice message and your location.
264 ** Cancel your recording during the countdown by tapping the record button again **(X)**.
265
266 * Tap and hold the [[image:Public.Applications.Android.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.
267 ** Release the button to send the alert, including your voice message and your location.
268 ** Swipe up to cancel the recording and the process.
269 ## ##
270
271 {{id name="02-emergencyalert-configure"/}}
272
273 == Default circle ==
274
275 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.Android.User-Manual.Profile.WebHome||anchor="05-sosgroup"]] and select a circle or list from your directory.
276
277 Despite configuring a Default circle, you can still edit the **Send to** section, if you'd like to, before starting to record your message.
278
279 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.
280
281
282 {{id name="02-pushtotalk"/}}
283
284 = Push-to-Talk =
285
286 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.
287
288 {{info}}
289 If Push-to-Talk is not available to you, the feature may have been disabled by your Teamwire administrator.
290 {{/info}}
291
292
293 {{id name="02-pushtotalk-configure"/}}
294
295 == Setup ==
296
297 In you inbox, use the [[image:Public.Applications.Android.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.
298
299 As soon as you have defined at least one Push-to-Talk chat, you can decide via [[image:Public.Applications.Android.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.**
300
301 Use [[image:Public.Applications.Android.User-Manual.WebHome@icons-dnd.svg]] to remove your current selection of chats.
302
303 ## ##
304 [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-ptt1.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@pushtt-1.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@pushtt-2.png||width="280px"]]
305 ## ##
306
307 {{id name="02-pushtotalk-usage"/}}
308
309 == Usage ==
310
311 Your Push-to-Talk chats are displayed at the bottom of the inbox. Simply swipe to switch between your Push-to-Talk chats.
312
313 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.
314
315
316 {{id name="02-attachments"/}} {{id name="02-chatcontentsandactions"/}}
317
318 = Attachments =
319
320 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.
321
322
323 [[image:Public.Applications.Android.User-Manual.WebHome@icons-camera.svg]] **Take photo**
324 Grant access to your camera to take and send photos or videos. Video recording is limited to 180 seconds.
325
326
327 [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-image.svg]] **Photos and images from gallery**
328 Grant access to your gallery to send photos and videos stored on your device.
329
330
331 [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-voice.svg]] **Record voice message**
332 Grant access to your microphone to record and send a voice message. Voice recording is limited to 180 seconds.
333
334
335 [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach.svg]] **Further attachments and features**
336 You will be listed further options for sharing content.
337
338
339 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-am-alert.svg]] **Alert,** ## ##[[image:Public.Applications.Android.User-Manual.WebHome@icons-am-announce.svg]] **Announcement** or ## ##[[image:Public.Applications.Android.User-Manual.WebHome@icons-am-note.svg]] **Note**
340 These are so-called attention messages. More information about attention messages are available [[here>>doc:||anchor="02-attentionmessages"]].
341
342 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-file.svg]] **File**
343 Select any further file type via your file manager to share them (e.g. PDF, text file, presentation etc.).
344
345 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-location.svg]] **Location**
346 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.
347 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"]].
348
349 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-calendar.svg]] **Calendar**
350 Grant access to your calendar to select appointments from your calendar app and attach them.
351
352 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-poll.svg]] **Poll**
353 Create a poll (interactive attachment) with up to five options and let your chat members vote to make decisions more quickly.
354
355 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-dracoon.svg]] **Dracoon**
356 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.
357 ## ##
358
359 {{info}}
360 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.
361 {{/info}}
362
363 ## ##
364 [[image:Public.Applications.Android.User-Manual.WebHome@chatview-3.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@chatview-4.png||width="280px"]]
365 ## ##
366
367 {{id name="02-mentions"/}}
368
369 = Mentions =
370
371 Mention other chat members by typing an **@-symbol**.
372
373 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.
374
375 ## ##
376 [[image:Public.Applications.Android.User-Manual.WebHome@EN__mobile-mentions_001.png||width="280"]]
377 ## ##
378
379 When mentioned, you will receive a push notification and the respective chat will dispaly the mention with an **@-symbol** in your inbox.
380
381 ## ##
382 [[image:Public.Applications.Android.User-Manual.WebHome@EN__mobile-mentions_002.png||width="280"]]
383 ## ##
384
385 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).
386
387 ## ##
388 [[image:Public.Applications.Android.User-Manual.WebHome@EN__mobile-mentions_003.png||width="280"]]
389 ## ##
390
391 {{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
392
393 = Attention messages =
394
395 Via [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach.svg]] next to the text input field, various attention message types are available in Teamwire.
396
397 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.
398 ## ##
399
400 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-am-alert.svg]] **Alert**
401 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.Android.User-Manual.Profile.WebHome||anchor="05-notificationsounds"]].
402
403 {{warning cssClass="indent-1"}}
404 Heads up! An alert message is a single message labelled as alert. If you want to create an alert chat quickly, use the [[Emergency alert>>doc:||anchor="02-emergencyalert"]] feature.
405 {{/warning}}
406
407 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-am-announce.svg]] **Announcement**
408 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@icons-emojithumb.svg]] with a range of reactions.
409
410 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-am-note.svg]] **Note**
411 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@icons-emojithumb.svg]] with a range of reactions.
412 ## ##
413
414 All message types above can be removed before sending by tapping the respective option again. Your message will be sent as normal text then.
415
416 {{info}}
417 If attention messages are not available to you, the feature may have been disabled by your Teamwire administrator.
418 {{/info}}
419
420
421 {{id name="02-ownattentionmessages"/}}
422
423 == Activity / Reactions ==
424
425 You can view the **reactions** to one of your attention messages via the [[image:Public.Applications.Android.User-Manual.WebHome@icons-report.svg]] **report.**
426
427 You can find a chronological list of all reactions to your attention messages via the icon [[image:Public.Applications.Android.User-Manual.WebHome@icons-notification.svg]] in the upper-right corner of the chat.
428
429
430 {{id name="02-livelocation"/}}
431
432 = Live location =
433
434 This feature allows other users to track your current location live on a map.
435
436 To share your live location, tap [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach.svg]] next to the text input field, select [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-location.svg]] **Location** and [[image:Public.Applications.Android.User-Manual.WebHome@icons-livelocation.svg]] **Share your live location.**
437
438 Open the live map and check your current position by tapping on the map preview in the chat.
439
440 ## ##
441 [[image:Public.Applications.Android.User-Manual.WebHome@livelocation-1.png||width="280px"]]
442 ## ##
443
444 {{id name="02-livelocation-duration"/}}
445
446 == Sharing duration ==
447
448 As you start the live location feature, you can select for how long you want to share it.
449
450 The remaining minutes / hours of the duration are shown in the chat and map view.
451
452 The app will automatically stop sharing when the duration has been exceeded without further notification.
453
454
455 {{id name="02-livelocation-stop"/}}
456
457 == Stop sharing manually ==
458
459 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.**
460
461
462 {{id name="02-livelocation-multiple"/}}
463
464 == Multiple users sharing ==
465
466 In one chat, multiple users can share their live location at the same time. Their locations will be shown in a single map.
467
468 A list of all chat members currently sharing their location is available in the bottom of the screen (expand).
469
470
471 {{id name="02-livelocation-additional"/}}
472
473 == Additional features ==
474
475 The live map offers different tools and settings to view users and map material.
476
477 * **Focus user**
478 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.
479
480 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-near.svg]] **Center map**
481 Tap on the symbol to center the view on your current location.
482
483 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-regroup.svg]] **Regroup**
484 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.
485
486 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-draw.svg]] **Draw on map**
487 Tap on the symbol to [[draw an area on the map>>doc:||anchor="02-drawonmap"]].
488
489 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-tune.svg]] **Map settings**
490 Tap on the symbol to open the map settings.
491 ## ##
492 ** **Map type**
493 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"]].
494
495 ** **Show user names**
496 If enabled, in addition to the user photos, their names will be displayed on the map, too.
497
498 ** **Show user role**
499 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).
500
501 ** **Group users**
502 Enabled by default. Users who are in close proximity to each other are grouped together.
503 ## ##
504
505 {{id name="02-drawonmap"/}}
506
507 = Draw on map =
508
509 This feature allows you to manually draw areas on the maps of shared locations and label them.
510
511 ## ##
512 [[image:Public.Applications.Android.User-Manual.WebHome@livelocation-2.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@livelocation-3.png||width="280px"]]
513 ## ##
514
515 {{id name="02-drawonmap-draw"/}}
516
517 == Draw area ==
518
519 Before sharing your location or live location, tap [[image:Public.Applications.Android.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".
520
521 Tap **Redraw area** to draw the area anew.
522
523 Tap **Done** to save the area and share it with other chat participants.
524
525 Tap **X **to end the process and discard the area you've drawn.
526
527 {{info}}
528 When sharing a [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-location.svg]] **single location,** you will not be able to edit the drawn area at a later time.
529
530 When sharing you [[image:Public.Applications.Android.User-Manual.WebHome@icons-livelocation.svg]] **live location,** you will be able to add or edit an area later.
531 {{/info}}
532
533
534 {{id name="02-drawonmap-remove"/}}
535
536 == Remove area ==
537
538 Tap on your area in the map view to open the dialog box and select **Remove area** to delete it.
539
540 You can only remove those areas which you have drawn yourself.
541
542 {{info}}
543 Areas can be removed **when sharing your live location only.**
544
545 When sharing a single location, you will not be able to remove an area later.
546 {{/info}}
547
548
549 {{id name="02-drawonmap-label"/}}
550
551 == Area labels ==
552
553 After drawing an area, a dialog box will open and prompting you to add a label.
554
555 Labels are optional. Leave the text input field empty, if you do not want to add a label.
556
557 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.
558
559 Tap **X** to end the process and discard your changes.
560
561 You can only edit / remove labels for those areas which you have drawn yourself.
562
563 {{info}}
564 Labels can be edited / removed **when sharing your live location only.**
565
566 When sharing a single location, you will not be able to edit / remove an area label later.
567 {{/info}}
568
569
570 {{id name="02-drawonmap-multiple"/}}
571
572 == Multiple user areas ==
573
574 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.
575
576 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.
577
578 You cannot edit / remove areas and labels of other chat participants.
579
580 ## ##
581 [[image:Public.Applications.Android.User-Manual.WebHome@livelocation-4.png||width="280px"]]
582 ## ##
583
584 {{id name="meaction"/}}
585
586 = Message actions =
587
588 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.
589
590
591 {{id name="02-replytomessage"/}}
592
593 == Reply ==
594
595 Tap and hold the respective message or attachment to open the actions menu.
596
597 Select [[image:Public.Applications.Android.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.
598
599
600 {{id name="02-forwardmessage"/}}
601
602 == Forward ==
603
604 Tap and hold the respective message or attachment to open the actions menu.
605
606 Select [[image:Public.Applications.Android.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.Android.User-Manual.WebHome@icons-chat-new.svg]] **New chat** in the bottom-right corner of the screen and continue selecting your participants.
607
608
609 {{id name="02-copymessage"/}}
610
611 == Copy ==
612
613 Tap and hold the respective message to open the actions menu.
614
615 Select [[image:Public.Applications.Android.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.
616
617 {{info}}
618 If you cannot copy a message, the feature may have been disabled by your Teamwire administrator.
619 {{/info}}
620
621
622 {{id name="02-pinmessage"/}}
623
624 == Pin ==
625
626 By pinning messages, you can make important or frequently needed information easily accessible and save chat participants the time to search for it.
627
628 [[image:Public.Applications.Android.User-Manual.WebHome@chatview-pin.png||data-xwiki-image-style-alignment="end" width="400"]]Tap and hold the desired message to open the action menu.
629
630 Select [[image:Public.Applications.Android.User-Manual.WebHome@icons-pin.svg]] **Pin** and the message will be pinned to the top of the chat, visible to all members, in the pin bar.
631
632 To remove a pinned message, tap and hold the respective message in the pin bar to open the actions menu, and select [[image:Public.Applications.Android.User-Manual.WebHome@icons-unpin.svg]] **Unpin**.
633
634 {{info}}
635 When you open a chat, the pin bar displays the latest pinned message by default. Tap briefly on the pin bar to scroll to the original message within the chat. Tapping the pin bar again will display the next pinned message.
636
637 **A maximum of five messages can be pinned at the same time.** If five messages are already pinned and you want to pin another message, you will see a notification. You then have the option to replace the oldest pinned message with the new message.
638 {{/info}}
639
640
641 {{id name="02-deletemessage"/}}
642
643 == Delete ==
644
645 You can delete your own messages and attachments in Teamwire, even if they have already been read by others.
646
647 Tap and hold the respective message or attachment to open the actions menu.
648
649 Select [[image:Public.Applications.Android.User-Manual.WebHome@icons-delete.svg]] **Delete** to remove it permanently.
650
651 {{info}}
652 In addition, [[chat admins>>||anchor="02-chatadministrators"]] are able remove your messages and attachments, too.
653
654 If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
655 {{/info}}
656
657
658 {{id name="02-chatadministration"/}}
659
660 = Chat actions =
661
662 These are actions that can be performed on your existing chats.
663
664
665 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-unread.svg]] [[Mark chat as read / unread>>doc:||anchor="chaction-unread"]]
666
667 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-pin.svg]] [[Pin chat>>doc:||anchor="chaction-pin"]]
668
669 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-favourite.svg]] [[Favourite chat>>doc:||anchor="chaction-favourite"]]
670
671 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-mute.svg]] [[Mute chat>>doc:||anchor="02-mutechat"]]
672
673 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-archive.svg]] [[Archive chat>>doc:||anchor="02-archivechat"]]
674
675 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-leave.svg]] [[Leave chat>>doc:||anchor="02-leavechat"]]
676
677 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-lock.svg]] [[Close chat>>doc:||anchor="02-closechat"]]
678
679 * [[image:Public.Applications.Android.User-Manual.WebHome@icons-email.svg]] [[Email chat history>>doc:||anchor="02-emailchathistory"]]
680 ## ##
681
682 {{id name="chaction-unread"/}}
683
684 == Mark as read / unread ==
685
686 **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"]].
687
688 You have multiple options to perform the [[image:Public.Applications.Android.User-Manual.WebHome@icons-read.svg]] **Mark as read** action on a chat.
689
690 * In your inbox, swipe right on the chat you want to mark as read and select the action.
691 * In your inbox, tap and hold down on the chat you want to mark as read to open the actions menu.
692 ## ##
693
694 **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.
695
696 You have multiple options to perform the [[image:Public.Applications.Android.User-Manual.WebHome@icons-unread.svg]] **Mark as unread** action on a chat.
697
698 * In your inbox, swipe right on the chat you want to mark as unread and select the action.
699 * In your inbox, tap and hold down on the chat you want to mark as unread to open the actions menu.
700 ## ##
701
702 {{id name="chaction-unread-all"/}}
703
704 == Mark all as read ==
705
706 In addition to marking individual chats as read, you can manage all unread messages centrally.
707
708 In your **inbox**, open the **Unread** tab. You will find all chats with new messages, and chats you have manually [[marked as unread>>doc:||anchor="chaction-unread"]].
709
710 If you have unread messages, you will finde the button **Mark all as read** to clear the list in one easy step.
711
712 ## ##
713 [[image:Public.Applications.Android.User-Manual.WebHome@inbox-2.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@mark-all-read.png||width="280px"]]
714 ## ##
715
716 {{id name="chaction-pin"/}}
717
718 == Pin ==
719
720 This is a personal setting and will only affect your own chats and inbox.
721
722
723 Pinned chats stay on top of your inbox, even if other chats have newer messages.
724
725 You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-pin.svg]] **Pin** a chat.
726
727 * In your inbox, swipe right on the chat you want to pin and select the action.
728 * In your inbox, tap and hold down on the chat you want to pin to open the actions menu.
729 * Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
730 ## ##
731
732 In the same way, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-unpin.svg]] **Unpin** a chat again.
733
734 {{info}}
735 A chat that receives an [[image:Public.Applications.Android.User-Manual.WebHome@icons-am-alert.svg]] **alert **will continue to move **atop of your pinned chats** until its messages have been read.
736 {{/info}}
737
738
739 {{id name="chaction-favourite"/}}
740
741 == Favourite ==
742
743 This is a personal setting and will only affect your own chats and inbox.
744
745
746 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.
747
748 You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-favourite.svg]] **Favourite** a chat.
749
750 * In your inbox, swipe right on the chat you want to favourite and select the action.
751 * In your inbox, tap and hold down on the chat you want to favourite to open the actions menu.
752 * Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
753 ## ##
754
755 In the same way, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-unfavourite.svg]] **Unfavourite** a chat again.
756
757
758 {{id name="02-mutechat"/}}
759
760 == Mute ==
761
762 This is a personal setting and will only affect your own chats and inbox.
763
764
765 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.
766
767 You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-mute.svg]] **Mute** a chat.
768
769 * In your inbox, swipe left on the chat you want to mute and select the action.
770 * In your inbox, tap and hold down on the chat you want to mute to open the actions menu.
771 * Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
772 ## ##
773
774 In the same way, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-notification.svg]] **Unmute** a chat to receive its notifications again.
775
776 {{info}}
777 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"]].
778 {{/info}}
779
780 ## ##
781 [[image:Public.Applications.Android.User-Manual.WebHome@inbox-3.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@inbox-4.png||width="280px"]]
782 ## ##
783
784 {{id name="02-archivechat"/}}
785
786 == Archive ==
787
788 This is a personal setting and will only affect your own chats and inbox.
789
790
791 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.
792
793 You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-archive.svg]] **Archive** a chat.
794
795 * In your inbox, swipe left on the chat you want to archive and select the action.
796 * In your inbox, tap and hold down on the chat you want to archive to open the actions menu.
797 * Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
798 ## ##
799
800 In the same way, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-unarchive.svg]] **Unarchive** a chat from the Archived tab.
801
802
803 {{id name="02-leavechat"/}}
804
805 == Leave ==
806
807 You may leave a chat if you no longer want to be part of the conversation, or your participation is no longer required.
808
809 You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-leave.svg]] **Leave** a chat.
810
811 * In your inbox, swipe left on the chat you want to leave and select the action.
812 * In your inbox, tap and hold down on the chat you want to leave to open the actions menu.
813 * Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
814 ## ##
815
816 To rejoin a chat, one of the [[chat admins>>doc:||anchor="02-chatadministrators"]] can add you again.
817
818 {{info}}
819 If you cannot leave a chat, the feature may have been disabled by your Teamwire administrator.
820
821 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"]].
822 {{/info}}
823
824
825 {{id name="02-closechat"/}}
826
827 == Close ==
828
829 This is an administrative setting and will affect all members of the chat.
830
831
832 Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] can close a chat.
833 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.
834
835 You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-lock.svg]] **Close** a chat.
836
837 * In your inbox, swipe left on the chat you want to close and select the action.
838 * In your inbox, tap and hold down on the chat you want to close to open the actions menu.
839 * Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
840 ## ##
841
842 If you are a chat admin, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-unlock.svg]] **Reopen** the chat in the same way.
843
844 {{info}}
845 If you cannot close a chat, the feature may have been disabled by your Teamwire administrator.
846 {{/info}}
847
848 ## ##
849 [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-closed1.png||width="280"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-closed2.png||width="280"]]
850 ## ##
851
852 {{id name="02-emailchathistory"/}}
853
854 == Email chat history ==
855
856 Open the [[Chat settings>>doc:||anchor="02-chatsettings"]] of the conversation you want to share. Select [[image:Public.Applications.Android.User-Manual.WebHome@icons-email.svg]] **Email Chat History** to transfer the conversation in plain text to your default mail app.
857
858 Please note that attachments cannot be transferred to the mail.
859
860 {{info}}
861 If this option is not available to you, the feature may have been disabled by your Teamwire administrator.
862 {{/info}}
863
864
865 {{id name="02-chatsettings"/}}
866
867 = Chat settings =
868
869 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.
870
871 {{info}}
872 Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
873 {{/info}}
874
875 ## ##
876 [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-chatset1.png||width="280"]]
877 ## ##
878
879 {{id name="02-chatavatar"/}}
880
881 == Avatar ==
882
883 Tap on the current chat avatar. You can choose an existing picture of your photos and images from your [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-image.svg]] **Gallery** or take a photo with your [[image:Public.Applications.Android.User-Manual.WebHome@icons-camera.svg]] **Camera.** The new avatar will be shown to all members of the conversation.
884
885 Tap the avatar again to **change** or **remove** the image.
886
887
888 {{id name="02-chattitle"/}}
889
890 == Title ==
891
892 Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
893
894 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.
895
896
897 {{id name="02-chatmode"/}}
898
899 == Mode ==
900
901 Teamwire supports two chat modes. Change the current mode by enabling or disabling the **Allow to send messages** feature.
902
903 * **Normal**
904 //Allow to send messages// enabled
905 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.
906
907 * **Broadcast**
908 //Allow to send messages// disabled
909 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.
910 ## ##
911
912 {{id name="02-chatadministrators"/}}
913
914 == Administrators ==
915
916 This section lists all [[image:Public.Applications.Android.User-Manual.WebHome@icons-admin.svg]] administrators of the current chat.
917
918 Chat administrators can perfom advanced actions in a group chat:
919
920 * Manage chat members (add and remove)
921 * Manage chat administrators (promote and demote)
922 * Delete any message and attachment
923 * Close the chat
924 * Edit the chat title
925 * Edit the chat mode
926 * Edit the "Mute chat" permission (allow and disallow)
927 ## ##
928
929 In a 1:1 chat, both members become chat administrator by default.
930
931 **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.
932
933
934 {{id name="02-promotetoadmin"/}}
935
936 === Promote to chat admin ===
937
938 In the chat settings, tap [[image:Public.Applications.Android.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 and hold down on the user of concern, then select **Make chat admin.**
939
940
941 {{id name="02-demoteadmin"/}}
942
943 === Demote chat admin ===
944
945 In the chat settings, tap  [[image:Public.Applications.Android.User-Manual.WebHome@icons-admin.svg]] [[Admins>>doc:||anchor="02-chatadministrators"]] to see the list of the current chat's admins. Tap and hold down on the user of concern, then select **Remove** to demote them.
946
947 Chat admins can only remove the privileges of another chat admin, but not their own.
948
949
950 {{id name="02-members"/}}
951
952 == Members ==
953
954 This section lists all [[image:Public.Applications.Android.User-Manual.WebHome@icons-group.svg]] members of the current chat incl. chat administrators.
955
956 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.**
957
958
959 {{id name="02-addmoremembers"/}}
960
961 === Add members ===
962
963 Tap the uppermost option [[image:Public.Applications.Android.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.**
964
965
966 {{id name="02-removemembers"/}}
967
968 === Remove members ===
969
970 To remove a user from the chat, tap and hold down on their name in the list of chat members, then 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.
971
972
973 {{id name="02-readreceipts"/}}
974
975 = Read receipts =
976
977 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.
978
979 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.
980
981 {{info}}
982 Your Teamwire administrator may disable read receipts for all users.
983 {{/info}}
984
985
986 {{id name="02-mediaoverview"/}}
987
988 = Media overview =
989
990 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.
991
992 ## ##