Changes for page b. Chats and Messaging

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

From version 1.1
edited by teamwire001
on 2021/06/10 09:56
Change comment: Imported from XAR
To version 5.1
edited by teamwire001
on 2024/11/08 09:26
Change comment: DOC-345

Summary

Details

Page properties
Content
... ... @@ -1,434 +1,958 @@
1 -Starting Teamwire, the **Chats** tab is shown by default. It shows all chats you have created or are involved in.
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 2  
3 -As you receive new messages, you will find a badge counter on the Chats tab indicating the amount of unread texts.
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 4  
5 5  
6 -{{id name="02-inbox"/}}
6 +{{id name="02-filter"/}}
7 7  
8 8  = Inbox =
9 9  
10 -When receiving new messages, the chat concerned is also provided with a badge on the amount of unread texts. This badge will disappear after you have opened/read the chat. In the chat itself, new messages are visually indicated from already read content by a separator.
10 +Your inbox provides four tabs which allow you to switch between the most important chat type criteria.
11 11  
12 +* **All**
13 +The default tab which will show you read and unread, favourite and non-favourite, 1:1 and group chats or broadcasts alike. Archived chats are not shown.
12 12  
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 +
13 13  {{id name="02-search"/}}
14 14  
15 -== Search ==
31 += Search =
16 16  
17 -Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||queryString="height=20" height="20"]] in the right upper corner of the screen to open a search bar. The search will look up for chat titles, contacts, groups, and message content.
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.
18 18  
19 19  
20 20  {{id name="02-createnewchat"/}}
21 21  
22 -= Create new chat =
38 += Create a chat =
23 23  
24 -To create a new chat, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-newchat.png||queryString="height=20" height="20"]] in the bottom right corner of the screen. The creation process has two steps:
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.
25 25  
26 -* [[Select participants>>doc:||anchor="02-selectparticipants"]]
27 -* Define a [[chat title>>doc:||anchor="02-definechattitle"]] and [[further settings>>doc:||anchor="02-definefurthersettings"]]
28 28  
29 -You will enter the newly created chat automatically to send your message.
43 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-user.svg||height="20"]] [[1:1 Chat>>doc:||anchor="02-onetoonechat"]]
30 30  
45 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-group.svg||height="22"]] [[Group Chat>>doc:||anchor="02-groupchat"]]
31 31  
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 +(% class="box warningmessage" %)
61 +(((
62 +1:1 chats cannot be subsequently extended with additional users to form a group chat.
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 +
32 32  {{id name="02-selectparticipants"/}}
33 33  
34 34  == Select participants ==
35 35  
36 -Select at least one user from your list of contacts and tap **Next.**
123 +Select one or more users from your list of contacts by tapping the checkbox next to the user's name.
37 37  
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.
38 38  
39 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_create1.png||queryString="width=300" width="300"]]
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.
40 40  
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.
41 41  
42 -Teamwire classifies your contacts into three types:
43 43  
44 -* **Contacts**
45 -Single user accounts (usually employees and colleagues) your administrator has allowed to communicate with. If Teamwire has been granted access to your address book, you may also find some of these contacts in Teamwire - even though they do not belong to your company directly. For more information, see [[My Contacts>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-mycontacts"]].
132 +Your contacts are split into four types and are listed per section.
46 46  
47 -* **Groups**
48 -Predefined groups of people (similar to a mailing list) your administrator has allowed to communicate with, or you have created yourself. For more information, see [[Groups>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-groups"]].
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"]]
49 49  
50 -* **Directory**
51 -You can manually search the Directory (former //Enterprise Directory//) for individual internal and external users that have not yet been synchronised. For more information, see [[Directory>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-directory"]].
136 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-userlist.svg]] [[Lists>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-lists"]]
52 52  
53 -The participants (so-called //members//) of your chat can be both individual contacts as well as groups. Please notice the **maximum of members** that can be added to a chat. The number of currently selected users will be shown during the creation (X / 1250 users).
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"]]
54 54  
55 -Your list of contacts is arranged in alphabetical order (by the last name) but it still might feel challenging finding your colleagues within an excessive number of users. **To find colleagues and groups more quickly, make use of the search bar** located atop the list of contacts. It will show all user accounts matching your input.
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 +## ##
56 56  
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.
57 57  
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 +
58 58  {{id name="02-definechattitle"/}}
59 59  
60 -== Define chat title ==
151 +== Define title ==
61 61  
62 -Define a matching title for your conversation. This title is not final and can be changed at any time via the [[Chat Settings>>doc:||anchor="02-chatsettings"]].
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.
63 63  
64 64  
65 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_create2.png||queryString="width=300" width="300"]]
156 +{{id name="02-definefurthersettings"/}}
66 66  
158 +== Define further settings ==
67 67  
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 +
68 68  (% class="box infomessage" %)
69 69  (((
70 -**For group chats,** setting a title is **mandatory.**
182 +If voice and video calls are not available to you, the feature may have been disabled by your Teamwire administrator.
183 +)))
71 71  
72 -The title is optional for 1:1 chats. If no title has been defined, Teamwire will show the name of the user you are talking to.
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 +(% class="box infomessage" %)
241 +(((
242 +If the emergency alert is not available to you, the feature may have been disabled by your Teamwire administrator.
73 73  )))
74 74  
75 75  ## ##
76 -{{id name="02-definefurthersettings"/}}
246 +[[image:Public.Applications.Android.User-Manual.WebHome@emergency-1.png||width="280px"]]
247 +## ##
77 77  
78 -== Define further settings ==
249 +{{id name="02-emergencyalert-usage"/}}
79 79  
80 -* **Chat avatar**
81 -In order to recognise chats more easily, you can set a picture for chat avatar.
251 +== Usage ==
252 +
253 +(% class="box infomessage" %)
254 +(((
255 +This feature requires permission to use your location and microphone in order to work correctly.
256 +)))
257 +
258 +Tap the  [[image:Public.Applications.Android.User-Manual.WebHome@icons-emergency.svg]] **Emergency **icon at the top of your inbox to open the screen.
259 +
260 +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.
261 +
262 +You have two options for recording your voice message, which will be sent together with an alert and your current location.
263 +
264 +* 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.
265 +** After 30 seconds, the alert will be sent automatically, including your voice message and your location.
266 +** Cancel your recording during the countdown by tapping the record button again **(X)**.
267 +
268 +* 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.
269 +** Release the button to send the alert, including your voice message and your location.
270 +** Swipe up to cancel the recording and the process.
271 +## ##
272 +
273 +{{id name="02-emergencyalert-configure"/}}
274 +
275 +== Default circle ==
276 +
277 +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.
278 +
279 +Despite configuring a Default circle, you can still edit the **Send to** section, if you'd like to, before starting to record your message.
280 +
281 +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.
282 +
283 +
284 +{{id name="02-pushtotalk"/}}
285 +
286 += Push-to-Talk =
287 +
288 +This feature turns your Teamwire app into a walkie-talkie by sending voice messages directly to your Push-to-Talk chats and listening to the voice messages you receive.
289 +
290 +(% class="box infomessage" %)
291 +(((
292 +If Push-to-Talk is not available to you, the feature may have been disabled by your Teamwire administrator.
293 +)))
294 +
295 +{{id name="02-pushtotalk-configure"/}}
296 +
297 +== Setup ==
298 +
299 +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.
300 +
301 +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.**
302 +
303 +Use [[image:Public.Applications.Android.User-Manual.WebHome@icons-dnd.svg]] to remove your current selection of chats.
304 +
305 +## ##
306 +[[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"]]
307 +## ##
308 +
309 +{{id name="02-pushtotalk-usage"/}}
310 +
311 +== Usage ==
312 +
313 +Your Push-to-Talk chats are displayed at the bottom of the inbox. Simply swipe to switch between your Push-to-Talk chats.
314 +
315 +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.
316 +
317 +
318 +{{id name="02-attachments"/}} {{id name="02-chatcontentsandactions"/}}
319 +
320 += Attachments =
321 +
322 +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.
323 +
324 +
325 +[[image:Public.Applications.Android.User-Manual.WebHome@icons-camera.svg]] **Take photo**
326 +Grant access to your camera to take and send photos or videos. Video recording is limited to 180 seconds.
327 +
328 +
329 +[[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-image.svg]] **Photos and images from gallery**
330 +Grant access to your gallery to send photos and videos stored on your device.
331 +
332 +
333 +[[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-voice.svg]] **Record voice message**
334 +Grant access to your microphone to record and send a voice message. Voice recording is limited to 180 seconds.
335 +
336 +
337 +[[image:Public.Applications.Android.User-Manual.WebHome@icons-attach.svg]] **Further attachments and features**
338 +You will be listed further options for sharing content.
339 +
340 +
341 +* [[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**
342 +These are so-called attention messages. More information about attention messages are available [[here>>doc:||anchor="02-attentionmessages"]].
82 82  
83 -* **Allow to send messages**
84 -You can prohibit other chat members from sending messages to the conversation. This is the so-called **broadcast mode** which allows composing and sending messages only to [[chat administrators>>doc:||anchor="02-chatadministrators"]]. For more information, see [[chat mode>>doc:||anchor="02-chatmode"]].
344 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-file.svg]] **File**
345 +Select any further file type via your file manager to share them (e.g. PDF, text file, presentation etc.).
85 85  
86 -* **Allow to mute notifications**
87 -Decide whether chat members are allowed to mute this conversation.
347 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-location.svg]] **Location**
348 +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.
349 +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"]].
88 88  
89 -* **Alert Chat**
90 -This feature is meant for emergencies. An alert chat will always stay on top of its members messages inbox until the content has been read. For more information, see [[alert message>>doc:||anchor="02-alertmessages"]].
351 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-calendar.svg]] **Calendar**
352 +Grant access to your calendar to select appointments from your calendar app and attach them.
353 +
354 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-attach-poll.svg]] **Poll**
355 +Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
356 +
357 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-dracoon.svg]] **Dracoon**
358 +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.
359 +## ##
91 91  
92 -After defining all further settings, tap **Create** and you will enter the newly created chat automatically to compose and send your message.
361 +(% class="box infomessage" %)
362 +(((
363 +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.
364 +)))
93 93  
366 +## ##
367 +[[image:Public.Applications.Android.User-Manual.WebHome@chatview-3.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@chatview-4.png||width="280px"]]
368 +## ##
94 94  
95 -{{id name="02-emergencyalert"/}}
370 +{{id name="02-mentions"/}}
96 96  
97 -= Emergency Alert (SOS Button) =
372 += Mentions =
98 98  
99 -With the Emergency Button you can quickly create a new alert chat with **a predefined group of people.** When creating an alert, your location data (via GPS) will be requested and a voice message will be recorded - both being shared with the chat members.
374 +Mention other chat members by typing an **@-symbol**.
100 100  
101 -An alert chat will always stay on top of its members messages inbox until the content has been read. For more information, see [[alert message>>doc:||anchor="02-alertmessages"]].
376 +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.
102 102  
378 +## ##
379 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__mobile-mentions_001.png||width="280"]]
380 +## ##
103 103  
104 -**Creating a chat with the Emergency Button**
382 +When mentioned, you will receive a push notification and the respective chat will dispaly the mention with an **@-symbol** in your inbox.
105 105  
106 -When looking at your inbox, you can open the emergency menu by swiping your screen to the right.
384 +## ##
385 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__mobile-mentions_002.png||width="280"]]
386 +## ##
107 107  
388 +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).
108 108  
109 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_sosbutton.png||queryString="width=300" width="300"]]
390 +## ##
391 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__mobile-mentions_003.png||width="280"]]
392 +## ##
110 110  
394 +{{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
111 111  
112 -Teamwire will locate your current position via GPS (if Teamwire has been granted access to your location) and will request you to record a voice message (if Teamwire has been granted access to your microphone) to send both information to the chat.
396 += Attention messages =
113 113  
114 -To record a voice message
398 +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.
115 115  
116 -* tap the button once to start a 30 seconds record timer or
117 -* tap and hold the button as long as you want to record your message.
400 +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.
401 +## ##
118 118  
119 -Afterwards, your location and voice message will be sent to a predefined group of people.
403 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-am-alert.svg]] **Alert**
404 +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"]].
405 +(% class="mark" %)Do not mix things up! An alert message is a single message labelled as alert. If you want to create an alert chat quickly, see [[Emergency alert>>doc:||anchor="02-emergencyalert"]].
120 120  
121 -You can configure the group for the Emergency Button via [[Profile > Message Settings > SOS Group>>doc:Public.Applications.Android.User-Manual.Settings.WebHome||anchor="05-sosgroup"]]. If you have not configured an SOS Group, you will have to select a group manually each time the SOS Button feature is being used. If your phone is being managed by a Mobile Device Management system, your Teamwire administrator might has already defined an SOS group for you which you cannot change.
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.
122 122  
123 -(% class="box" %)
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 +(% class="box infomessage" %)
124 124  (((
125 -The Emergency Button feature has to be enabled by your Teamwire administrator. If it is not available to you, it may has been disabled.
418 +If attention messages are not available to you, the feature may have been disabled by your Teamwire administrator.
126 126  )))
127 127  
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 +
128 128  ## ##
129 -{{id name="02-chatcontentsandactions"/}}
441 +[[image:Public.Applications.Android.User-Manual.WebHome@livelocation-1.png||width="280px"]]
442 +## ##
130 130  
131 -= Chat contents and actions =
444 +{{id name="02-livelocation-duration"/}}
132 132  
446 +== Sharing duration ==
133 133  
134 -{{id name="02-attachments"/}}
448 +As you start the live location feature, you can select for how long you want to share it.
135 135  
136 -== Attachments ==
450 +The remaining minutes / hours of the duration are shown in the chat and map view.
137 137  
138 -In addition to texts and emojis, you can send various attachments via Teamwire.
452 +The app will automatically stop sharing when the duration has been exceeded without further notification.
139 139  
140 -If you want to attach a photo, appointment, or the like to your current conversation, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attach.png||queryString="height=20" height="20"]] next to your text input field and select the type of file you want to share with the chat.
141 141  
142 -* **Gallery**
143 -Grant access to your gallery to send stored photos and videos.
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.
144 144  
145 -* **Camera**
146 -Grant access to your camera to create and send photos or videos. Video recording is limited to 180 seconds.
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.
147 147  
148 -* **Voice Message**
149 -Grant access to your microphone to record and send a voice message. The voice message is limited to 180 seconds.
150 -You can also create a voice message by tapping the quick record button [[image:Public.Applications.Android.User-Manual.WebHome@icon-voicerecord.png||queryString="height=20" height="20"]] next to your text input.
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.
151 151  
152 -* **Location**
153 -If Teamwire has been granted access to your location data and your mobile GPS is active, you will be able to select either your current position or choose a POI from the map, to send it to the chat.
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"]].
154 154  
155 -* **Calendar**
156 -Grant access to your calendar to select appointments from your calendar app and attach them.
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"]].
157 157  
158 -* **File**
159 -Select any further file type via your file manager and attach them (e.g. PDF, text file, presentation, etc.).
495 +** **Show user names**
496 +If enabled, in addition to the user photos, their names will be displayed on the map, too.
160 160  
161 -* **Poll**
162 -Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
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 +## ##
163 163  
164 -(% class="box" %)
165 -(((
166 -Your Teamwire administrator is able to prohibit sending certain (or all) attachment types. If they are not available to you, they may have been disabled.
167 -)))
505 +{{id name="02-drawonmap"/}}
168 168  
507 += Draw on map =
508 +
509 +This feature allows you to manually draw areas on the maps of shared locations and label them.
510 +
169 169  ## ##
170 -{{id name="02-alertmessages"/}}
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 +## ##
171 171  
172 -== Alert messages ==
515 +{{id name="02-drawonmap-draw"/}}
173 173  
174 -The text input field allows labeling your message as alert by tapping [[image:Public.Applications.Android.User-Manual.WebHome@icon-alarmoff.png||queryString="height=20" height="20"]] If the alert label is activated, the icon and your text input field will turn red: [[image:Public.Applications.Android.User-Manual.WebHome@icon-alarmon.png||queryString="height=20" height="20"]]
517 +== Draw area ==
175 175  
176 -Alerts cause a special ringtone and will create a different icon on the Android 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.
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".
177 177  
521 +Tap **Redraw area** to draw the area anew.
178 178  
179 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_sosinbox.png||queryString="width=300" width="300"]]
523 +Tap **Done** to save the area and share it with other chat participants.
180 180  
525 +Tap **X **to end the process and discard the area you've drawn.
181 181  
182 -To remove the alert label, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-alarmon.png||queryString="height=20" height="20"]] again.
527 +(% class="box infomessage" %)
528 +(((
529 +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.
183 183  
184 -The alert notification sound can be configured via [[Profile > Message Settings > Alert notification sound>>doc:Public.Applications.Android.User-Manual.Settings.WebHome||anchor="05-notificationsounds"]].
531 +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.
532 +)))
185 185  
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 +
186 186  (% class="box infomessage" %)
187 187  (((
188 -Do not mix things up: An alert message is **a single message labeled as alert.**
544 +Areas can be removed **when sharing your live location only.**
189 189  
190 -If you want to create an alert chat quickly, see [[Emergency Button>>doc:||anchor="02-emergencyalert"]].
546 +When sharing a single location, you will not be able to remove an area later.
191 191  )))
192 192  
193 -(% class="box" %)
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 +(% class="box infomessage" %)
194 194  (((
195 -The feature of sending alert messages has to be enabled by your Teamwire administrator. If it is not available to you, it may has been disabled.
565 +Labels can be edited / removed **when sharing your live location only.**
566 +
567 +When sharing a single location, you will not be able to edit / remove an area label later.
196 196  )))
197 197  
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 +
198 198  ## ##
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 +
199 199  {{id name="02-replytomessage"/}}
200 200  
201 -== Reply to message ==
593 +== Reply ==
202 202  
203 -Tap and hold the message or attachment concerned to open the context menu. Select **Reply** to quote the respective message when sending your answer. This is especially useful in conversations with a lot of users to not lose context.
595 +Tap and hold the respective message or attachment to open the actions menu.
204 204  
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.
205 205  
599 +
206 206  {{id name="02-copymessage"/}}
207 207  
208 -== Copy message ==
602 +== Copy ==
209 209  
210 -Tap and hold the message concerned to open the context menu. Select **Copy** to copy the entire message content to your clipboard. You can paste the text into another chat or an external app.
604 +Tap and hold the respective message to open the actions menu.
211 211  
212 -(% class="box" %)
606 +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.
607 +
608 +(% class="box infomessage" %)
213 213  (((
214 -The feature of copying message content has to be enabled by your Teamwire administrator. If the feature is not available to you, it may has been disabled.
610 +If you cannot copy a message, the feature may have been disabled by your Teamwire administrator.
215 215  )))
216 216  
217 -## ##
218 218  {{id name="02-forwardmessage"/}}
219 219  
220 -== Forward message ==
615 +== Forward ==
221 221  
222 -Tap and hold the message or attachment concerned to open the context menu and select **Forward.** A list of all existing chats to which you can forward the content to will be displayed. If you want to use a new chat to forward the content to, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-newchat.png||queryString="height=20" height="20"]] in the bottom right corner of the screen and continue selecting your participants.
617 +Tap and hold the respective message or attachment to open the actions menu.
223 223  
619 +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.
224 224  
621 +
225 225  {{id name="02-deletemessage"/}}
226 226  
227 -== Delete message ==
624 +== Delete ==
228 228  
229 -Tap and hold the message or attachment concerned to open the context menu and select **Delete** to remove the content.
626 +You can delete your own messages and attachments in Teamwire, even if they have already been read by others.
230 230  
231 -Please note, the content will be removed for your eyes only and only for the device at hand. Other members of this conversation will still be able to see the removed message/attachment; it will also remain visible to your other device(s) (e.g. your desktop app).
628 +Tap and hold the respective message or attachment to open the actions menu.
232 232  
630 +Select [[image:Public.Applications.Android.User-Manual.WebHome@icons-delete.svg]] **Delete** to remove it permanently.
233 233  
234 -{{id name="02-readreceipts"/}}
632 +(% class="box infomessage" %)
633 +(((
634 +If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
635 +)))
235 235  
236 -== Read receipts ==
237 237  
238 -The present [[image:Public.Applications.Android.User-Manual.WebHome@icon-readeye.png||queryString="width=20&height=12" height="12" width="20"]] read receipts of the chat members are represented by their avatars. They can be found at the bottom of the conversation.
239 -Please note, that these read receipts **only apply to the last message** of the chat and cannot be viewed for previous messages.
638 +{{id name="02-chatadministration"/}}
240 240  
241 -If you are looking for a detailed view of the present read receipts, you can tap at the line of user avatars to receive a complete list.
640 += Chat actions =
242 242  
243 -(% class="box" %)
244 -(((
245 -Your Teamwire administrator may disable the feature of the read receipts for all users.
246 -)))
642 +These are actions that can be performed on your existing chats.
247 247  
644 +
645 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-unread.svg]] [[Mark chat as read / unread>>doc:||anchor="chaction-unread"]]
646 +
647 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-pin.svg]] [[Pin chat>>doc:||anchor="chaction-pin"]]
648 +
649 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-favourite.svg]] [[Favourite chat>>doc:||anchor="chaction-favourite"]]
650 +
651 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-mute.svg]] [[Mute chat>>doc:||anchor="02-mutechat"]]
652 +
653 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-archive.svg]] [[Archive chat>>doc:||anchor="02-archivechat"]]
654 +
655 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-leave.svg]] [[Leave chat>>doc:||anchor="02-leavechat"]]
656 +
657 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-lock.svg]] [[Close chat>>doc:||anchor="02-closechat"]]
658 +
659 +* [[image:Public.Applications.Android.User-Manual.WebHome@icons-email.svg]] [[Email chat history>>doc:||anchor="02-emailchathistory"]]
248 248  ## ##
249 -{{id name="02-chatsettings"/}}
250 250  
251 -= Chat Settings =
662 +{{id name="chaction-unread"/}}
252 252  
253 -Tap the chat avatar in the right upper corner of the screen to open the Chat Settings. Among other things, here you are able to change the chat title or add more users to the conversation.
664 +== Mark as read / unread ==
254 254  
255 -(% class="box infomessage" %)
256 -(((
257 -Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to the Chat Settings.
258 -)))
666 +**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"]].
259 259  
668 +You have multiple options to perform the [[image:Public.Applications.Android.User-Manual.WebHome@icons-read.svg]] **Mark as read** action on a chat.
260 260  
261 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_chatoptions.png||queryString="width=300" width="300"]]
670 +* In your inbox, swipe right on the chat you want to mark as read and select the action.
671 +* In your inbox, tap and hold down on the chat you want to mark as read to open the actions menu.
672 +## ##
262 262  
674 +**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.
263 263  
264 -{{id name="02-chatavatar"/}}
676 +You have multiple options to perform the [[image:Public.Applications.Android.User-Manual.WebHome@icons-unread.svg]] **Mark as unread** action on a chat.
265 265  
266 -== Chat avatar ==
678 +* In your inbox, swipe right on the chat you want to mark as unread and select the action.
679 +* In your inbox, tap and hold down on the chat you want to mark as unread to open the actions menu.
680 +## ##
267 267  
268 -Tap on the current chat avatar. You can choose an existing image from **Gallery** or take a photo by tapping **Camera.** The new avatar will be shown to all members of the conversation.
682 +## ##
683 +[[image:Public.Applications.Android.User-Manual.WebHome@inbox-2.png||width="280px"]]
684 +## ##
269 269  
270 -You can tap the current avatar again to **Change** or **Delete** it.
686 +{{id name="chaction-pin"/}}
271 271  
688 +== Pin ==
272 272  
273 -{{id name="02-chattitle"/}}
690 +This is a personal setting and will only affect your own chats and inbox.
274 274  
275 -== Chat title ==
276 276  
277 -Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
693 +Pinned chats stay on top of your inbox, even if other chats have newer messages.
278 278  
279 -If you want to reset a chat title, remove the current text input and confirm via Enter. The title will adopt the automatically generated name. For group chats, defining your own title is mandatory.
695 +You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-pin.svg]] **Pin** a chat.
280 280  
697 +* In your inbox, swipe right on the chat you want to pin and select the action.
698 +* In your inbox, tap and hold down on the chat you want to pin to open the actions menu.
699 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
700 +## ##
281 281  
282 -{{id name="02-chatmode"/}}
702 +In the same way, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-unpin.svg]] **Unpin** a chat again.
283 283  
284 -== Chat mode ==
704 +(% class="box infomessage" %)
705 +(((
706 +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.
707 +)))
285 285  
286 -Teamwire supports two chat modes. Change the current mode by enabling or disabling the **Allow to send messages** feature.
709 +{{id name="chaction-favourite"/}}
287 287  
288 -* **Normal**
289 -//Allow to send messages// enabled
290 -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.
291 -
292 -* **Broadcast**
293 -//Allow to send messages// disabled
294 -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 a company.
711 +== Favourite ==
295 295  
713 +This is a personal setting and will only affect your own chats and inbox.
714 +
715 +
716 +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.
717 +
718 +You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-favourite.svg]] **Favourite** a chat.
719 +
720 +* In your inbox, swipe right on the chat you want to favourite and select the action.
721 +* In your inbox, tap and hold down on the chat you want to favourite to open the actions menu.
722 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
296 296  ## ##
297 -{{id name="02-chatadministrators"/}}
298 298  
299 -== Chat administrators ==
725 +In the same way, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-unfavourite.svg]] **Unfavourite** a chat again.
300 300  
301 -This section lists all administrators of the current chat.
302 302  
303 -Chat administrators are able to make changes in the Chat Settings, e.g. editing the chat title and chat mode, allowing to mute the chat, or promote other members to become chat administrator.
728 +{{id name="02-mutechat"/}}
304 304  
305 -In a 1:1 chat, both chat members are being administrator by default.
730 +== Mute ==
306 306  
307 -**In a group chat, the creator of the chat is automatically promoted for being administrator** - whether by selecting individual users, by adding groups ([[Organisation Groups>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-organisationgroups"]] or [[User Groups>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-usergroups"]]), or by creating the chat with a mix of both.
732 +This is a personal setting and will only affect your own chats and inbox.
308 308  
309 309  
310 -{{id name="02-promotetoadmin"/}}
735 +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.
311 311  
312 -=== Promote to admin ===
737 +You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-mute.svg]] **Mute** a chat.
313 313  
314 -In the Chat Settings, tap [[Members>>doc:||anchor="02-members"]] to see a complete list of the current chat's participants. If the chat was created with a group, you can tap the name of the group to view its list of members. Tap the user concerned and select **Make chat admin.**
739 +* In your inbox, swipe left on the chat you want to mute and select the action.
740 +* In your inbox, tap and hold down on the chat you want to mute to open the actions menu.
741 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
742 +## ##
315 315  
744 +In the same way, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-notification.svg]] **Unmute** a chat to receive its notifications again.
745 +
316 316  (% class="box infomessage" %)
317 317  (((
318 -The promotion for being chat administrator cannot be revoked.
748 +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"]].
319 319  )))
320 320  
321 321  ## ##
322 -{{id name="02-demoteadmin"/}}
752 +[[image:Public.Applications.Android.User-Manual.WebHome@inbox-3.png||width="280px"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@inbox-4.png||width="280px"]]
753 +## ##
323 323  
324 -=== Demote admin ===
755 +{{id name="02-archivechat"/}}
325 325  
326 -The promotion for being chat administrator cannot be revoked.
757 +== Archive ==
327 327  
328 -You may use the following workaround: Remove the user from the current chat and add them again afterwards. Thus the user is being removed from both the list of members and administrators, and will become a chat member only if you add them to the conversation again.
759 +This is a personal setting and will only affect your own chats and inbox.
329 329  
330 330  
331 -{{id name="02-members"/}}
762 +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.
332 332  
333 -== Members ==
764 +You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-archive.svg]] **Archive** a chat.
334 334  
335 -This section lists all members of the current chat.
766 +* In your inbox, swipe left on the chat you want to archive and select the action.
767 +* In your inbox, tap and hold down on the chat you want to archive to open the actions menu.
768 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
769 +## ##
336 336  
337 -If the chat was created with a group (or if one has been added later), you can tap the name of the group to view its list of members.
771 +In the same way, you can [[image:Public.Applications.Android.User-Manual.WebHome@icons-unarchive.svg]] **Unarchive** a chat from the Archived tab.
338 338  
339 339  
340 -{{id name="02-addmoremembers"/}}
774 +{{id name="02-leavechat"/}}
341 341  
342 -=== Add more members ===
776 +== Leave ==
343 343  
344 -In order to add further members to the chat, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attach.png||queryString="height=20" height="20"]] in the right upper corner of the screen to see your list of contacts.
778 +You may leave a chat if you no longer want to be part of the conversation, or your participation is no longer required.
345 345  
346 -Select users and groups whom you would like to add and confirm your selection by tapping **Done.**
780 +You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-leave.svg]] **Leave** a chat.
347 347  
782 +* In your inbox, swipe left on the chat you want to leave and select the action.
783 +* In your inbox, tap and hold down on the chat you want to leave to open the actions menu.
784 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
785 +## ##
348 348  
349 -{{id name="02-removemembers"/}}
787 +To rejoin a chat, one of the [[chat admins>>doc:||anchor="02-chatadministrators"]] can add you again.
350 350  
351 -=== Remove members ===
789 +(% class="box infomessage" %)
790 +(((
791 +If you cannot leave a chat, the feature may have been disabled by your Teamwire administrator.
352 352  
353 -Tap on a user in the list of members and select **Remove from chat** to have them removed. Users that have been added via a group cannot be removed individually. A group will always need to be removed as a whole.
793 +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"]].
794 +)))
354 354  
355 -**Quick editing**
356 -When viewing the list of chat members, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attach.png||queryString="height=20" height="20"]] in the right upper corner of the screen to remove multiple contacts from the chat. Confirm your changes by tapping **Done.**
796 +{{id name="02-closechat"/}}
357 357  
798 +== Close ==
358 358  
359 -{{id name="02-mediaoverview"/}}
800 +This is an administrative setting and will affect all members of the chat.
360 360  
361 -= Media Overview =
362 362  
363 -Below the Chat Settings you will find the **Media Overview,** which allows you to look up for all attachments and alarms that have been sent in the current chat. The media is filtered by its file type, but can also be viewed unfiltered via //All attachments.//
803 +Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] can close a chat.
804 +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.
364 364  
806 +You have multiple options to [[image:Public.Applications.Android.User-Manual.WebHome@icons-lock.svg]] **Close** a chat.
365 365  
366 -{{id name="02-chatadministration"/}}
808 +* In your inbox, swipe left on the chat you want to close and select the action.
809 +* In your inbox, tap and hold down on the chat you want to close to open the actions menu.
810 +* Open the chat and go to its [[Chat settings>>doc:||anchor="02-chatsettings"]] to select the action.
811 +## ##
367 367  
368 -= Chat administration =
813 +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.
369 369  
370 -Below the Media Overview you will find options to manage the current conversation, like muting, archiving and exiting the chat, or sending the chat history via email.
815 +(% class="box infomessage" %)
816 +(((
817 +If you cannot close a chat, the feature may have been disabled by your Teamwire administrator.
818 +)))
371 371  
820 +## ##
821 +[[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"]]
822 +## ##
372 372  
373 -[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_chatoptions_archive.png||queryString="width=300" width="300"]]
824 +{{id name="02-emailchathistory"/}}
374 374  
826 +== Email chat history ==
375 375  
376 -{{id name="02-mutechat"/}}
828 +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.
377 377  
378 -== Mute chat ==
830 +Please note that attachments cannot be transferred to the mail.
379 379  
380 -Mute a chat to stop receiving notifications. When muted, the notification sound, vibration and push notifications will not be triggered **for this chat.** The app icon on your home screen will keep showing the amount of unread messages.
832 +(% class="box infomessage" %)
833 +(((
834 +If this option is not available to you, the feature may have been disabled by your Teamwire administrator.
835 +)))
381 381  
382 -There are two options to mute a chat
383 383  
384 -* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Mute** action is located below the Media Overview.
385 -* In your inbox, tap and hold the chat concerned to open the context menu and select **Mute.**
838 +{{id name="02-chatsettings"/}}
386 386  
387 -You can re-enable notifications for a chat in the same way.
840 += Chat settings =
388 388  
389 -(% class="box" %)
842 +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.
843 +
844 +(% class="box infomessage" %)
390 390  (((
391 -Chat administrators are able to prohibit muting a chat. If the feature is not available to you, it may has been disabled.
846 +Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
392 392  )))
393 393  
394 394  ## ##
395 -{{id name="02-archivechat"/}}
850 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-chatset1.png||width="280"]]
851 +## ##
396 396  
397 -== Archive chat ==
853 +{{id name="02-chatavatar"/}}
398 398  
399 -Archive a chat when the conversation is no longer active or when a topic-based discussion is completed. Archived chats are not displayed in your message inbox by default.
855 +== Avatar ==
400 400  
401 -There are two options to archive a chat
857 +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.
402 402  
403 -* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Archive** action is located below the Media Overview.
404 -* In your inbox, tap and hold the chat concerned to open the context menu and select **Archive.**
859 +Tap the avatar again to **change** or **remove** the image.
405 405  
406 -To display archived chats in your inbox, activate the option **Show archived chats** via the menu in the right upper corner of the screen. While viewing your archived chats, you can **unarchive** a conversation again in the same way as mentioned above.
407 407  
862 +{{id name="02-chattitle"/}}
408 408  
409 -{{id name="02-emailchathistory"/}}
864 +== Title ==
410 410  
411 -== Email chat history ==
866 +Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
412 412  
413 -Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. Tap **Email Chat History** to forward the conversation in plain text to your default mail app and send it. The action is located below the Media Overview.
868 +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.
414 414  
415 -Please note that attachments cannot be transferred to the mail.
416 416  
871 +{{id name="02-chatmode"/}}
417 417  
418 -{{id name="02-leavechat"/}}
873 +== Mode ==
419 419  
420 -== Leave chat ==
875 +Teamwire supports two chat modes. Change the current mode by enabling or disabling the **Allow to send messages** feature.
421 421  
422 -Leave a chat when you no longer want to be part of the conversation or your participation is no longer needed.
877 +* **Normal**
878 +//Allow to send messages// enabled
879 +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.
423 423  
424 -There are two options to leave a chat
881 +* **Broadcast**
882 +//Allow to send messages// disabled
883 +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.
884 +## ##
425 425  
426 -* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Leave chat** action is located below the Media Overview.
427 -* In your inbox, tap and hold the chat concerned to open the context menu and select **Leave.**
886 +{{id name="02-chatadministrators"/}}
428 428  
429 -(% class="box" %)
888 +== Administrators ==
889 +
890 +This section lists all [[image:Public.Applications.Android.User-Manual.WebHome@icons-admin.svg]] administrators of the current chat.
891 +
892 +Chat administrators are able to make changes in the chat settings, e.g. editing the chat title and chat mode, allowing users to mute the chat, or promote other members to become chat administrator.
893 +
894 +In a 1:1 chat, both members become chat administrator by default.
895 +
896 +**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.
897 +
898 +
899 +{{id name="02-promotetoadmin"/}}
900 +
901 +=== Promote to chat admin ===
902 +
903 +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.**
904 +
905 +
906 +{{id name="02-demoteadmin"/}}
907 +
908 +=== Demote chat admin ===
909 +
910 +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.
911 +
912 +Chat admins can only remove the privileges of another chat admin, but not their own.
913 +
914 +
915 +{{id name="02-members"/}}
916 +
917 +== Members ==
918 +
919 +This section lists all [[image:Public.Applications.Android.User-Manual.WebHome@icons-group.svg]] members of the current chat incl. chat administrators.
920 +
921 +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.**
922 +
923 +
924 +{{id name="02-addmoremembers"/}}
925 +
926 +=== Add members ===
927 +
928 +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.**
929 +
930 +
931 +{{id name="02-removemembers"/}}
932 +
933 +=== Remove members ===
934 +
935 +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.
936 +
937 +
938 +{{id name="02-readreceipts"/}}
939 +
940 += Read receipts =
941 +
942 +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.
943 +
944 +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.
945 +
946 +(% class="box infomessage" %)
430 430  (((
431 -Please note that you cannot leave chats in which you have been added as part of a [[Organisation Group>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-organisationgroups"]]. If you were added as a member of a [[User Group>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-usergroups"]], you will have to confirm your withdrawal of the group first. You will then automatically leave the chat.
948 +Your Teamwire administrator may disable read receipts for all users.
432 432  )))
433 433  
951 +
952 +{{id name="02-mediaoverview"/}}
953 +
954 += Media overview =
955 +
956 +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.
957 +
434 434  ## ##