Wiki source code of b. Chats and Messaging

Version 2.5 by teamwire003 on 2022/09/27 15:01

version	line-number	content
1.2	1	Starting Teamwire, the [[image:Public.Applications.iOS.User-Manual.WebHome@icon-tabmessages.png\|\|height="20"]] Messages 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-filter"/}}
	14
	15	== Filter ==
	16
2.5	17	You can filter your inbox by four criteria. To do so, tap the [[image:Public.Applications.iOS.User-Manual.WebHome@icon-dropdown.png\|\|height="12"]] drop-down menu at the top of your messages and select the type of chat concerned.
1.1	18
	19	* All chats
	20	As the app is being started, this is its default view. This filter shows both 1:1 chats and group chats. Archived chats are not being shown.
	21
	22	* 1:1 chats
	23	This filter shows 1:1 conversations only. Archived 1:1 chats are being displayed as well.
	24	A 1:1 chat is a conversation with exactly one other user.
	25
	26	* Group chats
	27	Only group conversations are being shown. Archived group chats are being displayed as well.
	28
	29	* Archived chats
	30	All archived chats are being shown - for both 1:1 chats and group chats.
1.2	31	## ##
1.1	32
	33	{{id name="02-search"/}}
	34
	35	== Search ==
	36
1.2	37	Swiping down in your inbox will make the search bar appear atop your messages. The search will look up for chat titles, contacts, circles and lists, and message content. To stop and leave the search bar, tap Cancel.
1.1	38
	39
	40	{{id name="02-createnewchat"/}}
	41
1.2	42	= Create a chat =
1.1	43
1.2	44	To create a new chat, use the button [[image:Public.Applications.iOS.User-Manual.WebHome@icon-newchat.png\|\|height="20"]] in the upper right corner of the screen. You can choose from the following options.
1.1	45
1.2	46	* 1:1 Chat
	47	* Group Chat
	48	* Broadcast
	49	* Federated Chat
	50	## ##
1.1	51
1.2	52	{{id name="02-onetoonechat"/}}
1.1	53
1.2	54	== 1:1 chat ==
1.1	55
1.2	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.
1.1	57
1.2	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"]]).
1.1	59
1.2	60	(% class="box warningmessage" %)
	61	(((
	62	1:1 chats cannot be subsequently extended with additional users to form a group chat.
	63	)))
1.1	64
1.2	65	{{id name="02-groupchat"/}}
1.1	66
1.2	67	== Group chat ==
1.1	68
1.2	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.
1.1	70
1.2	71	More information about chat content and actions are available [[here>>doc:\|\|anchor="02-chatcontentsandactions"]].
1.1	72
	73
1.2	74	{{id name="02-broadcastchat"/}}
1.1	75
1.2	76	== Broadcast chat ==
1.1	77
1.2	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.
1.1	79
1.2	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.
1.1	81
1.2	82	More information about the broadcast chat mode [[here>>doc:\|\|anchor="02-chatmode"]].
1.1	83
	84
1.2	85	{{id name="02-federatedchat"/}}
1.1	86
1.2	87	== Federated chat ==
1.1	88
1.2	89	Federated chats allow communicating with users from other Teamwire Servers.
1.1	90
1.2	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.
1.1	92
	93
1.2	94	{{id name="02-federatedchat-contacts"/}}
1.1	95
1.2	96	=== Available contacts ===
1.1	97
1.2	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 currently 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
2.4	109	Currently, the following attachment types are supported: photos, (gallery), videos (gallery), files, attention messages and locations.
1.2	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
	119	{{id name="02-selectparticipants"/}}
	120
	121	== Select participants ==
	122
	123	Select one or more users from your list of contacts by tapping the checkbox next to the user's name.
	124
	125	Already selected contacts are indicated with an [[image:Public.Applications.iOS.User-Manual.WebHome@icon-checked.png\|\|height="20"]] and can be deselected by re-tapping.
	126
	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.
	128
	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.
	130
