Wiki source code of b. Chats and Messaging

Last modified by teamwire003 on 2024/10/17 10:46

version	line-number	content
3.5	1	Starting Teamwire, the inbox is shown and presents you all chats you are involved in.
1.1	2
3.5	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.
1.1	4
	5
3.5	6	{{id name="02-filter"/}}
1.1	7
	8	= Inbox =
	9
3.5	10	Your inbox provides four tabs which allow you to switch between the most important chat type criteria.
1.1	11
3.5	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.
1.1	14
3.5	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.WebHome@en_inbox-1.png\|\|width="75%"]]
	27	## ##
	28
	29
1.1	30	{{id name="02-search"/}}
	31
	32	== Search ==
	33
3.5	34	Atop your messages you find a [[image:Public.Applications.Desktop.User-Manual.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.
1.1	35
2.1	36	* Clicking on a search result will take you to the original message or chat.
3.5	37	* Clicking on a contact within your search results, their profile and contact info will be opened.
2.1	38	## ##
1.1	39
	40	{{id name="02-createnewchat"/}}
	41
2.1	42	= Create a chat =
1.1	43
3.5	44	To create a new chat, use the button [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-chat-new.svg\|\|height="20"]] atop your inbox, where you can then choose from the following options.
1.1	45
3.5	46
	47	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-user.svg\|\|height="20"]] [[1:1 Chat>>doc:\|\|anchor="02-onetoonechat"]]
	48
	49	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-group.svg\|\|height="20"]] [[Group Chat>>doc:\|\|anchor="02-groupchat"]]
	50
	51	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-broadcast.svg\|\|height="20"]] [[Broadcast>>doc:\|\|anchor="02-broadcastchat"]]
	52
	53	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-federated.svg\|\|height="20"]] [[Federated Chat>>doc:\|\|anchor="02-federatedchat"]]
2.1	54	## ##
1.1	55
2.1	56	{{id name="02-onetoonechat"/}}
1.1	57
2.1	58	== 1:1 chat ==
1.1	59
3.5	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.
1.1	61
2.1	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"]]).
1.1	63
2.1	64	(% class="box warningmessage" %)
	65	(((
	66	1:1 chats cannot be subsequently extended with additional users to form a group chat.
	67	)))
1.1	68
2.1	69	{{id name="02-groupchat"/}}
1.1	70
2.1	71	== Group chat ==
1.1	72
3.5	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.
1.1	74
3.5	75	More information about chat content and actions are available [[here>>doc:\|\|anchor="02-attachments"]].
1.1	76
	77
2.1	78	{{id name="02-broadcastchat"/}}
1.1	79
2.1	80	== Broadcast chat ==
1.1	81
3.5	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.
1.1	83
3.5	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.
1.1	85
2.1	86	More information about the broadcast chat mode are available [[here>>doc:\|\|anchor="02-chatmode"]].
1.1	87
2.1	88
	89	{{id name="02-federatedchat"/}}
	90
	91	== Federated chat ==
	92
	93	Federated chats allow communicating with users from other Teamwire Servers.
	94
3.5	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.
2.1	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
3.5	111	The range of [[chat content>>doc:\|\|anchor="02-attachments"]] is limited.
2.1	112
3.5	113	Currently, the following attachment types are supported: photos, videos, files, attention messages and locations (viewing).
2.1	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"/}}
1.1	124
2.1	125	== Select participants ==
1.1	126
2.1	127	Select one or more users from your list of contacts by selecting the checkbox next to the user's name.
1.1	128
3.5	129	Already selected contacts are indicated with an [[image:Public.Applications.Desktop.User-Manual.WebHome@icons_box_selected.svg\|\|height="20"]] and can be deselected by clicking again.
2.1	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
3.5	133	Please note the maximum of members that can be added to a chat. This valua might be adjusted by your Teamwire administrator.
2.1	134
	135	## ##
3.5	136	[[image:Public.Applications.Desktop.User-Manual.WebHome@en_newchat-1.png\|\|width="75%"]]
2.1	137	## ##
	138
	139	Your contacts are split into four types and are listed per section.
	140
