Wiki source code of b. Chats and Messaging

Version 2.7 by teamwire001 on 2023/01/17 08:41

version	line-number	content
1.2	1	Starting Teamwire, the Chats tab is shown by default. It shows all chats you are involved in.
1.1	2
1.2	3	As you receive new messages, you will find a badge counter on the Chats tab indicating the number of unread texts.
1.1	4
	5
	6	{{id name="02-inbox"/}}
	7
	8	= Inbox =
	9
1.2	10	When receiving new messages, the chat concerned is also provided with a badge on the number of unread texts. This badge will disappear after you have visited the chat. Inside the chat, new messages are visually indicated from already read content by a separator.
1.1	11
	12
	13	{{id name="02-search"/}}
	14
	15	== Search ==
	16
2.6	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.
1.1	18
	19
	20	{{id name="02-createnewchat"/}}
	21
1.2	22	= Create a chat =
1.1	23
1.2	24	To create a new chat, use the button New chat in your inbox or tap the menu in the upper right corner of the screen. You can choose from the following options.
1.1	25
1.2	26	* 1:1 Chat
	27	* Group Chat
	28	* Broadcast
	29	* Federated Chat
	30	## ##
1.1	31
1.2	32	{{id name="02-onetoonechat"/}}
1.1	33
1.2	34	== 1:1 chat ==
1.1	35
1.2	36	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.
1.1	37
1.2	38	If you want to have topic-based 1:1 chats, use the option [[Group Chat>>doc:\|\|anchor="02-groupchat"]] when creating the chat. It is possible to create a group chat with only one other user (see [[Group Chat>>doc:\|\|anchor="02-groupchat"]]).
1.1	39
1.2	40	(% class="box warningmessage" %)
	41	(((
	42	1:1 chats cannot be subsequently extended with additional users to form a group chat.
	43	)))
1.1	44
1.2	45	{{id name="02-groupchat"/}}
1.1	46
1.2	47	== Group chat ==
1.1	48
1.2	49	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.
1.1	50
1.2	51	More information about chat content and actions are available [[here>>doc:\|\|anchor="02-chatcontentsandactions"]].
1.1	52
	53
1.2	54	{{id name="02-broadcastchat"/}}
1.1	55
1.2	56	== Broadcast chat ==
1.1	57
1.2	58	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.
1.1	59
1.2	60	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.
1.1	61
1.2	62	More information about the broadcast chat mode [[here>>doc:\|\|anchor="02-chatmode"]].
1.1	63
	64
1.2	65	{{id name="02-federatedchat"/}}
1.1	66
1.2	67	== Federated chat ==
1.1	68
1.2	69	Federated chats allow communicating with users from other Teamwire Servers.
1.1	70
1.2	71	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.
1.1	72
	73
1.2	74	{{id name="02-federatedchat-contacts"/}}
1.1	75
1.2	76	=== Available contacts ===
1.1	77
1.2	78	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.
	79
	80	Currently it is currently not possible to add more chat members to the chat later.
	81
	82
	83	{{id name="02-federatedchat-content"/}}
	84
	85	=== Available chat content ===
	86
	87	The range of [[chat content>>doc:\|\|anchor="02-chatcontentsandactions"]] is limited.
	88
2.4	89	Currently, the following attachment types are supported: photos, (gallery), videos (gallery), files, attention messages and locations.
1.2	90
	91
	92	{{id name="02-federatedchat-removed"/}}
	93
	94	=== Removed federations ===
	95
	96	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.
	97
	98
	99	{{id name="02-selectparticipants"/}}
	100
	101	== Select participants ==
	102
	103	Select one or more users from your list of contacts by tapping the checkbox next to the user's name.
	104
2.6	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.
1.2	106
	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
	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
1.1	111	## ##
2.5	112	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-create1.png\|\|width="280"]]
1.2	113	## ##
	114
	115	Your contacts are split into four types and are listed per section.
	116
	117	* [[Contacts>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome\|\|anchor="03-contacts"]]
	118	* [[Lists>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome\|\|anchor="03-lists"]]
	119	* [[Circles>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome\|\|anchor="03-circles"]]
	120	* [[Bots>>doc:Public.Applications.Android.User-Manual.Contacts.WebHome\|\|anchor="03-bots"]]
	121	## ##
	122