1.1	131	## ##
2.5	132	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-create1.png\|\|width="280"]]
1.2	133	## ##
	134
	135	Your contacts are split into four types and are listed per section.
	136
	137	* [[Contacts>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome\|\|anchor="03-contacts"]]
	138	* [[Lists>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome\|\|anchor="03-lists"]]
	139	* [[Circles>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome\|\|anchor="03-circles"]]
	140	* [[Bots>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome\|\|anchor="03-bots"]]
	141	## ##
	142
	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 search bar, to find your contacts, lists, circles and bots per section.
	144
	145
	146	{{id name="02-definechattitle"/}}
	147
	148	== Define chat title ==
	149
	150	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.
	151
	152	## ##
2.5	153	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-create2.png\|\|width="280"]]
1.2	154	## ##
	155
1.1	156	{{id name="02-definefurthersettings"/}}
	157
	158	== Define further settings ==
	159
	160	* Allow to mute notifications
1.2	161	Decide whether chat members are allowed to mute this conversation so they will no longer receive push notifications.
	162
1.1	163	* Alert Chat
1.2	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	## ##
1.1	166
1.2	167	After defining all further settings, tap Create to enter the new chat automatically and you will be able to compose your first message.
1.1	168
	169
2.1	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
	180	(% class="box infomessage" %)
	181	(((
	182	If voice and video calls are not available to you, the feature may have been disabled by your Teamwire administrator.
	183	)))
	184
	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.iOS.User-Manual.WebHome@icon-voipvoice11.png\|\|height="20"]]## ## to start a voice call and ## ##[[image:Public.Applications.iOS.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.
	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.iOS.User-Manual.WebHome@icon-voipvoicegroup.png\|\|height="20"]]## ## for voice and ## ##[[image:Public.Applications.iOS.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.
	201
2.5	202	## ##
	203	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-voip1.png\|\|width="280"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-voip2.png\|\|width="280"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-voip3.png\|\|width="280"]]
	204	## ##
2.1	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
2.5	214	## ##
	215	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-voip4.png\|\|width="280"]]
	216	## ##
2.1	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
1.1	233	{{id name="02-emergencyalert"/}}
	234
1.2	235	= Emergency alert (SOS button) =
1.1	236
1.2	237	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	238
1.2	239	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	240
1.2	241	(% class="box infomessage" %)
	242	(((
	243	If the SOS button is not available to you, the feature may have been disabled by your Teamwire administrator.
	244	)))
1.1	245
2.5	246	## ##
	247	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-emergency.png\|\|width="280"]]
	248	## ##
	249