3.5	141	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-user.svg\|\|height="20"]] [[Contacts>>doc:Public.Applications.Desktop.User-Manual.Contacts.WebHome\|\|anchor="03-contacts"]]
	142
	143	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-userlist.svg\|\|height="20"]] [[Lists>>doc:Public.Applications.Desktop.User-Manual.Contacts.WebHome\|\|anchor="03-lists"]]
	144
	145	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-circle.svg\|\|height="20"]] [[Circles>>doc:Public.Applications.Desktop.User-Manual.Contacts.WebHome\|\|anchor="03-circles"]]
	146
	147	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-bot.svg\|\|height="20"]] [[Bots>>doc:Public.Applications.Desktop.User-Manual.Contacts.WebHome\|\|anchor="03-bots"]]
2.1	148	## ##
	149
3.5	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.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.
2.1	151
	152
3.5	153	{{id name="02-definechattitle"/}}
1.1	154
3.5	155	== Define chat title ==
1.1	156
3.5	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"]].
1.1	158
3.5	159	For group chats, setting a title is mandatory.
	160
2.1	161	## ##
3.5	162	[[image:Public.Applications.Desktop.User-Manual.WebHome@en_newchat-2.png\|\|width="75%"]]
	163	## ##
1.1	164
3.5	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.
1.1	166
	167
3.1	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	(% class="box infomessage" %)
	179	(((
	180	If voice and video calls are not available to you, the feature may have been disabled by your Teamwire administrator.
	181	)))
	182
	183	{{id name="02-voipcall-start"/}}
	184
	185	== Start a call ==
	186
3.5	187	Open an existing chat or [[create a new chat>>doc:\|\|anchor="02-createnewchat"]] with your favoured participants.
3.1	188
3.5	189	Start the call by tapping the respective button in the upper-right corner of the screen.
3.1	190
3.5	191	Use [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-call-voice.svg\|\|height="20"]] to start a voice call and [[image:Public.Applications.Desktop.User-Manual.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.
3.1	192
	193	The other call participants will be notified, even if they are currently not actively using the Teamwire app.
	194
3.5	195	The number of participants for group calls is limited and given by your Teamwire server admin.
3.1	196
3.5	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.WebHome@icons-call-voice-plus.svg\|\|height="20"]] for voice and [[image:Public.Applications.Desktop.User-Manual.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.
3.1	198
3.5	199	## ##
	200	[[image:Public.Applications.Desktop.User-Manual.WebHome@en_videocall-1.png\|\|width="500"]] [[image:Public.Applications.Desktop.User-Manual.WebHome@en_videocall-2.png\|\|width="500"]]
	201	## ##
3.1	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
3.5	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.
3.1	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
3.5	223	* Toggle between front and backside camera
3.1	224	## ##
	225
3.5	226	{{id name="02-attachments"/}} {{id name="02-chatcontentsandactions"/}}
1.1	227
3.5	228	= Attachments =
1.1	229
3.5	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.
1.1	231
	232
3.5	233	[[image:Public.Applications.Desktop.User-Manual.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
1.1	236
3.5	237	[[image:Public.Applications.Desktop.User-Manual.WebHome@icons-attach-voice.svg\|\|height="20"]] Record voice message
	238	Voice recording is limited to 180 seconds.
	239
1.1	240
3.5	241	[[image:Public.Applications.Desktop.User-Manual.WebHome@icons-attach.svg\|\|height="20"]] Further attachments and features
	242	You will be listed further options for sharing content.
1.1	243
	244
3.5	245	* [[image:Public.Applications.Desktop.User-Manual.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.WebHome@icons-am-alert.svg\|\|height="20"]] Alert, [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-am-announce.svg\|\|height="20"]] Announcement or [[image:Public.Applications.Desktop.User-Manual.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.WebHome@icons-attach-poll.svg\|\|height="20"]] Create poll
	252	Create a poll (interactive attachment) with up to five options and let your chat members vote to make decisions more quickly.
	253	## ##
1.1	254
2.1	255	(% class="box infomessage" %)
	256	(((
	257	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.
	258	)))
1.1	259
3.5	260
2.1	261	{{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
1.1	262
3.5	263	= Attention messages =
1.1	264
3.5	265	Via [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-attach.svg\|\|height="20"]] next to the text input field, various types of attention message are available in Teamwire.
1.1	266
2.1	267	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.
1.1	268
3.5	269	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-am-alert.svg\|\|height="20"]] Alert
	270	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.Profile-and-Settings.WebHome\|\|anchor="account-appset"]].