2.6	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"]].
1.2	124
	125
	126	{{id name="02-definechattitle"/}}
	127
	128	== Define chat title ==
	129
	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
	132	## ##
2.5	133	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-create2.png\|\|width="280"]]
1.2	134	## ##
	135
1.1	136	{{id name="02-definefurthersettings"/}}
	137
	138	== Define further settings ==
	139
	140	* Allow to mute notifications
1.2	141	Decide whether chat members are allowed to mute this conversation so they will no longer receive push notifications.
1.1	142
	143	* Alert Chat
1.2	144	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.
	145	## ##
1.1	146
1.2	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.
1.1	148
	149
2.1	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
2.5	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	## ##
2.1	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
2.5	194	## ##
	195	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-voip4.png\|\|width="280"]]
	196	## ##
2.1	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
1.1	213	{{id name="02-emergencyalert"/}}
	214
1.2	215	= Emergency alert (SOS button) =
1.1	216
1.2	217	By using the emergency button, you can quickly create a new alert chat with a predefined group of users. When creating an alert, your location data (GPS) will be requested and a voice message will be recorded - both being shared with the chat members.
1.1	218
1.2	219	An alert will use a special notification sound to be noticed by the chat members and becomes more prominent in their inboxes. More information are available at the [[Attention messages>>doc:\|\|anchor="02-alertmessages"]] chapter.
1.1	220
1.2	221	(% class="box infomessage" %)
	222	(((
	223	If the SOS button is not available to you, the feature may have been disabled by your Teamwire administrator.
	224	)))
1.1	225
2.5	226	## ##
	227	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-emergency.png\|\|width="280"]]
	228	## ##
	229
1.2	230	{{id name="02-emergencyalert-configure"/}}
1.1	231
1.2	232	== Set up the SOS button ==
1.1	233
1.2	234	The group of chat members contacted via the SOS button can be defined at [[Profile > Message settings > SOS Group>>doc:Public.Applications.Android.User-Manual.Settings.WebHome\|\|anchor="05-sosgroup"]]. If you do not define a recipient here, you will have to manually select a circle or list each time you use the button. If your device is managed by a mobile device management, your Teamwire admin may has already set an SOS group which you will not be able to change.
1.1	235
	236
1.2	237	{{id name="02-emergencyalert-usage"/}}
1.1	238
1.2	239	== Use the SOS button ==
1.1	240
1.2	241	In your inbox, open the emergency menu by swiping your screen to the right.
	242
	243	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.
	244
1.1	245	To record a voice message
	246
	247	* tap the button once to start a 30 seconds record timer or
	248	* tap and hold the button as long as you want to record your message.
1.2	249	## ##
1.1	250
1.2	251	Afterwards, your location and voice message will be sent to a predefined group of users.
1.1	252
	253
1.2	254	{{id name="02-pushtotalk"/}}
	255
	256	= Push-to-Talk =
	257
	258	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.
	259
	260	(% class="box infomessage" %)
1.1	261	(((
1.2	262	If Push-to-Talk is not available to you, the feature may have been disabled by your Teamwire administrator.
1.1	263	)))
	264
1.2	265	{{id name="02-pushtotalk-configure"/}}
	266
	267	== Set up Push-to-Talk ==
	268
	269	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.
	270
2.6	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.
1.2	272
	273	Use [[image:Public.Applications.Android.User-Manual.WebHome@icon-pttdeselect.png\|\|height="20"]] to remove your current selection of chats.
	274
1.1	275	## ##
2.5	276	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-ptt1.png\|\|width="280"]]
1.2	277	## ##
	278
	279	{{id name="02-pushtotalk-usage"/}}
	280
	281	== Use Push-to-Talk ==
	282
	283	Your Push-to-Talk chats are displayed at the bottom of the inbox. Simply swipe to switch between your Push-to-Talk chats.
	284
	285	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.
	286
	287	## ##
2.5	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"]]
1.2	289	## ##
	290
1.1	291	{{id name="02-chatcontentsandactions"/}}
	292
1.2	293	= Chat content and actions =
1.1	294
	295
	296	{{id name="02-attachments"/}}
	297
1.2	298	== Attachments and features ==
1.1	299
1.2	300	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.
1.1	301
2.5	302	## ##
	303	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-attachments.png\|\|width="280"]]
	304	## ##
