Changes for page b. Chats and Messaging

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

From version 1.2
edited by teamwire001
on 2021/12/06 10:04
Change comment: api 16 documenation
To version 2.7
edited by teamwire001
on 2023/01/17 08:41
Change comment: DOC-144

Summary

Details

Page properties
Content
... ... @@ -14,7 +14,7 @@
14 14  
15 15  == Search ==
16 16  
17 -Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||height="20"]] in the upper right corner of the screen to open a search bar. The search will look up for chat titles, contacts, circles and lists, and message content. To leave the search, tap the arrow at the upper left.
17 +Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||height="20"]] in the upper right corner of the screen to open a search bar. The search will look up for chat titles, contacts, circles and lists, and message content. To leave the search, tap the arrow at the upper left.
18 18  
19 19  
20 20  {{id name="02-createnewchat"/}}
... ... @@ -86,7 +86,7 @@
86 86  
87 87  The range of [[chat content>>doc:||anchor="02-chatcontentsandactions"]] is limited.
88 88  
89 -Currently, the following attachment types are supported: photos, (gallery), videos (gallery), files. Attention messages are not supported at the moment.
89 +Currently, the following attachment types are supported: photos, (gallery), videos (gallery), files, attention messages and locations.
90 90  
91 91  
92 92  {{id name="02-federatedchat-removed"/}}
... ... @@ -102,7 +102,7 @@
102 102  
103 103  Select one or more users from your list of contacts by tapping the checkbox next to the user's name.
104 104  
105 -Already selected contacts are indicated with an [[image:Public.Applications.Android.User-Manual.WebHome@icon-checked.png||height="20"]] and can be deselected by re-tapping.
105 +Already selected contacts are indicated with an [[image:Public.Applications.Android.User-Manual.WebHome@icon-checked.png||height="20"]] and can be deselected by re-tapping.
106 106  
107 107  You can combine contacts, lists, circles and bots as chat members. Above the list of contacts, you will see an overview of all selected recipients and also be able to remove them from there.
108 108  
... ... @@ -109,7 +109,7 @@
109 109  Please note the **maximum of members** that can be added to a chat, which will be shown above the overview (Members X / 500) during the creation. The default maximum for a chat is 500 members, but it may have been adjusted by your Teamwire administrator.
110 110  
111 111  ## ##
112 -[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_CreateChat1.png||height="615" width="280"]]
112 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-create1.png||width="280"]]
113 113  ## ##
114 114  
115 115  Your contacts are split into four types and are listed per section.
... ... @@ -120,7 +120,7 @@
120 120  * [[Bots>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome||anchor="03-bots"]]
121 121  ## ##
122 122  
123 -Although all contacts are arranged in alphabetical order (by their last name), in a large organisation it can become challenging to find the right user quickly. Therefore, make use of the **search bar,** to find your contacts, lists, circles and bots per section. The search feature is located in the upper right corner via [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||height="20"]].
123 +Although all contacts are arranged in alphabetical order (by their last name), in a large organisation it can become challenging to find the right user quickly. Therefore, make use of the **search bar,** to find your contacts, lists, circles and bots per section. The search feature is located in the upper right corner via  [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||height="20"]].
124 124  
125 125  
126 126  {{id name="02-definechattitle"/}}
... ... @@ -130,7 +130,7 @@
130 130  Set a title for your conversation. This title is not final and can be changed at any time via [[Chat Settings>>doc:||anchor="02-chatsettings"]]. **For group chats,** setting a title is mandatory.
131 131  
132 132  ## ##
133 -[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_CreateChat2.png||height="615" width="280"]]
133 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-create2.png||width="280"]]
134 134  ## ##
135 135  
136 136  {{id name="02-definefurthersettings"/}}
... ... @@ -147,6 +147,69 @@
147 147  After defining all further settings, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-confirm.png||height="20"]] to enter the new chat automatically and you will be able to compose your first message.
148 148  
149 149  
150 +{{id name="02-voipcall"/}}
151 +
152 += Voice and video calls =
153 +
154 +You can contact one or multiple users in your existing chats via voice or video call.
155 +
156 +This feature is available for 1:1 chats and group chats.
157 +
158 +There can only be one call in progress per chat. In case other participants are already having a call in the same chat, you will receive a notice.
159 +
160 +(% class="box infomessage" %)
161 +(((
162 +If voice and video calls are not available to you, the feature may have been disabled by your Teamwire administrator.
163 +)))
164 +
165 +{{id name="02-voipcall-start"/}}
166 +
167 +== Start a call ==
168 +
169 +Open an existing chat or [[create a new chat>>doc:||anchor="02-createnewchat"]] with your favoured participants.
170 +
171 +Start the call by tapping the respective button in the upper right corner of the screen.
172 +
173 +Use ## ##[[image:Public.Applications.Android.User-Manual.WebHome@icon-voipvoice11.png||height="20"]]## ## to start a voice call and ## ##[[image:Public.Applications.Android.User-Manual.WebHome@icon-voipvideo11.png||height="20"]]## ## to start a video call. You may enable your camera at any time during the voice call and turn it into a video call. You may disable your camera at any time of the video call, too.
174 +
175 +The other call participants will be notified, even if they are currently not actively using the Teamwire app.
176 +
177 +
178 +**The number of participants for group calls is limited** and given by your Teamwire server admin.
179 +
180 +If your group chat has more participants than the number of members allowed in a group call, the icons will change a bit into ## ##[[image:Public.Applications.Android.User-Manual.WebHome@icon-voipvoicegroup.png||height="20"]]## ## for voice and ## ##[[image:Public.Applications.Android.User-Manual.WebHome@icon-voipvideogroup.png||height="20"]]## ## for video calls. Before the call can begin, you will be shown the list of all chat members from which you have to select one or more users (up to the max. number of call members) for the call.
181 +
182 +## ##
183 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-voip1.png||width="280"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-voip2.png||width="280"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-voip3.png||width="280"]]
184 +## ##
185 +
186 +{{id name="02-voipcall-join"/}}
187 +
188 +== Join a call ==
189 +
190 +If you have missed a call, you can also join it later.
191 +
192 +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.
193 +
194 +## ##
195 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-voip4.png||width="280"]]
196 +## ##
197 +
198 +{{id name="02-voipcall-features"/}}
199 +
200 +== Features during a call ==
201 +
202 +The following primary features are available during the call.
203 +
204 +* Enable / disable microphone
205 +* Enable / disable camera
206 +* Select sound device
207 +* Screen sharing
208 +* Raise hand
209 +* Toggle between front and backside camera
210 +
211 +## ##
212 +
150 150  {{id name="02-emergencyalert"/}}
151 151  
152 152  = Emergency alert (SOS button) =
... ... @@ -160,6 +160,10 @@
160 160  If the SOS button is not available to you, the feature may have been disabled by your Teamwire administrator.
161 161  )))
162 162  
226 +## ##
227 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-emergency.png||width="280"]]
228 +## ##
229 +
163 163  {{id name="02-emergencyalert-configure"/}}
164 164  
165 165  == Set up the SOS button ==
... ... @@ -173,10 +173,6 @@
173 173  
174 174  In your inbox, open the emergency menu by swiping your screen to the right.
175 175  
176 -## ##
177 -[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_SOS_Mode.png||height="615" width="280"]]
178 -## ##
179 -
180 180  The SOS button will locate your current position via GPS (if Teamwire has been granted access to your location) and will request you to record a voice message (if Teamwire has been granted access to your microphone) to send both information to the chat.
181 181  
182 182  To record a voice message
... ... @@ -205,12 +205,12 @@
205 205  
206 206  In you inbox, use the [[image:Public.Applications.Android.User-Manual.WebHome@icon-ptt.png||height="20"]] icon in the upper right corner to open the Push-to-Talk selection menu. Enable the Push-to-Talk ability for all chats required.
207 207  
208 -As soon as you have defined at least one Push-to-Talk chat, you can decide via [[image:Public.Applications.Android.User-Manual.WebHome@icon-pttmute.png||height="20"]] whether new messages received in your active channel will be played via **speaker** or if they are **muted.**
271 +As soon as you have defined at least one Push-to-Talk chat, you can decide via [[image:Public.Applications.Android.User-Manual.WebHome@icon-pttmute.png||height="20"]] whether new messages received in your active channel will be played via **speaker** or if they are **muted.**
209 209  
210 210  Use [[image:Public.Applications.Android.User-Manual.WebHome@icon-pttdeselect.png||height="20"]] to remove your current selection of chats.
211 211  
212 212  ## ##
213 -[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_PTTselection.png||width="280"]]
276 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-ptt1.png||width="280"]]
214 214  ## ##
215 215  
216 216  {{id name="02-pushtotalk-usage"/}}
... ... @@ -222,7 +222,7 @@
222 222  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.
223 223  
224 224  ## ##
225 -[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_PTTinbox.png||height="615" width="280"]]
288 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-ptt2.png||width="280"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-ptt3.png||width="280"]]
226 226  ## ##
227 227  
228 228  {{id name="02-chatcontentsandactions"/}}
... ... @@ -236,6 +236,9 @@
236 236  
237 237  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.
238 238  
302 +## ##
303 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-attachments.png||width="280"]]
304 +## ##
239 239  
240 240  [[image:Public.Applications.Android.User-Manual.WebHome@icon-camera.png||height="20"]] **Take photo**
241 241  
... ... @@ -264,7 +264,8 @@
264 264  Select any further file type via your file manager to share them (e.g. PDF, text file, presentation etc.).
265 265  
266 266  * [[image:Public.Applications.Android.User-Manual.WebHome@icon-location.png||height="20"]] **Location**
267 -If Teamwire has been granted access to your location data and GPS is enabled, you can either select your current position or choose a POI from the map, to send it to the chat.
333 +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.
334 +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"]].
268 268  
269 269  * [[image:Public.Applications.Android.User-Manual.WebHome@icon-calendar.png||height="20"]] **Calendar**
270 270  Grant access to your calendar to select appointments from your calendar app and attach them.
... ... @@ -271,6 +271,9 @@
271 271  
272 272  * [[image:Public.Applications.Android.User-Manual.WebHome@icon-poll.png||height="20"]] **Poll**
273 273  Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
341 +
342 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-dracoon.png||height="20"]] **Dracoon**
343 +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.
274 274  ## ##
275 275  
276 276  (% class="box infomessage" %)
... ... @@ -315,6 +315,163 @@
315 315  You can find a chronological list of all reactions to your attention messages via the icon [[image:Public.Applications.Android.User-Manual.WebHome@icon-bell.png||height="20"]] in the upper right corner of the chat.
316 316  
317 317  
388 +{{id name="02-livelocation"/}}
389 +
390 +== Live location ==
391 +
392 +This feature allows other users to track your current location live on a map.
393 +
394 +To share your live location, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png||height="20"]] next to the text input field, select [[image:Public.Applications.Android.User-Manual.WebHome@icon-location.png||height="20"]] **Location** and **Share your live location.**
395 +
396 +Open the live map and check your current position by tapping on the map preview in the chat.
397 +
398 +## ##
399 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-livelocation1.png||width="280"]]
400 +## ##
401 +
402 +{{id name="02-livelocation-duration"/}}
403 +
404 +=== Sharing duration ===
405 +
406 +As you start the live location feature, you can select for how long you want to share it.
407 +
408 +The remaining minutes / hours of the duration are shown in the chat and map view.
409 +
410 +The app will automatically stop sharing when the duration has been exceeded without further notification.
411 +
412 +
413 +{{id name="02-livelocation-stop"/}}
414 +
415 +=== Stop sharing manually ===
416 +
417 +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.**
418 +
419 +
420 +{{id name="02-livelocation-multiple"/}}
421 +
422 +=== Multiple users sharing ===
423 +
424 +In one chat, multiple users can share their live location at the same time. Their locations will be shown in a single map.
425 +
426 +A list of all chat members currently sharing their location is available in the bottom of the screen (expand).
427 +
428 +
429 +{{id name="02-livelocation-additional"/}}
430 +
431 +=== Additional features ===
432 +
433 +The live map offers different tools and settings to view users and map material.
434 +
435 +* **Focus user**
436 +Tap on one of the users to focus on them. This way, the user will always remain in the center of the map view.
437 +You can also select the user from the list of all chat members currently sharing their location.
438 +
439 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-locationcenter.png||height="18"]] **Center map**
440 +Tap on the symbol to center the view on your current location.
441 +
442 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-locationregroup.png||height="18"]] **Regroup**
443 +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.
444 +
445 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-locationdrawmap.png||height="18"]] **Draw on map**
446 +Tap on the symbol to [[draw an area on the map>>doc:||anchor="02-drawonmap"]].
447 +
448 +* [[image:Public.Applications.Android.User-Manual.WebHome@icon-locationsettings.png||height="20"]] **Map settings**
449 +Tap on the symbol to open the map settings.
450 +## ##
451 +** **Map type**
452 +Select from one of the available map types (Standard, Satellite, Hybrid).
453 +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"]].
454 +
455 +** **Show user names**
456 +If enabled, in addition to the user photos, their names will be displayed on the map, too.
457 +
458 +** **Show user role**
459 +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).
460 +## ##
461 +
462 +{{id name="02-drawonmap"/}}
463 +
464 +== Draw on map ==
465 +
466 +This feature allows you to manually draw areas on the maps of shared locations and label them.
467 +
468 +## ##
469 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-livelocation2.png||width="280"]] ## ## [[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-livelocation3.png||width="280"]]
470 +## ##
471 +
472 +
473 +{{id name="02-drawonmap-draw"/}}
474 +
475 +=== Draw area ===
476 +
477 +Before sharing your location or live location, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-locationdrawmap.png||height="18"]] 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".
478 +
479 +Tap **Redraw area** to draw the area anew.
480 +
481 +Tap **Done** to save the area and share it with other chat participants.
482 +
483 +Tap **X **to end the process and discard the area you've drawn.
484 +
485 +(% class="box infomessage" %)
486 +(((
487 +When sharing a **single location,** you will not be able to edit the drawn area at a later time.
488 +
489 +When sharing you **live location,** you will be able to add or edit an area later.
490 +)))
491 +
492 +
493 +{{id name="02-drawonmap-remove"/}}
494 +
495 +=== Remove area ===
496 +
497 +Tap on your area in the map view to open the dialog box and select **Remove area** to delete it.
498 +
499 +You can only remove those areas which you have drawn yourself.
500 +
501 +(% class="box infomessage" %)
502 +(((
503 +Areas can be removed **when sharing your live location only.**
504 +
505 +When sharing a single location, you will not be able to remove an area later.
506 +)))
507 +
508 +
509 +{{id name="02-drawonmap-label"/}}
510 +
511 +=== Area labels ===
512 +
513 +After drawing an area, a dialog box will open and prompting you to add a label.
514 +
515 +Labels are optional. Leave the text input field empty, if you do not want to add a label.
516 +
517 +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.
518 +
519 +Tap **X** to end the process and discard your changes.
520 +
521 +You can only edit / remove labels for those areas which you have drawn yourself.
522 +
523 +(% class="box infomessage" %)
524 +(((
525 +Labels can be edited / removed **when sharing your live location only.**
526 +
527 +When sharing a single location, you will not be able to edit / remove an area label later.
528 +)))
529 +
530 +
531 +{{id name="02-drawonmap-multiple"/}}
532 +
533 +=== Multiple user areas ===
534 +
535 +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.
536 +
537 +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.
538 +
539 +You cannot edit / remove areas and labels of other chat participants.
540 +
541 +## ##
542 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-livelocation4.png||width="280"]]
543 +## ##
544 +
318 318  {{id name="02-readreceipts"/}}
319 319  
320 320  == Read receipts ==
... ... @@ -376,7 +376,7 @@
376 376  )))
377 377  
378 378  ## ##
379 -[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_Chatsettings1.png||height="615" width="280"]]
606 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-chatset1.png||width="280"]]
380 380  ## ##
381 381  
382 382  {{id name="02-chatavatar"/}}
... ... @@ -482,7 +482,7 @@
482 482  Below the media overview you will find the chat administration.
483 483  
484 484  ## ##
485 -[[image:Public.Applications.Android.User-Manual.WebHome@mobEN_Chatsettings2.png||height="615" width="280"]]
712 +[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-chatset2.png||width="280"]]
486 486  ## ##
487 487  
488 488  {{id name="02-mutechat"/}}
... ... @@ -536,25 +536,6 @@
536 536  If the "Send" option is not available to you, the feature may have been disabled by your Teamwire administrator.
537 537  )))
538 538  
539 -{{id name="02-leavechat"/}}
540 -
541 -== Leave chat ==
542 -
543 -Leave a chat when you no longer want to be part of the conversation or your participation is no longer needed.
544 -
545 -There are two options to leave a chat
546 -
547 -* Open the respective chat and view its chat settings by tapping its avatar and title. The option **Leave** can be found below the media overview.
548 -* In your **inbox,** tap and hold the chat of concern to open the context menu and select **Leave.**
549 -## ##
550 -
551 -(% class="box infomessage" %)
552 -(((
553 -If the "Leave" option is not available to you, the feature may have been disabled by your Teamwire administrator.
554 -
555 -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"]].
556 -)))
557 -
558 558  {{id name="02-closechat"/}}
559 559  
560 560  == Close chat ==
... ... @@ -578,3 +578,27 @@
578 578  )))
579 579  
580 580  ## ##
789 +[[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"]]
790 +## ##
791 +
792 +{{id name="02-leavechat"/}}
793 +
794 +== Leave chat ==
795 +
796 +Leave a chat when you no longer want to be part of the conversation or your participation is no longer needed.
797 +
798 +There are two options to leave a chat
799 +
800 +* Open the respective chat and view its chat settings by tapping its avatar and title. The option **Leave** can be found below the media overview.
801 +* In your **inbox,** tap and hold the chat of concern to open the context menu and select **Leave.**
802 +## ##
803 +
804 +(% class="box infomessage" %)
805 +(((
806 +If the "Leave" option is not available to you, the feature may have been disabled by your Teamwire administrator.
807 +
808 +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"]].
809 +)))
810 +
811 +
812 +## ##