1.1	271
3.5	272	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-am-announce.svg\|\|height="20"]] Announcement
	273	Label your message as an announcement (text input turns green). Chat members can react to your message via [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-emojithumb.svg\|\|height="20"]] with a range of reactions.
1.1	274
3.5	275	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-am-note.svg\|\|height="20"]] Note
	276	Label your message as an note (text input turns yellow). Chat members can react to your message via [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-emojithumb.svg\|\|height="20"]] with a range of reactions.
2.1	277	## ##
1.1	278
3.5	279	All message types above can be removed before sending by clicking the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-am-normal.svg\|\|height="20"]] icon. Your message will be sent as normal text then.
1.1	280
2.1	281	(% class="box infomessage" %)
1.1	282	(((
2.1	283	If attention messages are not available to you, the feature may have been disabled by your Teamwire administrator.
1.1	284	)))
	285
2.1	286	{{id name="02-ownattentionmessages"/}}
1.1	287
3.5	288	== Activity / Reactions ==
1.1	289
3.5	290	You can view the reactions to each of your attention messages via the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-report.svg\|\|height="20"]] report.
1.1	291
3.5	292	## ##
	293	[[image:Public.Applications.Desktop.User-Manual.WebHome@en_attentionreport.png\|\|width="75%"]]
	294	## ##
1.1	295
3.2	296	{{id name="02-livelocation"/}}
	297
3.5	298	= Live location =
3.2	299
3.5	300	Teamwire mobile app users can send their location once or share it live with all chat members over a defined period of time.
3.2	301
3.5	302	In the desktop app, you are able to open the live location by clicking on the map preview in the chat.
3.2	303
3.5	304	In one chat, multiple users may share their live location at the same time. Their locations will be shown in a single map.
3.2	305
3.5	306	## ##
	307	[[image:Public.Applications.Desktop.User-Manual.WebHome@en_livelocation-1.png\|\|width="75%"]]
	308	## ##
3.2	309
3.5	310	The live map offers different tools and settings to view users and map material.
3.2	311
	312	* Focus user
3.5	313	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.
	314
	315	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-tune.svg\|\|height="20"]] Map settings
	316	Tippen Sie auf dieses Symbol, um die Karteneinstellungen aufzurufen.
3.2	317	## ##
3.5	318	Show user names**
3.2	319	If enabled, in addition to the user photos, their names will be displayed on the map, too.
	320
3.5	321	Show user role**
3.2	322	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).
3.5	323
	324	Group users**
	325	Enabled by default. Users who are in close proximity to each other are grouped together.
3.2	326	## ##
	327
3.5	328	{{id name="meaction"/}}
3.4	329
3.5	330	= Message actions =
3.4	331
3.5	332	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.
3.4	333
	334