1.1	305
1.2	306	[[image:Public.Applications.Android.User-Manual.WebHome@icon-camera.png\|\|height="20"]] Take photo
	307
	308	Grant access to your camera to take and send photos or videos. Video recording is limited to 180 seconds.
	309
	310
	311	[[image:Public.Applications.Android.User-Manual.WebHome@icon-gallery.png\|\|height="20"]] Photos and images from gallery
	312
	313	Grant access to your gallery to send photos and videos stored on your device.
	314
	315
	316	[[image:Public.Applications.Android.User-Manual.WebHome@icon-microphone.png\|\|height="20"]] Record voice message
	317
	318	Grant access to your microphone to record and send a voice message. Voice recording is limited to 180 seconds.
	319
	320
	321	[[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png\|\|height="20"]] Further attachments and features
	322
	323	You will be listed further options for sharing content.
	324
	325
	326	* [[image:Public.Applications.Android.User-Manual.WebHome@icon-alert.png\|\|height="20"]] Alert, [[image:Public.Applications.Android.User-Manual.WebHome@icon-annoucement.png\|\|height="20"]] Announcement or [[image:Public.Applications.Android.User-Manual.WebHome@icon-note.png\|\|height="20"]] Note
	327	These are so-called attention messages. More information about attention messages are available [[here>>doc:\|\|anchor="02-attentionmessages"]].
1.1	328
1.2	329	* [[image:Public.Applications.Android.User-Manual.WebHome@icon-file.png\|\|height="20"]] File
	330	Select any further file type via your file manager to share them (e.g. PDF, text file, presentation etc.).
1.1	331
1.2	332	* [[image:Public.Applications.Android.User-Manual.WebHome@icon-location.png\|\|height="20"]] Location
2.3	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"]].
1.1	335
1.2	336	* [[image:Public.Applications.Android.User-Manual.WebHome@icon-calendar.png\|\|height="20"]] Calendar
1.1	337	Grant access to your calendar to select appointments from your calendar app and attach them.
	338
1.2	339	* [[image:Public.Applications.Android.User-Manual.WebHome@icon-poll.png\|\|height="20"]] Poll
1.1	340	Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
2.2	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.
1.2	344	## ##
1.1	345
1.2	346	(% class="box infomessage" %)
1.1	347	(((
1.2	348	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.
1.1	349	)))
	350
1.2	351	{{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
1.1	352
1.2	353	== Attention messages ==
1.1	354
1.2	355	Via [[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png\|\|height="20"]] next to the text input field, various attention message types are available in Teamwire.
1.1	356
1.2	357	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.
	358	## ##
1.1	359
1.2	360	* [[image:Public.Applications.Android.User-Manual.WebHome@icon-alert.png\|\|height="20"]] Alert
	361	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.
	362	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"]].
	363	(% 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"]].
1.1	364
1.2	365	* [[image:Public.Applications.Android.User-Manual.WebHome@icon-annoucement.png\|\|height="20"]] Announcement
	366	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@icon-emptyActivities.png\|\|height="20"]] with a range of reactions.
1.1	367
1.2	368	* [[image:Public.Applications.Android.User-Manual.WebHome@icon-note.png\|\|height="20"]] Note
	369	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@icon-emptyActivities.png\|\|height="20"]] with a range of reactions.
	370	## ##
1.1	371
1.2	372	All message types above can be removed before sending by tapping the respective option again. Your message will be sent as normal text then.
1.1	373
	374	(% class="box infomessage" %)
	375	(((
1.2	376	If attention messages are not available to you, the feature may have been disabled by your Teamwire administrator.
1.1	377	)))
	378
1.2	379	{{id name="02-ownattentionmessages"/}}
	380
	381	=== Activity / Reactions ===
	382
	383	You can view the reactions to one of your attention messages via the [[image:Public.Applications.Android.User-Manual.WebHome@icon-report.png\|\|height="20"]] report.
	384
	385	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.
	386
	387
2.3	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	## ##
2.5	399	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-livelocation1.png\|\|width="280"]]
2.3	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
2.6	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
2.3	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).
2.7	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"]].
2.3	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
2.5	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
2.7	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".
2.5	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
1.2	545	{{id name="02-readreceipts"/}}
	546
	547	== Read receipts ==
	548
	549	The [[image:Public.Applications.Android.User-Manual.WebHome@icon-readeye.png\|\|height="15"]] 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.
	550
	551	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.
	552
	553	(% class="box infomessage" %)