1.2	250	{{id name="02-emergencyalert-configure"/}}
1.1	251
1.2	252	== Set up the SOS button ==
1.1	253
1.2	254	The group of chat members contacted via the SOS button can be defined at [[Profile > Message settings > SOS Group>>doc:Public.Applications.iOS.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	255
	256
1.2	257	{{id name="02-emergencyalert-usage"/}}
1.1	258
1.2	259	== Use the SOS button ==
1.1	260
1.2	261	In your inbox, open the emergency menu by swiping your screen to the right.
	262
	263	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.
	264
1.1	265	To record a voice message
	266
	267	* tap the button once to start a 30 seconds record timer or
	268	* tap and hold the button as long as you want to record your message.
1.2	269	## ##
1.1	270
1.2	271	Afterwards, your location and voice message will be sent to a predefined group of users.
1.1	272
	273
1.2	274	{{id name="02-pushtotalk"/}}
	275
	276	= Push-to-Talk =
	277
	278	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.
	279
	280	(% class="box infomessage" %)
1.1	281	(((
1.2	282	If Push-to-Talk is not available to you, the feature may have been disabled by your Teamwire administrator.
1.1	283	)))
	284
1.2	285	{{id name="02-pushtotalk-configure"/}}
	286
	287	== Set up Push-to-Talk ==
	288
2.1	289	In your inbox, use the [[image:Public.Applications.iOS.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.
1.2	290
	291	As soon as you have defined at least one Push-to-Talk chat, you can decide via [[image:Public.Applications.iOS.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.
	292
	293	Use [[image:Public.Applications.iOS.User-Manual.WebHome@icon-pttdeselect.png\|\|height="20"]] to remove your current selection of chats.
	294
1.1	295	## ##
2.5	296	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-ptt1.png\|\|width="280"]]
1.2	297	## ##
	298
	299	{{id name="02-pushtotalk-usage"/}}
	300
	301	== Use Push-to-Talk ==
	302
	303	Your Push-to-Talk chats are displayed at the bottom of the inbox. Simply swipe to switch between your Push-to-Talk chats.
	304
	305	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.
	306
	307	## ##
2.5	308	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-ptt2.png\|\|width="280"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-ptt3.png\|\|width="280"]]
1.2	309	## ##
	310
1.1	311	{{id name="02-chatcontentsandactions"/}}
	312
1.2	313	= Chat content and actions =
1.1	314
	315
	316	{{id name="02-attachments"/}}
	317
1.2	318	== Attachments and features ==
1.1	319
1.2	320	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	321
2.5	322	## ##
	323	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-attachments.png\|\|width="280"]]
	324	## ##
1.1	325
1.2	326	[[image:Public.Applications.iOS.User-Manual.WebHome@icon-camera.png\|\|height="20"]] Take photo
1.1	327
1.2	328	Grant access to your camera to take and send photos or videos. Video recording is limited to 180 seconds.
1.1	329
	330
1.2	331	[[image:Public.Applications.iOS.User-Manual.WebHome@icon-gallery.png\|\|height="20"]] Photos and images from gallery
1.1	332
1.2	333	Grant access to your gallery to send photos and videos stored on your device.
1.1	334
	335
1.2	336	[[image:Public.Applications.iOS.User-Manual.WebHome@icon-microphone.png\|\|height="20"]] Record voice message
	337
	338	Grant access to your microphone to record and send a voice message. Voice recording is limited to 180 seconds.
	339
	340
	341	[[image:Public.Applications.iOS.User-Manual.WebHome@icon-attachments.png\|\|height="20"]] Further attachments and features
	342
	343	You will be listed further options for sharing content.
	344
	345
	346	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-alert.png\|\|height="20"]] Alert, [[image:Public.Applications.iOS.User-Manual.WebHome@icon-annoucement.png\|\|height="20"]] Announcement or [[image:Public.Applications.iOS.User-Manual.WebHome@icon-note.png\|\|height="20"]] Note
	347	These are so-called attention messages. More information about attention messages are available [[here>>doc:\|\|anchor="02-attentionmessages"]].
	348
	349	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-file.png\|\|height="20"]] File
	350	Select any further file type via your file manager to share them (e.g. PDF, text file, presentation etc.).
	351
	352	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-location.png\|\|height="20"]] Location
2.3	353	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.
	354	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.2	355
	356	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-calendar.png\|\|height="20"]] Calendar
	357	Grant access to your calendar to select appointments from your calendar app and attach them.
	358
	359	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-poll.png\|\|height="20"]] Poll
1.1	360	Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.
2.2	361
	362	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-dracoon.png\|\|height="20"]] Dracoon
	363	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	364	## ##
1.1	365
1.2	366	(% class="box infomessage" %)
1.1	367	(((
1.2	368	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	369	)))
	370
1.2	371	{{id name="02-attentionmessages"/}} {{id name="02-alertmessages"/}}
1.1	372
1.2	373	== Attention messages ==
1.1	374
1.2	375	Via [[image:Public.Applications.iOS.User-Manual.WebHome@icon-attachments.png\|\|height="20"]] next to the text input field, various attention message types are available in Teamwire.
1.1	376
1.2	377	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.
	378	## ##