3.5	335	{{id name="02-replytomessage"/}}
1.1	336
3.5	337	== Reply ==
2.1	338
3.5	339	Move your cursor over the respective message or attachment, and click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu.
2.1	340
3.5	341	Select [[image:Public.Applications.Desktop.User-Manual.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.
2.1	342
	343
3.5	344	{{id name="02-forwardmessage"/}}
2.1	345
3.5	346	== Forward ==
2.1	347
3.5	348	Move your cursor over the respective message or attachment, and click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu.
2.1	349
3.5	350	Select [[image:Public.Applications.Desktop.User-Manual.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.WebHome@icons-chat-new.svg\|\|height="20"]] New Chat and start selecting your participants.
2.1	351
3.5	352
	353	{{id name="02-deletemessage"/}}
	354
	355	== Delete ==
	356
	357	You can delete your own messages and attachments in Teamwire, even if they have already been read.
	358
	359	Move your cursor over the respective message or attachment, then click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu and select [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-bin.svg\|\|height="20"]] Delete to remove it permanently.
	360
2.1	361	(% class="box infomessage" %)
1.1	362	(((
3.5	363	If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
1.1	364	)))
	365
	366
3.5	367	{{id name="02-chatadministration"/}}
1.1	368
3.5	369	= Chat actions =
1.1	370
3.5	371	These are actions that can be performed on your existing chats.
1.1	372
	373
3.5	374	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-unread.svg\|\|height="20"]] [[Mark chat as read / unread>>doc:\|\|anchor="chaction-unread"]]
1.1	375
3.5	376	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-pin.svg\|\|height="20"]] [[Pin chat>>doc:\|\|anchor="chaction-pin"]]
1.1	377
3.5	378	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-favourite.svg\|\|height="20"]] [[Favourite chat>>doc:\|\|anchor="chaction-favourite"]]
1.1	379
3.5	380	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-mute.svg\|\|height="20"]] [[Mute chat>>doc:\|\|anchor="02-mutechat"]]
2.1	381
3.5	382	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-archive.svg\|\|height="20"]] [[Archive chat>>doc:\|\|anchor="02-archivechat"]]
2.1	383
3.5	384	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-leave.svg\|\|height="20"]] [[Leave chat>>doc:\|\|anchor="02-leavechat"]]
1.1	385
3.5	386	* [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-lock.svg\|\|height="20"]] [[Close chat>>doc:\|\|anchor="02-closechat"]]
	387	## ##
1.1	388
3.5	389	{{id name="chaction-unread"/}}
1.1	390
3.5	391	== Mark as read / unread ==
1.1	392
3.5	393	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"]].
1.1	394
3.5	395	Move your cursor over the respective chat in your inbox, then click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu and select [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-read.svg\|\|height="20"]] Mark as read.
1.1	396
	397
3.5	398	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.
1.1	399
3.5	400	Move your cursor over the respective chat in your inbox and click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu. Select [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-unread.svg\|\|height="20"]] Mark as unread.
1.1	401
	402
3.5	403	{{id name="chaction-pin"/}}
	404	[[image:Public.Applications.Desktop.User-Manual.WebHome@en_inboxactions.png\|\|data-xwiki-image-style-alignment="end" width="300"]]
1.1	405
3.5	406	== Pin ==
1.1	407
3.5	408	This is a personal setting and will only affect your own chats and inbox.
1.1	409
	410
3.5	411	Pinned chats stay on top of your inbox, even if other chats have newer messages.
1.1	412
3.5	413	Move your cursor over the respective chat in your inbox, then click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu and select [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-pin.svg\|\|height="20"]] Pin.
1.1	414
3.5	415
	416	In the same way, you can [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-unpin.svg\|\|height="20"]] Unpin a chat again.
	417
1.1	418	(% class="box infomessage" %)
	419	(((
3.5	420	A chat that receives an [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-am-alert.svg\|\|height="20"]] alert will continue to move atop of your pinned chats until its messages have been read.
1.1	421	)))
	422
3.5	423	{{id name="chaction-favourite"/}}
1.1	424
3.5	425	== Favourite ==
1.1	426
3.5	427	This is a personal setting and will only affect your own chats and inbox.
1.1	428
	429
3.5	430	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.
1.1	431
3.5	432	Move your cursor over the respective chat in your inbox, then click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu and select [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-favourite.svg\|\|height="20"]] Favourite.
1.1	433
	434
3.5	435	In the same way, you can [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-unfavourite.svg\|\|height="20"]] Unfavourite a chat again.
1.1	436
	437
3.5	438	{{id name="02-mutechat"/}}
1.1	439
3.5	440	== Mute ==
1.1	441
3.5	442	This is a personal setting and will only affect your own chats and inbox.
1.1	443
	444