1.1	554	(((
1.2	555	Your Teamwire administrator may disable read receipts for all users.
1.1	556	)))
	557
	558	{{id name="02-replytomessage"/}}
	559
	560	== Reply to message ==
	561
1.2	562	Tap and hold onto the respective message or attachment to open the context menu. Select Reply to add a quote of the original message when sending your answer. This is especially useful in conversations with a lot of users so you won't lose context.
1.1	563
	564
	565	{{id name="02-copymessage"/}}
	566
	567	== Copy message ==
	568
1.2	569	Tap and hold onto the respective message to open the context menu. Select Copy to copy the entire message content to your clipboard. You can paste the text to another chat or an external app.
1.1	570
1.2	571	(% class="box infomessage" %)
1.1	572	(((
1.2	573	If you cannot copy a message, the feature may have been disabled by your Teamwire administrator.
1.1	574	)))
	575
	576	{{id name="02-forwardmessage"/}}
	577
	578	== Forward message ==
	579
1.2	580	Tap and hold onto the respective message or attachment 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 forward to a user or circle that you don't have a chat with yet, tap New chat [[image:Public.Applications.Android.User-Manual.WebHome@icon-newchat.png\|\|height="20"]] in the bottom right corner of the screen and continue selecting your participants.
1.1	581
	582
	583	{{id name="02-deletemessage"/}}
	584
	585	== Delete message ==
	586
1.2	587	You can delete your own messages and attachments in Teamwire, even if they have already been read. Tap and hold the respective message or attachment to open the context menu and select Delete to remove it.
1.1	588
1.2	589	(% class="box infomessage" %)
1.1	590	(((
1.2	591	If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
1.1	592	)))
	593
	594	{{id name="02-chatsettings"/}}
	595
1.2	596	= Chat settings =
1.1	597
1.2	598	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.
1.1	599
	600	(% class="box infomessage" %)
	601	(((
1.2	602	Only [[chat administrators>>doc:\|\|anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
1.1	603	)))
	604
1.2	605	## ##
2.5	606	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-chatset1.png\|\|width="280"]]
1.2	607	## ##
1.1	608
	609	{{id name="02-chatavatar"/}}
	610
	611	== Chat avatar ==
	612
1.2	613	Tap on the current chat avatar. You can choose an existing picture of your photos and images from your Gallery or take a photo with your Camera. The new avatar will be shown to all members of the conversation.
1.1	614
1.2	615	Tap the avatar again to change or remove the image.
1.1	616
	617
	618	{{id name="02-chattitle"/}}
	619
	620	== Chat title ==
	621
	622	Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
	623
1.2	624	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.
1.1	625
	626
	627	{{id name="02-chatmode"/}}
	628
	629	== Chat mode ==
	630
	631	Teamwire supports two chat modes. Change the current mode by enabling or disabling the Allow to send messages feature.
	632
	633	* Normal
	634	//Allow to send messages// enabled
1.2	635	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.
1.1	636
	637	* Broadcast
	638	//Allow to send messages// disabled
1.2	639	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.
	640	## ##
1.1	641
	642	{{id name="02-chatadministrators"/}}
	643
	644	== Chat administrators ==
	645
	646	This section lists all administrators of the current chat.
	647
1.2	648	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.
1.1	649
1.2	650	In a 1:1 chat, both members become chat administrator by default.
1.1	651
1.2	652	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.
1.1	653
	654
	655	{{id name="02-promotetoadmin"/}}
	656
1.2	657	=== Promote to chat admin ===
1.1	658
1.2	659	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 via circle, tap on its name to view the list of members. Tap the user of concern and select Make chat admin.
1.1	660
	661	(% class="box infomessage" %)
	662	(((
1.2	663	The admin promotion cannot be revoked.
1.1	664	)))
	665
	666	{{id name="02-demoteadmin"/}}
	667
1.2	668	=== Demote chat admin ===
1.1	669
1.2	670	The admin promotion cannot be revoked.
1.1	671
1.2	672	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 regular chat member after adding them again.
1.1	673
	674
	675	{{id name="02-members"/}}
	676
	677	== Members ==
	678
