b. Chats and Messaging - Teamwire Knowledge Base

1

Starting Teamwire, the **Chats** 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 Chats 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.

== Search ==

Tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-magnifier.png||queryString="height=20" height="20"]] in the right upper corner of the screen to open a search bar. The search will look up for chat titles, contacts, groups, and message content.

= Create new chat =

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

25

26

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

27

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

28

29

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

== Select participants ==

35

36

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

37

38

39

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

40

41

42

Teamwire classifies your contacts into three types:

43

44

* **Contacts**

45

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

46

47

* **Groups**

48

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

49

50

* **Directory**

51

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

52

53

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

54

55

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

== Define chat title ==

61

62

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

63

64

65

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

66

67

68

(% class="box infomessage" %)

69

(((

70

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

71

72

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

)))

## ##

== Define further settings ==

79

80

* **Chat avatar**

81

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

82

83

* **Allow to send messages**

84

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

85

86

* **Allow to mute notifications**

87

Decide whether chat members are allowed to mute this conversation.

88

89

* **Alert Chat**

90

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

91

92

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) =

98

99

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

100

101

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

102

103

104

**Creating a chat with the Emergency Button**

105

106

When looking at your inbox, you can open the emergency menu by swiping your screen to the right.

107

108

109

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

110

111

112

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

113

114

To record a voice message

115

116

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

117

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

118

119

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

120

121

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

(% class="box" %)

(((

The Emergency 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.

139

140

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

141

142

* **Gallery**

143

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

144

145

* **Camera**

146

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

147

148

* **Voice Message**

149

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

150

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

151

152

* **Location**

153

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

154

155

* **Calendar**

156

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

157

158

* **File**

159

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

160

161

* **Poll**

162

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.Android.User-Manual.WebHome@icon-alarmoff.png||queryString="height=20" height="20"]] If the alert label is activated, the icon and your text input field will turn red: [[image:Public.Applications.Android.User-Manual.WebHome@icon-alarmon.png||queryString="height=20" height="20"]]

175

176

Alerts cause a special ringtone and will create a different icon on the Android notification screen for its participants. A chat containing an alert message will be visually highlighted in its participants inbox, and will always stay on top until all new content has been read.

177

178

179

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

180

181

182

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

183

184

The alert notification sound can be configured via [[Profile > Message Settings > Alert notification sound>>doc:Public.Applications.Android.User-Manual.Settings.WebHome||anchor="05-notificationsounds"]].

185

186

(% class="box infomessage" %)

187

(((

188

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

189

190

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 message ==

202

203

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

== Copy message ==

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 message ==

221

222

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

== Delete message ==

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

230

231

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

== Read receipts ==

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

239

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

240

241

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

(% 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.

254

255

(% class="box infomessage" %)

256

(((

257

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

)))

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

== Chat avatar ==

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

269

270

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.

278

279

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

== Chat mode ==

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

287

288

* **Normal**

289

//Allow to send messages// enabled

290

By default, the Chat Settings suggest to create a conversation with the //Normal// chat mode enabled. This mode allows all members to compose and send messages / attachments to the chat.

291

292

* **Broadcast**

293

//Allow to send messages// disabled

294

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

## ##

== Chat administrators ==

300

301

This section lists all administrators of the current chat.

302

303

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

304

305

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

306

307

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

=== Promote to admin ===

313

314

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

315

316

(% class="box infomessage" %)

317

(((

318

The promotion for being chat administrator cannot be revoked.

)))

## ##

=== Demote admin ===

The promotion for being chat administrator cannot be revoked.

327

328

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

== Members ==

This section lists all members of the current chat.

336

337

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

=== Add more members ===

343

344

In order to add further members to the chat, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attach.png||queryString="height=20" height="20"]] in the right upper corner of the screen to see your list of contacts.

345

346

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

=== Remove members ===

352

353

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

354

355

**Quick editing**

356

When viewing the list of chat members, tap [[image:Public.Applications.Android.User-Manual.WebHome@icon-attach.png||queryString="height=20" height="20"]] in the right upper corner of the screen to remove multiple contacts from the chat. Confirm your changes by tapping **Done.**

= 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 =

369

370

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

371

372

373

[[image:Public.Applications.Android.User-Manual.WebHome@en_mess_chatoptions_archive.png||queryString="width=300" 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.

381

382

There are two options to mute a chat

383

384

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

385

* In your inbox, tap and hold the chat concerned to open the context menu and select **Mute.**

386

387

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.

400

401

There are two options to archive a chat

402

403

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

404

* In your inbox, tap and hold the chat concerned to open the context menu and select **Archive.**

405

406

To display archived chats in your inbox, activate the option **Show archived chats** via the menu in the right upper corner of the screen. While viewing your archived chats, you can **unarchive** a conversation again in the same way as mentioned above.

== Email chat history ==

412

413

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

414

415

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.

423

424

There are two options to leave 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 **Leave chat** action is located below the Media Overview.

427

* In your inbox, tap and hold the chat concerned to open the context menu and select **Leave.**

(% class="box" %)

(((

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

432

)))

433

434

## ##

Wiki source code of b. Chats and Messaging

Last edited

Content