1.1	379
1.2	380	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-alert.png\|\|height="20"]] Alert
	381	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.
	382	The alert notification sound can be configured via [[Profile > Message settings > Alert notification sound>>doc:Public.Applications.iOS.User-Manual.Settings.WebHome\|\|anchor="05-notificationsounds"]].
	383	(% 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	384
1.2	385	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-annoucement.png\|\|height="20"]] Announcement
	386	Label your message as an announcement (text input turns green). Chat members can react to your message via [[image:Public.Applications.iOS.User-Manual.WebHome@icon-emptyActivities.png\|\|height="20"]] with a range of reactions.
1.1	387
1.2	388	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-note.png\|\|height="20"]] Note
	389	Label your message as a note (text input turns yellow). Chat members can react to your message via [[image:Public.Applications.iOS.User-Manual.WebHome@icon-emptyActivities.png\|\|height="15"]] with a range of reactions.
	390	## ##
1.1	391
1.2	392	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	393
	394	(% class="box infomessage" %)
	395	(((
1.2	396	If attention messages are not available to you, the feature may have been disabled by your Teamwire administrator.
1.1	397	)))
	398
1.2	399	{{id name="02-ownattentionmessages"/}}
	400
	401	=== Activity / Reactions ===
	402
	403	You can view the reactions to one of your attention messages via the [[image:Public.Applications.iOS.User-Manual.WebHome@icon-report.png\|\|height="20"]] report.
	404
	405	You can find a chronological list of all reactions to your attention messages via the icon [[image:Public.Applications.iOS.User-Manual.WebHome@icon-bell.png\|\|height="20"]] in the upper right corner of the chat.
	406
	407
2.3	408	{{id name="02-livelocation"/}}
	409
	410	== Live location ==
	411
	412	This feature allows other users to track your current location live on a map.
	413
	414	To share your live location, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icon-attachments.png\|\|height="20"]] next to the text input field, select [[image:Public.Applications.iOS.User-Manual.WebHome@icon-location.png\|\|height="20"]] Location and Share your live location.
	415
	416	Open the live map and check your current position by tapping on the map preview in the chat.
	417
	418	## ##
2.5	419	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-livelocation1.png\|\|width="280"]]
2.3	420	## ##
	421
	422	{{id name="02-livelocation-duration"/}}
	423
	424	=== Sharing duration ===
	425
	426	As you start the live location feature, you can select for how long you want to share it.
	427
	428	The remaining minutes / hours of the duration are shown in the chat and map view.
	429
	430	The app will automatically stop sharing when the duration has been exceeded without further notification.
	431
	432
	433	{{id name="02-livelocation-stop"/}}
	434
	435	=== Stop sharing manually ===
	436
	437	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.
	438
	439
	440	{{id name="02-livelocation-multiple"/}}
	441
	442	=== Multiple users sharing ===
	443
	444	In one chat, multiple users can share their live location at the same time. Their locations will be shown in a single map.
	445
	446	A list of all chat members currently sharing their location is available in the bottom of the screen (expand).
	447
	448
	449	{{id name="02-livelocation-additional"/}}
	450
	451	=== Additional features ===
	452
	453	The live map offers different tools and settings to view users and map material.
	454
	455	* Focus user
	456	Tap on one of the users to focus on them. This way, the user will always remain in the center of the map view.
	457	You can also select the user from the list of all chat members currently sharing their location.
	458
	459	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-locationcenter.png\|\|height="18"]] Center map
	460	Tap on the symbol to center the view on your current location.
	461
	462	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-locationregroup.png\|\|height="18"]] Regroup
	463	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.
	464
2.5	465	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-locationdrawmap.png\|\|height="18"]] Draw on map
	466	Tap on the symbol to [[draw an area on the map>>doc:\|\|anchor="02-drawonmap"]].
	467
