Skip to Content

Wiki source code of b. Chats and Messaging

Last modified by teamwire003 on 2025/10/09 15:46
Show last authors
1 Starting Teamwire, the inbox is shown and presents you all chats you are involved in.
2
3 As you receive new messages, you will find a badge on your Teamwire app icon showing the number of **unread chats**. The respective chats 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.Desktop.User-Manual-Desktop4.WebHome@en_inbox-1.png||width="75%"]]
27 ## ##
28
29
30 {{id name="02-search"/}}
31
32 == Search ==
33
34 Atop your messages you find a [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-search.svg||height="20"]] search bar. The search will look up for chat titles, contacts, circles, and message content. Results are separated into said categories.
35
36 * Clicking on a search result will take you to the original message or chat.
37 * Clicking on a contact within your search results, their profile and contact info will be opened.
38 ## ##
39
40 {{id name="02-createnewchat"/}}
41
42 = Create a chat =
43
44 To create a new chat, use the button [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-chat-new.svg||height="20"]] atop your inbox, where you can then choose from the following options.
45
46
47 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-user.svg||height="20"]] [[1:1 Chat>>doc:||anchor="02-onetoonechat"]]
48
49 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-group.svg||height="20"]] [[Group Chat>>doc:||anchor="02-groupchat"]]
50
51 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-broadcast.svg||height="20"]] [[Broadcast>>doc:||anchor="02-broadcastchat"]]
52
53 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-federated.svg||height="20"]] [[Federated Chat>>doc:||anchor="02-federatedchat"]]
54 ## ##
55
56 {{id name="02-onetoonechat"/}}
57
58 == 1:1 chat ==
59
60 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-attachments"]] can be used.
61
62 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"]]).
63
64 {{warning}}
65 1:1 chats cannot be subsequently extended with additional users to form a group chat.
66 {{/warning}}
67
68
69 {{id name="02-groupchat"/}}
70
71 == Group chat ==
72
73 Select one or more [[participants>>doc:||anchor="02-selectparticipants"]] and set a [[chat title>>doc:||anchor="02-definechattitle"]]. You will enter the new chat automatically and will be able to compose your first message.
74
75 More information about chat content and actions are available [[here>>doc:||anchor="02-attachments"]].
76
77
78 {{id name="02-broadcastchat"/}}
79
80 == Broadcast chat ==
81
82 A broadcast chat is a group chat with the **broadcast **mode enabled. This mode is very useful for sharing announcements or briefings in your organisation.
83
84 Select one or more [[participants>>doc:||anchor="02-selectparticipants"]] and set a [[chat title>>doc:||anchor="02-definechattitle"]]. You will enter the new chat automatically and will be able to compose your first message.
85
86 More information about the broadcast chat mode are available [[here>>doc:||anchor="02-chatmode"]].
87
88
89 {{id name="02-federatedchat"/}}
90
91 == Federated chat ==
92
93 Federated chats allow communicating with users from other Teamwire Servers.
94
95 Select one or more [[participants>>doc:||anchor="02-selectparticipants"]] and set a [[chat title>>doc:||anchor="02-definechattitle"]]. You will enter the new chat automatically and will be able to compose your first message.
96
97
98 {{id name="02-federatedchat-contacts"/}}
99
100 === Available contacts ===
101
102 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.
103
104 Currently it is currently not possible to add more chat members to the chat later.
105
106
107 {{id name="02-federatedchat-content"/}}
108
109 === Available chat content ===
110
111 The range of [[chat content>>doc:||anchor="02-attachments"]] is limited.
112
113 Currently, the following attachment types are supported: photos, videos, files, attention messages and locations (viewing).
114
115
116 {{id name="02-federatedchat-removed"/}}
117
118 === Removed federations ===
119
120 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.
121
122
123 {{id name="02-selectparticipants"/}}
124
125 == Select participants ==
126
127 Select one or more users from your list of contacts by selecting the checkbox next to the user's name.
128
129 Already selected contacts are indicated with an  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons_box_selected.svg||height="20"]] and can be deselected by clicking again.
130
131 You can combine contacts, lists, circles and bots as recipients for a chat. On the right-hand side you can see an overview of all selected recipients and also remove them there.
132
133 Please note the **maximum of members** that can be added to a chat. This valua might be adjusted by your Teamwire administrator.
134
135 ## ##
136 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_newchat-1.png||width="75%"]]
137 ## ##
138
139 Your contacts are split into four types and are listed per section.
140
141 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-user.svg||height="20"]] [[Contacts>>doc:Public.Applications.Desktop.User-Manual-Desktop4.Contacts.WebHome||anchor="03-contacts"]]
142
143 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-userlist.svg||height="20"]] [[Lists>>doc:Public.Applications.Desktop.User-Manual-Desktop4.Contacts.WebHome||anchor="03-lists"]]
144
145 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-circle.svg||height="20"]] [[Circles>>doc:Public.Applications.Desktop.User-Manual-Desktop4.Contacts.WebHome||anchor="03-circles"]]
146
147 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-bot.svg||height="20"]] [[Bots>>doc:Public.Applications.Desktop.User-Manual-Desktop4.Contacts.WebHome||anchor="03-bots"]]
148 ## ##
149
150 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.Desktop.User-Manual-Desktop4.WebHome@icons-search.svg||height="20"]] **search bar** to find your contacts, lists, circles and bots per section. The search bar is located above the left-side list of contacts.
151
152
153 {{id name="02-definechattitle"/}}
154
155 == Define chat title ==
156
157 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"]].
158
159 **For group chats,** setting a title is mandatory.
160
161 ## ##
162 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_newchat-2.png||width="75%"]]
163 ## ##
164
165 Once you have made all the settings, click **Create**. You will then enter the new chat automatically and you will be able to compose your first message.
166
167
168 {{id name="02-voipcall"/}}
169
170 = Voice and video calls =
171
172 You can contact one or multiple users in your existing chats via voice or video call.
173
174 This feature is available for 1:1 chats and group chats.
175
176 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.
177
178 {{info}}
179 If voice and video calls are not available to you, the feature may have been disabled by your Teamwire administrator.
180 {{/info}}
181
182
183 {{id name="02-voipcall-start"/}}
184
185 == Start a call ==
186
187 Open an existing chat or [[create a new chat>>doc:||anchor="02-createnewchat"]] with your favoured participants.
188
189 Start the call by tapping the respective button in the upper-right corner of the screen.
190
191 Use  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-call-voice.svg||height="20"]] to start a voice call and  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-call-video.svg||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.
192
193 The other call participants will be notified, even if they are currently not actively using the Teamwire app.
194
195 **The number of participants for group calls is limited** and given by your Teamwire server admin.
196
197 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.Desktop.User-Manual-Desktop4.WebHome@icons-call-voice-plus.svg||height="20"]] for voice and [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-call-video-plus.svg||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.
198
199 ## ##
200 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_videocall-1.png||width="500"]] [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_videocall-2.png||width="500"]]
201 ## ##
202
203 {{id name="02-voipcall-join"/}}
204
205 == Join a call ==
206
207 If you have missed a call, you can also join it later.
208
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
211
212 {{id name="02-voipcall-features"/}}
213
214 == Features during a call ==
215
216 The following primary features are available during the call.
217
218 * Enable / disable microphone
219 * Enable / disable camera
220 * Select sound device
221 * Screen sharing
222 * Raise hand
223 * Toggle between front and backside camera
224 ## ##
225
226 {{id name="02-attachments"/}} {{id name="02-chatcontentsandactions"/}}
227
228 = Attachments =
229
230 In addition to texts and emojis, you can send various attachments via Teamwire. If you want to attach a photo, voice message, or the like, use one of the following options.
231
232
233 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-clip.svg||height="20"]] **Attach file**
234 Click to open your file explorer where you can select photos, videos, presentations and many other files to share in the chat. Alternatively, you can also drag and drop your documents into the Teamwire app to send them.
235
236
237 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-attach-voice.svg||height="20"]] **Record voice message**
238 Voice recording is limited to 180 seconds.
239
240
241 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-attach.svg||height="20"]] **Further attachments and features**
242 You will be listed further options for sharing content.
243
244
245 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-normal.svg||height="20"]] **Normal**
246 Default setting when sending messages. Use this option to no longer mark a message as an [[attention message>>doc:||anchor="02-attentionmessages"]].
247
248 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-alert.svg||height="20"]] **Alert**,  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-announce.svg||height="20"]] **Announcement**  or [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-note.svg||height="20"]] **Note**
249 These are so-called attention messages. More information about attention messages are available [[here>>path:#02-attentionmessages]].
250
251 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-attach-poll.svg||height="20"]] **Create poll**
252 Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
253 ## ##
254
255 {{info}}
256 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.
257 {{/info}}
258
259
260 {{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
261
262 = Attention messages =
263
264 Via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-attach.svg||height="20"]] next to the text input field, various types of attention message are available in Teamwire.
265
266 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.
267
268 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-alert.svg||height="20"]] **Alert**
269 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 in your [[App settings>>doc:Public.Applications.Desktop.User-Manual-Desktop4.Profile-and-Settings.WebHome||anchor="account-appset"]].
270
271 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-announce.svg||height="20"]] **Announcement**
272 Label your message as an announcement (text input turns green). Chat members can react to your message via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-emojithumb.svg||height="20"]] with a range of reactions.
273
274 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-note.svg||height="20"]] **Note**
275 Label your message as an note (text input turns yellow). Chat members can react to your message via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-emojithumb.svg||height="20"]] with a range of reactions.
276 ## ##
277
278 All message types above can be removed before sending by clicking the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-normal.svg||height="20"]] icon. Your message will be sent as normal text then.
279
280 {{info}}
281 If attention messages are not available to you, the feature may have been disabled by your Teamwire administrator.
282 {{/info}}
283
284
285 {{id name="02-ownattentionmessages"/}}
286
287 == Activity / Reactions ==
288
289 You can view the **reactions** to each of your attention messages via the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-report.svg||height="20"]] **report.**
290
291 ## ##
292 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_attentionreport.png||width="75%"]]
293 ## ##
294
295 {{id name="02-livelocation"/}}
296
297 = Live location =
298
299 **Teamwire mobile app** users can send their location once or share it live with all chat members over a defined period of time.
300
301 In the desktop app, you are able to open the live location by clicking on the map preview in the chat.
302
303 In one chat, multiple users may share their live location at the same time. Their locations will be shown in a single map.
304
305 ## ##
306 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_livelocation-1.png||width="75%"]]
307 ## ##
308
309 The live map offers different tools and settings to view users and map material.
310
311 * **Focus user**
312 Click 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.
313
314 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-tune.svg||height="20"]] **Map settings**
315 Tippen Sie auf dieses Symbol, um die Karteneinstellungen aufzurufen.
316 ## ##
317 ** **Show user names**
318 If enabled, in addition to the user photos, their names will be displayed on the map, too.
319
320 ** **Show user role**
321 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).
322
323 ** **Group users**
324 Enabled by default. Users who are in close proximity to each other are grouped together.
325 ## ##
326
327 {{id name="meaction"/}}
328
329 = Message actions =
330
331 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.
332
333
334 {{id name="02-replytomessage"/}}
335
336 == Reply ==
337
338 Move your cursor over the respective message or attachment, and click on the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu.
339
340 Select [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-reply.svg||height="20"]] **Reply** to add a quote of the original message when sending your answer. This is especially useful in conversations with a lot of users and multiple topics. Replys help you and others to remember the context of a message.
341
342
343 {{id name="02-forwardmessage"/}}
344
345 == Forward ==
346
347 Move your cursor over the respective message or attachment, and click on the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu.
348
349 Select [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-forward.svg||height="20"]] **Forward** to receive a list of existing chats to which you can forward the content. If you want to forward a message or attachment to a contact, list, or circle you haven't had a conversation with yet, click [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-chat-new.svg||height="20"]] **New Chat** and start selecting your participants.
350
351
352 {{id name="02-pinmessage"/}}
353
354 == Pin ==
355
356 By pinning messages, you can make important or frequently needed information easily accessible and save chat participants the time to search for it.
357
358 Move your cursor over the respective message or attachment, and click on the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu.
359
360 Select [[image:Public.Applications.Desktop.User-Manual-Desktop4.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.
361
362 ## ##
363 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_chatview-pin.png||width="75%"]]
364 ## ##
365
366 To remove a pinned message, hover your cursor over the respective message in the pin bar, click on the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu, and select [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-unpin.svg]] **Unpin**.
367
368 {{info}}
369 When you open a chat, the pin bar displays the latest pinned message by default. Click on the pin bar to scroll to the original message within the chat. Tapping the pin bar again will display the next pinned message.
370
371 **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.
372 {{/info}}
373
374
375 {{id name="02-deletemessage"/}}
376
377 == Delete ==
378
379 You can delete your own messages and attachments in Teamwire, even if they have already been read.
380
381 Move your cursor over the respective message or attachment, then click on the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu and select  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-bin.svg||height="20"]] **Delete** to remove it permanently.
382
383 {{info}}
384 In addition, [[chat admins>>||anchor="02-chatadministrators"]] are able remove your messages and attachments, too.
385
386 If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
387 {{/info}}
388
389
390 {{id name="02-chatadministration"/}}
391
392 = Chat actions =
393
394 These are actions that can be performed on your existing chats.
395
396
397 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-unread.svg||height="20"]] [[Mark chat as read / unread>>doc:||anchor="chaction-unread"]]
398
399 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-pin.svg||height="20"]] [[Pin chat>>doc:||anchor="chaction-pin"]]
400
401 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-favourite.svg||height="20"]] [[Favourite chat>>doc:||anchor="chaction-favourite"]]
402
403 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-mute.svg||height="20"]] [[Mute chat>>doc:||anchor="02-mutechat"]]
404
405 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-archive.svg||height="20"]] [[Archive chat>>doc:||anchor="02-archivechat"]]
406
407 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-leave.svg||height="20"]] [[Leave chat>>doc:||anchor="02-leavechat"]]
408
409 * [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-lock.svg||height="20"]] [[Close chat>>doc:||anchor="02-closechat"]]
410 ## ##
411
412 {{id name="chaction-unread"/}}
413
414 == Mark as read / unread ==
415
416 **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"]].
417
418 Move your cursor over the respective chat in your inbox, then click on the  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu and select  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-read.svg||height="20"]] **Mark as read**.
419
420
421 **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.
422
423 Move your cursor over the respective chat in your inbox and click on the  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu. Select  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-unread.svg||height="20"]] **Mark as unread**.
424
425
426 {{id name="chaction-pin"/}}
427 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_inboxactions.png||data-xwiki-image-style-alignment="end" width="300"]]
428
429 == Pin ==
430
431 This is a personal setting and will only affect your own chats and inbox.
432
433
434 Pinned chats stay on top of your inbox, even if other chats have newer messages.
435
436 Move your cursor over the respective chat in your inbox, then click on the  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu and select  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-pin.svg||height="20"]] **Pin**.
437
438
439 In the same way, you can [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-unpin.svg||height="20"]] **Unpin** a chat again.
440
441 {{info}}
442 A chat that receives an [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-am-alert.svg||height="20"]] **alert **will continue to move **atop of your pinned chats** until its messages have been read.
443 {{/info}}
444
445
446 {{id name="chaction-favourite"/}}
447
448 == Favourite ==
449
450 This is a personal setting and will only affect your own chats and inbox.
451
452
453 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.
454
455 Move your cursor over the respective chat in your inbox, then click on the  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu and select  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-favourite.svg||height="20"]] **Favourite**.
456
457
458 In the same way, you can [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-unfavourite.svg||height="20"]] **Unfavourite** a chat again.
459
460
461 {{id name="02-mutechat"/}}
462
463 == Mute ==
464
465 This is a personal setting and will only affect your own chats and inbox.
466
467
468 Muted chats will no longer notify you about new messages via sound or push notification. This applies only per muted chat. The app icon in your taskbar will keep showing the number of unread chats.
469
470 You have multiple options to [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-mute.svg||height="20"]] **Mute** a chat.
471
472 * Move your cursor over the respective chat in your inbox, then click on the  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu and select the action.
473 * Open the chat and select the action via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] in the upper-right corner.
474 ## ##
475
476 In the same way, you can [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-notification.svg||height="20"]] **Unmute** a chat to receive its notifications again.
477
478 {{info}}
479 If you cannot mute a chat, the feature may have been disabled by your Teamwire administrator or by a chat admin.
480 {{/info}}
481
482
483 {{id name="02-archivechat"/}}
484
485 == Archive ==
486
487 This is a personal setting and will only affect your own chats and inbox.
488
489
490 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 All tab** and are moved to the [[**Archived** tab>>doc:||anchor="02-filter"]] in your inbox.
491
492 You have multiple options to [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-archive.svg||height="20"]] **Archive** a chat.
493
494 * Move your cursor over the respective chat in your inbox, then click on the  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu and select the action.
495 * Open the chat and select the action via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] in the upper-right corner.
496 ## ##
497
498 In the same way, you can [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-unarchive.svg||height="20"]] **Unarchive** a chat from the Archived tab.
499
500 ## ##
501 [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@en_chatsettings.png||width="75%"]]
502 ## ##
503
504 {{id name="02-leavechat"/}}
505
506 == Leave ==
507
508 You may leave a chat if you no longer want to be part of the conversation, or your participation is no longer required.
509
510 You have multiple options to [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-leave.svg||height="20"]] **Leave** a chat.
511
512 * Move your cursor over the respective chat in your inbox, then click on the  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu and select the action.
513 * Open the chat and select the action via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] in the upper-right corner.
514 ## ##
515
516 To rejoin a chat, one of the [[chat admins>>doc:||anchor="02-chatadministrators"]] can add you again.
517
518 {{info}}
519 If you cannot leave a chat, the feature may have been disabled by your Teamwire administrator.
520
521 Please note that you cannot leave chats in which you have been added as part of a [[circle>>doc:Public.Applications.Desktop.User-Manual-Desktop4.WebHome||anchor="03-circles"]].
522 {{/info}}
523
524
525 {{id name="02-closechat"/}}
526
527 == Close ==
528
529 This is an administrative setting and will affect all members of the chat.
530
531
532 Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] can close a chat.
533 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.
534
535 You have multiple options to [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-lock.svg||height="20"]] **Close** a chat.
536
537 * Move your cursor over the respective chat in your inbox, then click on the  [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] icon to open the action menu and select the action.
538 * Open the chat and select the action via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] in the upper-right corner.
539 ## ##
540
541 If you are a chat admin, you can [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-unlock.svg||height="20"]] **Reopen** the chat in the chat view.
542
543 {{info}}
544 If you cannot close a chat, the feature may have been disabled by your Teamwire administrator.
545 {{/info}}
546
547
548 {{id name="02-chattoPDF"/}}
549
550 == Export chat history ==
551
552 To export and save a chat as a PDF file, open the chat and select the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-file-pdf.svg||height="20"]] **Export chat history** action via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] in the upper-right corner.
553
554 In the next screen, select the period to be saved and confirm with **Export to PDF**. You can now specify the location where to store the PDF at.
555
556 Please note that some attachments may not be available in the PDF format.
557
558
559 {{id name="02-chatsettings"/}}
560
561 = Chat settings =
562
563 Open the chat and select [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-settings.svg||height="20"]] **Chat settings** via [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] in the upper-right corner. Among other things, here you can edit the title or add more users to the conversation.
564
565 {{info}}
566 Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
567 {{/info}}
568
569
570 {{id name="02-chatavatar"/}}
571
572 == Avatar ==
573
574 Click on the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-camera.svg||height="20"]] icon in the current avatar to **change** or **remove** it. The new avatar will be shown to all members of the conversation.
575
576
577 {{id name="02-chattitle"/}}
578
579 == Title ==
580
581 Below the avatar is a text field called **Chat name** where you can edit the current title. Confirm your entry and the new titel will be shown to all members of the conversation.
582
583 Please note that changing the chat title is only available in group chats.
584
585
586 {{id name="02-chatmode"/}}
587
588 == Mode ==
589
590 Teamwire supports two chat modes. Change the current mode by enabling or disabling the **Allow to send messages** feature.
591
592 * **Normal**
593 "Allow to send messages" enabled
594 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.
595
596 * **Broadcast**
597 "Allow to send messages" disabled
598 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.
599 ## ##
600
601 {{id name="02-members"/}}
602
603 == Members ==
604
605 The currently viewed chat's **members** and the **chat admins** are listed here.
606
607 If the chat was created or expanded by adding a circle, its name will be shown. The members of the circle can be viewed by opening the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] context menu and selecting [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-group.svg||height="20"]] **Members**.
608
609
610 {{id name="02-addmoremembers"/}}
611
612 === Add members ===
613
614 In the list of chat members, select the option [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-adduser.svg||height="20"]] **Add members**. You will be forwarded to your directory from which you can add further users and/or circles. Confirm your selection with **Done**.
615
616
617 {{id name="02-removemembers"/}}
618
619 === Remove members ===
620
621 If you are a chat admin, you can remove users and circles in the list of chat members. Open the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] context menu and select [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-bin.svg||height="20"]] **Remove member**. You cannot remove individual users which have been added via circle. You have to remove the complete circle from the chat instead.
622
623
624 {{id name="02-chatadministrators"/}}
625
626 == Administrators ==
627
628 Chat administrators are included in the chat's list of **members**. They are highlighted by a respective label ( [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-adminlabel.svg||height="20"]] ).
629
630 Chat administrators can perfom advanced actions in a group chat:
631
632 * Manage chat members (add and remove)
633 * Manage chat administrators (promote and demote)
634 * Delete any message and attachment
635 * Close the chat
636 * Edit the chat title
637 * Edit the chat mode
638 * Edit the "Mute chat" permission (allow and disallow)
639 ## ##
640
641 In a 1:1 chat, both members become chat administrator by default.
642
643 **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.Desktop.User-Manual-Desktop4.Contacts.WebHome||anchor="03-circles"]] or [[lists>>doc:Public.Applications.Desktop.User-Manual-Desktop4.Contacts.WebHome||anchor="03-lists"]], or by a mix of all options mentioned.
644
645
646 {{id name="02-promotetoadmin"/}}
647
648 === Promote to chat admin ===
649
650 In the chat settings, open the list of members. If the chat was created or expanded by adding a circle, its name will be shown. It's members are listed when clicking on the circle's name or via the [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] context menu and selecting [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-group.svg||height="20"]] **Members**.
651
652 Open the user's [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-more.svg||height="20"]] context menu and there select [[image:Public.Applications.Desktop.User-Manual-Desktop4.WebHome@icons-admin.svg||height="20"]] **Make chat admin**.
653
654
655 {{id name="02-demoteadmin"/}}
656
657 === Demote chat admin ===
658
659 In the Teamwire desktop app, the privileges of an admin cannot be revoked.
660
661 You may use the following workaround: Remove the user from the current group 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.
662
663
664 {{id name="02-readreceipts"/}}
665
666 = Read receipts =
667
668 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.
669
670 Click on individual read receipts respectively user avatars to view the user's contact information. If not all read receipts can be displayed, you will find the number of all read receipts at the end of the line. Click here to see a detailed overview of the current read receipts and a complete list of members.
671
672 {{info}}
673 Your Teamwire administrator may disable read receipts for all users.
674 {{/info}}
675
676 ## ##