3.5	445	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.
1.1	446
3.5	447	You have multiple options to [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-mute.svg\|\|height="20"]] Mute a chat.
	448
	449	* Move your cursor over the respective chat in your inbox, then click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu and select the action.
	450	* Open the chat and select the action via [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] in the upper-right corner.
2.1	451	## ##
1.1	452
3.5	453	In the same way, you can [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-notification.svg\|\|height="20"]] Unmute a chat to receive its notifications again.
1.1	454
3.5	455	(% class="box infomessage" %)
	456	(((
	457	If you cannot mute a chat, the feature may have been disabled by your Teamwire administrator or by a chat admin.
	458	)))
1.1	459
3.5	460	{{id name="02-archivechat"/}}
1.1	461
3.5	462	== Archive ==
1.1	463
3.5	464	This is a personal setting and will only affect your own chats and inbox.
1.1	465
	466
3.5	467	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.
1.1	468
3.5	469	You have multiple options to [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-archive.svg\|\|height="20"]] Archive a chat.
1.1	470
3.5	471	* Move your cursor over the respective chat in your inbox, then click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu and select the action.
	472	* Open the chat and select the action via [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] in the upper-right corner.
	473	## ##
1.1	474
3.5	475	In the same way, you can [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-unarchive.svg\|\|height="20"]] Unarchive a chat from the Archived tab.
1.1	476
3.5	477	## ##
	478	[[image:Public.Applications.Desktop.User-Manual.WebHome@en_chatsettings.png\|\|width="75%"]]
	479	## ##
1.1	480
3.5	481	{{id name="02-leavechat"/}}
1.1	482
3.5	483	== Leave ==
1.1	484
3.5	485	You may leave a chat if you no longer want to be part of the conversation, or your participation is no longer required.
1.1	486
3.5	487	You have multiple options to [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-leave.svg\|\|height="20"]] Leave a chat.
1.1	488
3.5	489	* Move your cursor over the respective chat in your inbox, then click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu and select the action.
	490	* Open the chat and select the action via [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] in the upper-right corner.
	491	## ##
1.1	492
3.5	493	To rejoin a chat, one of the [[chat admins>>doc:\|\|anchor="02-chatadministrators"]] can add you again.
1.1	494
	495	(% class="box infomessage" %)
	496	(((
3.5	497	If you cannot leave a chat, the feature may have been disabled by your Teamwire administrator.
	498
	499	Please note that you cannot leave chats in which you have been added as part of a [[circle>>doc:Public.Applications.Desktop.User-Manual.WebHome\|\|anchor="03-circles"]].
1.1	500	)))
	501
3.5	502	{{id name="02-closechat"/}}
1.1	503
3.5	504	== Close ==
1.1	505
3.5	506	This is an administrative setting and will affect all members of the chat.
1.1	507
	508
3.5	509	Only [[chat administrators>>doc:\|\|anchor="02-chatadministrators"]] can close a chat.
	510	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.
1.1	511
3.5	512	You have multiple options to [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-lock.svg\|\|height="20"]] Close a chat.
1.1	513
3.5	514	* Move your cursor over the respective chat in your inbox, then click on the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] icon to open the action menu and select the action.
	515	* Open the chat and select the action via [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] in the upper-right corner.
	516	## ##
1.1	517
3.5	518	If you are a chat admin, you can [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-unlock.svg\|\|height="20"]] Reopen the chat in the chat view.
1.1	519
3.5	520	(% class="box infomessage" %)
	521	(((
	522	If you cannot close a chat, the feature may have been disabled by your Teamwire administrator.
	523	)))
1.1	524
3.5	525	{{id name="02-chattoPDF"/}}
1.1	526
3.5	527	== Export chat history ==
1.1	528
3.5	529	To export and save a chat as a PDF file, open the chat and select the [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-file-pdf.svg\|\|height="20"]] Export chat history action via [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] in the upper-right corner.
1.1	530
3.5	531	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.
1.1	532
3.5	533	Please note that some attachments may not be available in the PDF format.
1.1	534
	535