2.3	468	* [[image:Public.Applications.iOS.User-Manual.WebHome@icon-locationsettings.png\|\|height="20"]] Map settings
	469	Tap on the symbol to open the map settings.
	470	## ##
	471	Map type**
	472	Select from one of the available map types (Standard, Satellite, Hybrid).
	473
	474	Show user names**
	475	If enabled, in addition to the user photos, their names will be displayed on the map, too.
	476
	477	Show user role**
	478	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).
	479	## ##
	480
2.5	481	{{id name="02-drawonmap"/}}
	482
	483	== Draw on map ==
	484
	485	This feature allows you to manually draw areas on the maps of shared locations and label them.
	486
	487	## ##
	488	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-livelocation2.png\|\|width="280"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-livelocation3.png\|\|width="280"]]
	489	## ##
	490
	491	{{id name="02-drawonmap-draw"/}}
	492
	493	=== Draw area ===
	494
	495	Before sharing your location or live location, tap [[image:Public.Applications.iOS.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".
	496
	497	Tap Redraw area to draw the area anew.
	498
	499	Tap Done to save the area and share it with other chat participants.
	500
	501	Tap Cancel to end the process and discard the area you've drawn.
	502
	503	(% class="box infomessage" %)
	504	(((
	505	When sharing a single location, you will not be able to edit the drawn area at a later time.
	506
	507	When sharing you live location, you will be able to add or edit an area later.
	508	)))
	509
	510	{{id name="02-drawonmap-remove"/}}
	511
	512	=== Remove area ===
	513
	514	Tap on your area in the map view to open the dialog box and select Remove area to delete it.
	515
	516	You can only remove those areas which you have drawn yourself.
	517
	518	(% class="box infomessage" %)
	519	(((
	520	Areas can be removed when sharing your live location only.
	521
	522	When sharing a single location, you will not be able to remove an area later.
	523	)))
	524
	525	{{id name="02-drawonmap-label"/}}
	526
	527	=== Area labels ===
	528
	529	After drawing an area, a dialog box will open and prompting you to add a label.
	530
	531	Labels are optional. Leave the text input field empty, if you do not want to add a label.
	532
	533	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.
	534
	535	Tap Cancel to end the process and discard your changes.
	536
	537	You can only edit / remove labels for those areas which you have drawn yourself.
	538
	539	(% class="box infomessage" %)
	540	(((
	541	Labels can be edited / removed when sharing your live location only.
	542
	543	When sharing a single location, you will not be able to edit / remove an area label later.
	544	)))
	545
	546	{{id name="02-drawonmap-multiple"/}}
	547
	548	=== Multiple user areas ===
	549
	550	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.
	551
	552	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.
	553
	554	You cannot edit / remove areas and labels of other chat participants.
	555
	556	## ##
	557	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-livelocation4.png\|\|width="280"]]
	558	## ##
	559
1.2	560	{{id name="02-readreceipts"/}}
	561
	562	== Read receipts ==
	563
	564	The [[image:Public.Applications.iOS.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.
	565	Please note, that these read receipts only apply to the latest message of the chat and cannot be viewed for previous messages.
	566
	567	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.
	568
	569	(% class="box infomessage" %)
1.1	570	(((
1.2	571	Your Teamwire administrator may disable read receipts for all users.
1.1	572	)))
	573
	574	{{id name="02-replytomessage"/}}
	575
1.2	576	== Reply to message ==
1.1	577
1.2	578	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	579
	580
	581	{{id name="02-copymessage"/}}
	582
1.2	583	== Copy message ==
1.1	584
1.2	585	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	586
1.2	587	(% class="box infomessage" %)
1.1	588	(((
1.2	589	If you cannot copy a message, the feature may have been disabled by your Teamwire administrator.
1.1	590	)))
	591
	592	{{id name="02-forwardmessage"/}}
	593
1.2	594	== Forward message ==
1.1	595
1.2	596	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.iOS.User-Manual.WebHome@icon-newchat.png\|\|height="20"]] in the bottom right corner of the screen and continue selecting your participants.
1.1	597
	598
	599	{{id name="02-deletemessage"/}}
	600