1.2	679	This section lists all members of the current chat incl. chat administrators.
1.1	680
1.2	681	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.
1.1	682
	683
	684	{{id name="02-addmoremembers"/}}
	685
1.2	686	=== Add more members to chat ===
1.1	687
1.2	688	Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attachments.png\|\|height="20"]] 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.
1.1	689
	690
	691	{{id name="02-removemembers"/}}
	692
	693	=== Remove members ===
	694
1.2	695	To remove a user from the chat, tap their name in the list of chat members and 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.
1.1	696
	697
	698	{{id name="02-mediaoverview"/}}
	699
1.2	700	= Media overview =
1.1	701
1.2	702	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, but can also be viewed unfiltered via //All attachments.//
1.1	703
	704
	705	{{id name="02-chatadministration"/}}
	706
	707	= Chat administration =
	708
1.2	709	Below the media overview you will find the chat administration.
1.1	710
1.2	711	## ##
2.5	712	[[image:Public.Applications.Android.User-Manual.WebHome@EN__chats-chatset2.png\|\|width="280"]]
1.2	713	## ##
1.1	714
	715	{{id name="02-mutechat"/}}
	716
	717	== Mute chat ==
	718
1.2	719	This is a personal setting and will only affect your own user account.
1.1	720
1.2	721	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 number of unread messages.
	722
1.1	723	There are two options to mute a chat
	724
1.2	725	* Open the respective chat and view its chat settings by tapping its avatar and title. The option Mute can be found below the media overview.
	726	* In your inbox, tap and hold the chat of concern to open the context menu and select Mute.
	727	## ##
1.1	728
	729	You can re-enable notifications for a chat in the same way.
	730
1.2	731	(% class="box infomessage" %)
1.1	732	(((
1.2	733	If you cannot mute a chat, the feature may have been disabled by your Teamwire administrator or by a chat admin.
1.1	734	)))
	735
	736	{{id name="02-archivechat"/}}
	737
	738	== Archive chat ==
	739
1.2	740	This is a personal setting and will only affect your own user account.
	741
1.1	742	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.
	743
	744	There are two options to archive a chat
	745
1.2	746	* Open the respective chat and view its chat settings by tapping its avatar and title. The option Archive can be found below the media overview.
	747	* In your inbox, tap and hold the chat of concern to open the context menu and select Archive.
	748	## ##
1.1	749
1.2	750	To display archived chats in your inbox, activate the option Show archived chats via the menu in the upper right corner of the inbox. While viewing your archived chats, you can Unarchive a conversation again as archiving was described above.
1.1	751
	752
	753	{{id name="02-emailchathistory"/}}
	754
1.2	755	== Send chat history ==
1.1	756
1.2	757	Open the respective chat and view its chat settings by tapping its avatar and title. Select [[image:Public.Applications.Android.User-Manual.WebHome@icon-send.png\|\|height="20"]] Send to transfer the conversation in plain text to your default mail app. The action can be found below the media overview.
1.1	758
	759	Please note that attachments cannot be transferred to the mail.
	760
1.2	761	(% class="box infomessage" %)
	762	(((
	763	If the "Send" option is not available to you, the feature may have been disabled by your Teamwire administrator.
	764	)))
1.1	765
1.2	766	{{id name="02-closechat"/}}
	767
	768	== Close chat ==
	769
	770	This is an administrative setting and will affect all members of the chat. Only chat administrators can close a chat.
	771
	772	Close a chat when the conversation is over and no longer needed.
	773	After it has been closed, the chat will show an according info message and the chat history can no longer be read by its members.
	774
	775	There are two options to close a chat
	776
	777	* Open the respective chat and view its chat settings by tapping its avatar and title. The option Close chat can be found below the media overview.
	778	* In your inbox, tap and hold the chat of concern to open the context menu and select Close.
1.1	779	## ##
1.2	780
	781	You can reopen the chat in the same way if you are the chat administrator.
	782
	783	(% class="box infomessage" %)
	784	(((
	785	If the "Close" option is not available to you, the feature may have been disabled by your Teamwire administrator.
	786	)))
	787
	788	## ##
2.6	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"]]
2.5	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	## ##

Wiki source code of b. Chats and Messaging

Last edited

Content