3.5	536	{{id name="02-chatsettings"/}}
1.1	537
3.5	538	= Chat settings =
1.1	539
3.5	540	Open the chat and select [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-settings.svg\|\|height="20"]] Chat settings via [[image:Public.Applications.Desktop.User-Manual.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.
1.1	541
3.5	542	(% class="box infomessage" %)
	543	(((
	544	Only [[chat administrators>>doc:\|\|anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
	545	)))
1.1	546
3.5	547	{{id name="02-chatavatar"/}}
1.1	548
3.5	549	== Avatar ==
1.1	550
3.5	551	Click on the [[image:Public.Applications.Desktop.User-Manual.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.
1.1	552
	553
3.5	554	{{id name="02-chattitle"/}}
2.1	555
3.5	556	== Title ==
1.1	557
3.5	558	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.
1.1	559
3.5	560	Please note that changing the chat title is only available in group chats.
	561
	562
	563	{{id name="02-chatmode"/}}
	564
	565	== Mode ==
	566
	567	Teamwire supports two chat modes. Change the current mode by enabling or disabling the Allow to send messages feature.
	568
	569	* Normal
	570	"Allow to send messages" enabled
	571	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.
	572
	573	* Broadcast
	574	"Allow to send messages" disabled
	575	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.
2.1	576	## ##
1.1	577
3.5	578	{{id name="02-members"/}}
1.1	579
3.5	580	== Members ==
1.1	581
3.5	582	The currently viewed chat's members and the chat admins are listed here.
1.1	583
3.5	584	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.WebHome@icons-more.svg\|\|height="20"]] context menu and selecting [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-group.svg\|\|height="20"]] Members.
1.1	585
	586
3.5	587	{{id name="02-addmoremembers"/}}
2.1	588
3.5	589	=== Add members ===
1.1	590
3.5	591	In the list of chat members, select the option [[image:Public.Applications.Desktop.User-Manual.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.
1.1	592
	593
3.5	594	{{id name="02-removemembers"/}}
1.1	595
3.5	596	=== Remove members ===
2.1	597
3.5	598	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.WebHome@icons-more.svg\|\|height="20"]] context menu and select [[image:Public.Applications.Desktop.User-Manual.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.
2.1	599
	600
3.5	601	{{id name="02-chatadministrators"/}}
2.1	602
3.5	603	== Administrators ==
2.1	604
3.5	605	Chat administrators are included in the chat's list of members. They are highlighted by a respective label ( [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-adminlabel.svg\|\|height="20"]] ).
2.1	606
3.5	607	Chat administrators are able to make changes in the chat settings, e.g. editing the chat title and chat mode, or promote other members to become an admin.
2.1	608
3.5	609	In a 1:1 chat, both members become chat administrator by default.
2.1	610
3.5	611	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 or lists, or by a mix of all options mentioned.
1.1	612
	613
3.5	614	{{id name="02-promotetoadmin"/}}
1.1	615
3.5	616	=== Promote to chat admin ===
1.1	617
3.5	618	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.WebHome@icons-more.svg\|\|height="20"]] context menu and selecting [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-group.svg\|\|height="20"]] Members.
1.1	619
3.5	620	Open the user's [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-more.svg\|\|height="20"]] context menu and there select [[image:Public.Applications.Desktop.User-Manual.WebHome@icons-admin.svg\|\|height="20"]] Make chat admin.
2.1	621
1.1	622
3.5	623	{{id name="02-demoteadmin"/}}
1.1	624
3.5	625	=== Demote chat admin ===
1.1	626
3.5	627	In the Teamwire desktop app, the privileges of an admin cannot be revoked.
1.1	628
3.5	629	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.
1.1	630
3.5	631
	632	{{id name="02-readreceipts"/}}
	633
	634	= Read receipts =
	635
	636	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.
	637
	638	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.
	639
	640	(% class="box infomessage" %)
	641	(((
	642	Your Teamwire administrator may disable read receipts for all users.
	643	)))
	644
1.1	645	## ##

Wiki source code of b. Chats and Messaging

Last edited

Content