b. Chats and Messaging - Teamwire Knowledge Base

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 have created or are involved in.

2

3

As you receive new messages, you will find a badge counter on the Messages tab indicating the amount of unread texts.

= Inbox =

When receiving new messages, the chat concerned is also provided with a badge on the amount of unread texts. This badge will disappear after you have opened / read the chat. In the chat itself, new messages are visually indicated from already read content by a separator.

== Filter ==

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** atop your messages and select the type of chat concerned.

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.

## ##

== Search ==

Swiping down in your inbox will make the search bar appear atop your messages. The search will look up for chat titles, contacts, groups, and message content. To stop and leave the search bar, tap **Cancel.**

= Create new chat =

To create a new chat, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icon-newchat.png||height="20"]] in the right upper corner of the screen. The creation process has two steps:

45

46

* [[Select participants>>doc:||anchor="02-selectparticipants"]]

47

* Define a [[chat title>>doc:||anchor="02-definechattitle"]] and [[further settings>>doc:||anchor="02-definefurthersettings"]]

48

49

You will enter the newly created chat automatically to send your message.

== Select participants ==

55

56

Select at least one user from your list of contacts and tap **Next.**

57

58

59

[[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_create1.png||width="300"]]

60

61

62

Teamwire classifies your contacts into three types:

63

64

* **Contacts**

65