1.2	601	== Delete message ==
1.1	602
1.2	603	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	604
1.2	605	(% class="box infomessage" %)
1.1	606	(((
1.2	607	If you cannot delete a message, the feature may have been disabled by your Teamwire administrator.
1.1	608	)))
	609
	610	{{id name="02-chatsettings"/}}
	611
1.2	612	= Chat settings =
1.1	613
1.2	614	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	615
	616	(% class="box infomessage" %)
	617	(((
1.2	618	Only [[chat administrators>>doc:\|\|anchor="02-chatadministrators"]] are authorised to make changes to chat settings.
1.1	619	)))
	620
1.2	621	## ##
2.5	622	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-chatset1.png\|\|width="280"]]
1.2	623	## ##
1.1	624
	625	{{id name="02-chatavatar"/}}
	626
	627	== Chat avatar ==
	628
1.2	629	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	630
1.2	631	Tap the avatar again to change or remove the image.
1.1	632
	633
	634	{{id name="02-chattitle"/}}
	635
	636	== Chat title ==
	637
	638	Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.
	639
1.2	640	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	641
	642
	643	{{id name="02-chatmode"/}}
	644
	645	== Chat mode ==
	646
	647	Teamwire supports two chat modes. Change the current mode by enabling or disabling the Allow to send messages feature.
	648
	649	* Normal
	650	//Allow to send messages// enabled
1.2	651	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.
	652
1.1	653	* Broadcast
	654	//Allow to send messages// disabled
1.2	655	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.
	656	## ##
1.1	657
	658	{{id name="02-chatadministrators"/}}
	659
	660	== Chat administrators ==
	661
	662	This section lists all administrators of the current chat.
	663
1.2	664	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	665
1.2	666	In a 1:1 chat, both members become chat administrator by default.
1.1	667
1.2	668	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.iOS.User-Manual.Contacts.WebHome\|\|anchor="03-circles"]] or [[lists>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome\|\|anchor="03-lists"]], or by a mix of all options mentioned.
1.1	669
	670
	671	{{id name="02-promotetoadmin"/}}
	672
1.2	673	=== Promote to chat admin ===
1.1	674
1.2	675	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	676
	677	(% class="box infomessage" %)
	678	(((
1.2	679	The admin promotion cannot be revoked.
1.1	680	)))
	681
	682	{{id name="02-demoteadmin"/}}
	683
1.2	684	=== Demote chat admin ===
1.1	685
1.2	686	The admin promotion cannot be revoked.
1.1	687
1.2	688	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	689
	690
	691	{{id name="02-members"/}}
	692
	693	== Members ==
	694
1.2	695	This section lists all members of the current chat incl. chat administrators.
1.1	696
1.2	697	If the chat was created with a group (or if one has been added later), you can tap the circle and select View members to view its list of users.
1.1	698
	699
	700	{{id name="02-addmoremembers"/}}
	701
1.2	702	=== Add more members to chat ===
1.1	703
1.2	704	Tap the uppermost option 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.
1.1	705
	706
	707	{{id name="02-removemembers"/}}
	708
	709	=== Remove members ===
	710
1.2	711	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	712
	713
	714	{{id name="02-mediaoverview"/}}
	715
1.2	716	= Media overview =
1.1	717
1.2	718	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	719
	720
	721	{{id name="02-chatadministration"/}}
	722
	723	= Chat administration =
	724
1.2	725	Below the media overview you will find the chat administration.
1.1	726
1.2	727	## ##
2.5	728	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-chatset2.png\|\|width="280"]]
1.2	729	## ##
1.1	730
	731	{{id name="02-mutechat"/}}
	732
	733	== Mute chat ==
	734
1.2	735	This is a personal setting and will only affect your own user account.
1.1	736
1.2	737	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.
	738