Single user accounts (usually employees and colleagues) your administrator has allowed to communicate with. If Teamwire has been granted access to your address book, you may also find some of these contacts in Teamwire - even though they do not belong to your company directly. For more information, see [[My Contacts>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-mycontacts"]].

66

67

* **Groups**

68

Predefined groups of people (similar to a mailing list) your administrator has allowed to communicate with, or you have created yourself. For more information, see [[Groups>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-groups"]].

69

70

* **Directory**

71

You can manually search the Directory (former //Enterprise Directory//) for individual internal and external users that have not yet been synchronised. For more information, see [[Directory>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-directory"]].

72

73

The participants (so-called //members//) of your chat can be both individual contacts as well as groups. Please notice the **maximum of members** that can be added to a chat. The number of currently selected users will be shown during the creation (X / 1250 users).

74

75

Your list of contacts is arranged in alphabetical order (by the last name) but it still might feel challenging finding your colleagues within an excessive number of users. **To find colleagues and groups more quickly, make use of the search bar** located atop the list of contacts. It will show all user accounts matching your input.

== Define chat title ==

81

82

Define a matching title for your conversation. This title is not final and can be changed at any time via the [[Chat Settings>>doc:||anchor="02-chatsettings"]].

83

84

85

[[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_create2.png||width="300"]]

86

87

88

(% class="box infomessage" %)

89

(((

90

**For group chats,** setting a title is **mandatory.**

91

92

The title is optional for 1:1 chats. If no title has been defined, Teamwire will show the name of the user you are talking to.

)))

## ##

== Define further settings ==

99

100

* **Chat avatar**

101

In order to recognise chats more easily, you can set a picture for chat avatar.

102

103

* **Allow to send messages**

104

You can prohibit other chat members from sending messages to the conversation.

105

This is the so-called **broadcast mode** which allows composing and sending messages only to [[chat administrators>>doc:||anchor="02-chatadministrators"]]. For more information, see [[chat mode>>doc:||anchor="02-chatmode"]].

106

107

* **Allow to mute notifications**

108

Decide whether chat members are allowed to mute this conversation.

109

110

* **Alert Chat**

111

This feature is meant for emergencies. An alert chat will always stay on top of its members messages inbox until the content has been read. For more information, see [[alert message>>doc:||anchor="02-alertmessages"]].

112

113

After defining all further settings, tap **Create** and you will enter the newly created chat automatically to compose and send your message.

= Emergency Alert (SOS Button) =

119

120

With the SOS Button you can quickly create a new alert chat with **a predefined group of people.** When creating an alert, your location data (via GPS) will be requested and a voice message will be recorded - both being shared with the chat members.

121

122

An alert chat will always stay on top of its members messages inbox until the content has been read. For more information, see [[alert message>>doc:||anchor="02-alertmessages"]].

123

124

125

**Creating a chat with the SOS Button**

126

127

No matter what tab you are on (//Messages//, //Contacts//, or //Profile//), you can open the emergency menu by swiping your screen to the right.

128

129

130

[[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_sosbutton.png||width="300"]]

131

132

133

Teamwire will locate your current position via GPS (if Teamwire has been granted access to your location) and will request you to record a voice message (if Teamwire has been granted access to your microphone) to send both information to the chat.

134

135

To record a voice message

136

137

* tap the button once to start a 30 seconds record timer or

138

* tap and hold the button as long as you want to record your message.

139

140

Afterwards, your location and voice message will be sent to a predefined group of people.

141

142

You can configure the group for the SOS Button via [[Profile > Message Settings > SOS Group>>doc:Public.Applications.iOS.User-Manual.Settings.WebHome||anchor="05-sosgroup"]]. If you have not configured an SOS Group, you will have to select a group manually each time the SOS Button feature is being used. If your phone is being managed by a Mobile Device Management system, your Teamwire administrator might has already defined an SOS group for you which you cannot change.

(% class="box" %)

(((

The SOS Button feature has to be enabled by your Teamwire administrator. If it is not available to you, it may has been disabled.

)))

## ##

= Chat contents and actions =

== Attachments ==

In addition to texts and emojis, you can send various attachments via Teamwire.

160

161

If you want to attach a photo, appointment, or the like to your current conversation, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icon-attach.png||height="20" width="20"]] next to your text input field and select the type of file you want to share with the chat.

162

163

* **Gallery**

164

Grant access to your gallery to send stored photos and videos.

165

166

* **Camera**

167

Grant access to your camera to create and send photos or videos. Video recording is limited to 180 seconds.

168

169

* **Voice Message**

170

Grant access to your microphone to record and send a voice message. The voice message is limited to 180 seconds.

171

You can also create a voice message by tapping the quick record button [[image:Public.Applications.iOS.User-Manual.WebHome@icon-voicerecord.png||height="20"]] next to your text input.

172

173

* **Location**

174

If Teamwire has been granted access to your location data and your mobile GPS is active, you will be able to select either your current position or choose a POI from the map, to send it to the chat.

175

176

* **Calendar**

177

Grant access to your calendar to select appointments from your calendar app and attach them.

178

179

* **File**

180

Select any further file type via your file manager and attach them (e.g. PDF, text file, presentation, etc.).

181

182

* **Poll**

183

Create a poll (interactive attachment) and let your chat members vote to make decisions more quickly.

(% class="box" %)

(((

Your Teamwire administrator is able to prohibit sending certain (or all) attachment types. If they are not available to you, they may have been disabled.

)))

## ##

== Alert messages ==

The text input field allows labeling your message as alert by tapping [[image:Public.Applications.iOS.User-Manual.WebHome@icon-alarmoff.png||height="20"]] If the alert label is activated, the icon and your text input field will turn red: [[image:Public.Applications.iOS.User-Manual.WebHome@icon-alarmon.png||height="20"]]

196

197

Alerts cause a special ringtone and will create a different icon on the iOS 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.

198

199

200

[[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_sosinbox.png||width="300"]]

201

202

203

To remove the alert label, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icon-alarmon.png||height="20"]] again.

204

205

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"]].

206

207

(% class="box infomessage" %)

208

(((

209

Do not mix things up: An alert message is **a single message labeled as alert.**

210

211

If you want to create an alert chat quickly, see [[Emergency Button>>doc:||anchor="02-emergencyalert"]].

)))

(% class="box" %)

(((

The feature of sending alert messages has to be enabled by your Teamwire administrator. If it is not available to you, it may has been disabled.

)))

## ##

== Reply to messages ==

223

224

Tap and hold the message or attachment concerned to open the context menu. Select **Reply** to quote the respective message when sending your answer. This is especially useful in conversations with a lot of users to not lose context.

== Copy messages ==

Tap and hold the message concerned to open the context menu. Select **Copy** to copy the entire message content to your clipboard. You can paste the text into another chat or an external app.

(% class="box" %)

(((

The feature of copying message content has to be enabled by your Teamwire administrator. If the feature is not available to you, it may has been disabled.

)))

## ##

== Forward messages ==

242

243

Tap and hold the message or attachment concerned to open the context menu and select **Forward.** A list of all existing chats to which you can forward the content to will be displayed. If you want to use a new chat to forward the content to, tap [[image:Public.Applications.iOS.User-Manual.WebHome@icon-newchat.png||height="20"]] at the right upper corner of the screen and continue selecting your participants.

== Delete messages ==

249

250

Tap and hold the message or attachment concerned to open the context menu and select **Delete** to remove the content.

251

252

Please note, the content will be removed for your eyes only and only for the device at hand. Other members of this conversation will still be able to see the removed message / attachment; it will also remain visible to your other device(s) (e.g. your desktop app).

== Read receipts ==

The present [[image:Public.Applications.iOS.User-Manual.WebHome@icon-readeye.png||height="12" width="20"]] read receipts of the chat members are represented by their avatars. They can be found at the bottom of the conversation.

260

Please note, that these read receipts **only apply to the last message** of the chat and cannot be viewed for previous messages.

261

262

If you are looking for a detailed view of the present read receipts, you can tap at the line of user avatars to receive a complete list.

(% class="box" %)

(((

Your Teamwire administrator may disable the feature of the read receipts for all users.

)))

## ##

= Chat Settings =

Tap the chat avatar in the right upper corner of the screen to open the Chat Settings. Among other things, here you are able to change the chat title or add more users to the conversation.

275

276

(% class="box infomessage" %)

277

(((

278

Only [[chat administrators>>doc:||anchor="02-chatadministrators"]] are authorised to make changes to the Chat Settings.

279

)))

280

281

[[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_chatoptions.png||width="300"]]

== Chat avatar ==

Tap on the current chat avatar. You can choose an existing image **From gallery** or take a photo by tapping **Use camera.** The new avatar will be shown to all members of the conversation.

289

290

You can tap the current avatar again to **Change** or **Delete** it.

== Chat title ==

Tap on the text below the chat avatar to edit the chat title. Confirm your changes via Enter.

298

299

If you want to reset a chat title, remove the current text input and confirm via Enter. The title will adopt the automatically generated name. For group chats, defining your own title is mandatory.

== Chat mode ==

Teamwire supports two chat modes. Change the current mode by enabling or disabling the **Allow to send messages** feature.

307

308

* **Normal**

309

//Allow to send messages// enabled

310

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.

311

312

* **Broadcast**

313

//Allow to send messages// disabled

314

The //Broadcast// mode will only allow [[chat administrators>>doc:||anchor="02-chatadministrators"]] to compose and send messages / attachments to the chat. This mode is very useful for sharing announcements or briefings in a company.

## ##

== Chat administrators ==

320

321

This section lists all administrators of the current chat.

322

323

Chat administrators are able to make changes in the Chat Settings, e.g. editing the chat title and chat mode, allowing to mute the chat, or promote other members to become chat administrator.

324

325

In a 1:1 chat, both chat members are being administrator by default.

326

327

**In a group chat, the creator of the chat is automatically promoted for being administrator** - whether by selecting individual users, by adding groups ([[Organisation Groups>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-organisationgroups"]] or [[User Groups>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-usergroups"]]), or by creating the chat with a mix of both.

=== Promote to admin ===

333

334

In the Chat Settings, tap [[Members>>doc:||anchor="02-members"]] to see a complete list of the current chat's participants. If the chat was created with a group, you can tap the name of the group to view its list of members. Tap and hold the user concerned and select **Make chat admin.**

335

336

(% class="box infomessage" %)

337

(((

338

The promotion for being chat administrator cannot be revoked.

339

)))

340

341

[[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_chatadmin_make.png||width="300"]] [[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_chatadmins.png||width="300"]]

=== Demote admin ===

The promotion for being chat administrator cannot be revoked.

349

350

You may use the following workaround: Remove the user from the current chat and add them again afterwards. Thus the user is being removed from both the list of members and administrators, and will become a chat member only if you add them to the conversation again.

== Members ==

This section lists all members of the current chat.

358

359

If the chat was created with a group (or if one has been added later), you can tap the name of the group to view its list of members.

=== Add more members ===

365

366

Tap the uppermost option **Add a Colleague to this Chat** to see your list of contacts.

367

368

Select users and groups whom you would like to add and confirm your selection by tapping **Done.**

=== Remove members ===

374

375

Tap on a user in the list of members and select **Remove from chat** to have them removed. Users that have been added via a group cannot be removed individually. A group will always need to be removed as a whole.

376

377

**Quick editing**

378

When viewing the list of chat members, tap **Edit** in the right upper corner of the screen to remove multiple contacts from the chat. Confirm your changes by tapping **Done.**

= Media Overview =

Below the Chat Settings you will find the **Media Overview,** which allows you to look up for all attachments and alarms that have been sent in the current chat. The media is filtered by its file type, but can also be viewed unfiltered via //All attachments.//

= Chat administration =

391

392

Below the Media Overview you will find options to manage the current conversation, like muting, archiving and exiting the chat, or sending the chat history via email.

393

394

Most of these actions can also be done by swiping to the left in your message inbox.

395

396

[[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_chatoptions_archive.png||width="300"]] [[image:Public.Applications.iOS.User-Manual.WebHome@en_mess_inbox_archive.png||width="300"]]

== Mute chat ==

Mute a chat to stop receiving notifications. When muted, the notification sound, vibration and push notifications will not be triggered **for this chat.** The app icon on your home screen will keep showing the amount of unread messages.

404

405

There are two options to mute a chat

406

407

* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Mute** action is located below the Media Overview.

408

* **In your inbox, left swipe** the chat concerned and tap **Mute.**

409

410

You can re-enable notifications for a chat in the same way.

(% class="box" %)

(((

Chat administrators are able to prohibit muting a chat. If the feature is not available to you, it may has been disabled.

)))

## ##

== Archive chat ==

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.

423

424

There are two options to archive a chat

425

426

* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Archive** action is located below the Media Overview.

427

* **In your inbox, left swipe** the chat concerned and tap **Archive.**

428

429

You can view archived chats using the [[inbox filter>>doc:||anchor="HFilter"]]. While viewing the archived chats, you can **unarchive** a conversation again in the same way as mentioned above.

== Email chat history ==

435

436

Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. Tap **Email Chat History** to forward the conversation in plain text to your default mail app and send it. The action is located below the Media Overview.

437

438

Please note that attachments cannot be transferred to the mail.

== Leave chat ==

Leave a chat when you no longer want to be part of the conversation or your participation is no longer needed.

446

447

There are two options to leave a chat

448

449

* Open the chat concerned and view its Chat Settings via the avatar in the right upper corner of the screen. The **Leave chat** action is located below the Media Overview.

450

* **In your inbox, left swipe** the chat concerned and tap **Leave.**

(% class="box" %)

(((

Please note that you cannot leave chats in which you have been added as part of a [[Organisation Group>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-organisationgroups"]]. If you were added as a member of a [[User Group>>doc:Public.Applications.iOS.User-Manual.Contacts.WebHome||anchor="03-usergroups"]], you will have to confirm your withdrawal of the group first. You will then automatically leave the chat.

455

)))

456

457

## ##

Wiki source code of b. Chats and Messaging

Last edited

Content