1.1	739	There are two options to mute a chat
	740
2.5	741	* Open the chat concerned and view its Chat Settings via the avatar in the upper right corner of the screen. The Mute action is located below the Media Overview.
1.1	742	* In your inbox, left swipe the chat concerned and tap Mute.
1.2	743	## ##
1.1	744
	745	You can re-enable notifications for a chat in the same way.
	746
1.2	747	(% class="box infomessage" %)
1.1	748	(((
1.2	749	If you cannot mute a chat, the feature may have been disabled by your Teamwire administrator or by a chat admin.
1.1	750	)))
	751
	752	{{id name="02-archivechat"/}}
	753
	754	== Archive chat ==
	755
1.2	756	This is a personal setting and will only affect your own user account.
	757
1.1	758	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.
	759
	760	There are two options to archive a chat
	761
2.5	762	* Open the chat concerned and view its Chat Settings via the avatar in the upper right corner of the screen. The Archive action is located below the Media Overview.
1.1	763	* In your inbox, left swipe the chat concerned and tap Archive.
1.2	764	## ##
1.1	765
1.2	766	You can view archived chats using the [[inbox filter>>doc:\|\|anchor="02-filter"]]. While viewing the archived chats, you can unarchive a conversation again in the same way as mentioned above.
1.1	767
	768
	769	{{id name="02-emailchathistory"/}}
	770
	771	== Email chat history ==
	772
1.2	773	Open the respective chat and view its chat settings by tapping its avatar and title. Select [[image:Public.Applications.iOS.User-Manual.WebHome@icon-send.png\|\|height="20"]] Email Chat History to transfer the conversation in plain text to your default mail app. The action can be found below the media overview.
1.1	774
	775	Please note that attachments cannot be transferred to the mail.
	776
1.2	777	(% class="box infomessage" %)
	778	(((
	779	If the "Email Chat History" option is not available to you, the feature may have been disabled by your Teamwire administrator.
	780	)))
1.1	781
1.2	782	{{id name="02-closechat"/}}
	783
	784	== Close chat ==
	785
	786	This is an administrative setting and will affect all members of the chat. Only chat administrators can close a chat.
	787
	788	Close a chat when the conversation is over and no longer needed.
	789	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.
	790
	791	There are two options to close a chat
	792
2.5	793	* Open the chat concerned and view its Chat Settings via the avatar in the upper right corner of the screen. The Close chat action is located below the Media Overview.
1.2	794	* In your inbox, left swipe the chat concerned and tap Close.
	795	## ##
	796
	797	You can reopen the chat in the same way, if you are a chat administrator.
	798
	799	(% class="box infomessage" %)
	800	(((
	801	If the "Close chat" option is not available to you, the feature may have been disabled by your Teamwire administrator.
	802	)))
	803
2.5	804	## ##
	805	[[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-closed1.png\|\|width="280"]] ## ## [[image:Public.Applications.iOS.User-Manual.WebHome@EN__chats-closed2.png\|\|width="280"]]
	806	## ##
	807
1.1	808	{{id name="02-leavechat"/}}
	809
	810	== Leave chat ==
	811
	812	Leave a chat when you no longer want to be part of the conversation or your participation is no longer needed.
	813
	814	There are two options to leave a chat
	815
2.5	816	* Open the chat concerned and view its Chat Settings via the avatar in the upper right corner of the screen. The Leave chat action is located below the Media Overview.
1.1	817	* In your inbox, left swipe the chat concerned and tap Leave.
1.2	818	## ##
1.1	819
1.2	820	(% class="box infomessage" %)
1.1	821	(((
1.2	822	If the "Leave" option is not available to you, the feature may have been disabled by your Teamwire administrator.
	823
	824	Please note that you cannot leave chats in which you have been added as part of a [[circle>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome\|\|anchor="03-circles"]].
1.1	825	)))
	826
	827	## ##

Wiki source code of b. Chats and Messaging

Last edited

Content