Starting Teamwire, the   Messages tab is shown by default. It shows all chats you are involved in.

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

Search

Atop your messages you will find a search bar. The search will look up for chat titles, contacts, groups, and message content. Results are separated into said categories.

• Clicking on a search result will take you to the original message or chat. 
• Clicking on a contact in the search results opens the chat with this contact or, if no chat exists with the contact yet, creates one.
   

Create a chat

To create a new chat, click  atop your messages. You can choose from the following options.

• 1:1 Chat
• Group Chat
• Broadcast
• Federated Chat
   

1:1 chat

Select a participant. 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 can be used. 

If you want to have topic-based 1:1 chats, use the option Group Chat when creating the chat. It is possible to create a group chat with only one other user (see Group Chat).

Group chat

Select one or more participants, set a chat title and define further settings. You will enter the new chat automatically and will be able to compose your first message.

More information about chat content and actions are available here.

Broadcast chat

A broadcast chat is a group chat with the broadcast mode enabled. This mode is very useful for sharing announcements or briefings in your organisation.

Select one or more participants, set a chat title and define further settings. You will enter the new chat automatically and will be able to compose your first message.

More information about the broadcast chat mode are available here.

Federated chat

Federated chats allow communicating with users from other Teamwire Servers.

Select one or more participants, set a chat title and define further settings. You will enter the new chat automatically and will be able to compose your first message.

Available contacts

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.

Currently it is currently not possible to add more chat members to the chat later.

Available chat content

The range of chat content is limited.

Currently, the following attachment types are supported: photos, (gallery), videos (gallery), files, attention messages and locations.

Removed federations

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, the chat history remains available for all members and can still be read.

Define chat title

Set a title for your conversation. This title is not final and can be changed at any time via Chat Settings. For group chats, setting a title is mandatory.

Select participants

Select one or more users from your list of contacts by selecting the checkbox next to the user's name.

Already selected contacts are indicated with an  and can be deselected by clicking again. 

You can combine contacts, lists, circles and bots as recipients for a chat. On the right-hand side you can see an overview of all selected recipients and also remove them there.

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.

Your contacts are split into four types and are listed per section.

• Contacts
• Lists
• Circles
• Bots
   

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 bar is located above the left-side list of contacts.

Define further settings

• Allow to mute notifications
  Decide whether chat members are allowed to mute this conversation so they will no longer receive push notifications.

• Alert Chat
  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 chapter.
   

After defining all further settings, click OK to enter the new chat automatically and you will be able to compose your first message.

Voice and video calls

You can contact one or multiple users in your existing chats via voice or video call.

This feature is available for 1:1 chats and group chats.

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.

Start a call

Open an existing chat or create a new chat with your favoured participants.

Start the call by tapping the respective button in the upper right corner of the screen.

Use    to start a voice call and    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.

The other call participants will be notified, even if they are currently not actively using the Teamwire app.

The number of participants for group calls is limited and given by your Teamwire server admin.

If your group chat has more participants than the number of members allowed in a group call, the icons will change a bit into    for voice and    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.

Join a call

If you have missed a call, you can also join it later.

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.

Features during a call

The following primary features are available during the call.

• Enable / disable microphone
• Enable / disable camera
• Select sound device
• Screen sharing
• Raise hand

Chat content and actions

Attachments and functions

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

If you want to attach a photo, video, audio file, appointment, presentation, PDF or the like to your current conversation, click    to select your file, or just drag and drop it onto the Teamwire app to share it with the chat. For most photo files, a preview is displayed directly in the chat.

Via the  button next to the text input field, Teamwire also provides additional features like attention messages and polls.

With the button  , you can record voice messages, provided you have connected a microphone. Define your input and output devices in the General settings.

Attention messages

Via  next to the text input field, various types of attention message are available in Teamwire.

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.

• Alert
  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.
  The alert notification sound can be configured via Settings > Notifications.

• Announcement
  Label your message as an announcement (text input turns green). Chat members can react to your message via  with a range of reactions.

• Note
  Label your message as an note (text input turns yellow). Chat members can react to your message via  with a range of reactions.
   

All message types above can be removed before sending by clicking the  icon. Your message will be sent as normal text then.

Activity / Reactions

You can view the reactions to one of your attention messages via the report.

You can find a chronological list of all reactions to your attention messages via the icon  in the upper right corner of the chat.

Live location

Sharing your own location is not possible in the desktop app. However, you can track the location of other users live on the map. Open the live map and check user's positions by clicking on the map preview in the chat.

In one chat, multiple users can share their live location at the same time. Their locations will be shown in a single map.

A list of all chat members currently sharing their location is available in the bottom of the screen (expand).

Additional features

• Focus user
  Click on one of the users to focus on them. This way, the user will always remain in the center of the map view.
  You can also select the user from the list of all chat members currently sharing their location.
   

Define further view options via the    icon above the live map view.

• Show user names
  If enabled, in addition to the user photos, their names will be displayed on the map, too.
   
• Show user role
  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).
   

Draw on map

In the desktop app, it is not possible to manually draw areas on the maps of shared locations and label them. However, you can view the areas and its labels drawn by other users. Open the map / live map by clicking on the map preview in the chat to see the areas.

Polls

Via  next to the text input field, you can create polls in Teamwire.

Click  to create a poll and let your chat members vote to make decisions more quickly.

Read receipts

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

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.

Reply to a message

Move your cursor at the respective message or attachment and click on the    icon 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.

Copy a message

Move your cursor at the respective message or attachment and click on the    icon to open the context menu. Select Copy to copy the entire message content to your clipboard.

You can also mark a part of the message with your cursor and perform a right click to open the context menu. Select Copy (or use the shortcut Ctrl+C resp. Cmd+C) to copy the content to your clipboard.

You can paste the text to another chat or an external app.

Forward a message

Move your cursor at the respective message or attachment and click on the    icon 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, click on New Chat atop the listed chats and continue selecting your participants.

Delete a message

You can delete your own messages and attachments in Teamwire, even if they have already been read. Move your cursor at the respective message or attachment and click on the    icon to open the context menu and select Delete to remove it.

Chat menu

In your current chat view, click on the    icon in the right upper corner to open the chat menu.

Here you can make different adjustments to the chat like adding further users, view attachments and attention messages, or leave the conversation.

Chat settings

Select Chat Settings from the chat menu. Among other things, here you can edit the title.

Chat avatar

Click on the current chat avatar to search your file explorer for an image or photo and select it. The new avatar will be shown to all members of the conversation.

Click the avatar again to change or remove the image.

Chat title

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

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.

Chat mode

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

• Normal
  Allow to send messages enabled
  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.
   
• Broadcast
  Allow to send messages disabled
  The Broadcast mode will only allow chat administrators to compose and send messages / attachments to the chat. This mode is very useful for sharing announcements or briefings in your organisation.
   

Media overview

Select Media overview from the chat menu. It allows you to look up for all attachments that have been shared in the current chat. The media is filtered by its file type, but can also be viewed unfiltered via All.

Alerts, announcements and notes

Select Alerts, Announcements or Notes from the chat menu. You will find a summary of all attention messages that have been shared in the current chat.

Chat administrators

Select Admins from the chat menu. This section lists all administrators of the current chat.

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.

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

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 or lists, or by a mix of all options mentioned.

Promote to admin

Select Members from the chat menu to see a complete list of the current chat's participants. If the chat was created via circle, click on its name to view the list of members. Move your cursor at the user of concern and click on the    icon to open the context menu. Select Make chat admin.

Demote admin

The admin promotion cannot be revoked.

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.

Members

Select Members from the chat menu. This section lists all members of the current chat incl. chat administrators.

If the chat was created by adding a circle, its name will be shown. The members of the circle can be viewed by clicking the circle name.

Add more members

In order to add further members to the chat, select Add colleagues to chat in 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 clicking OK.

Remove members

Move your cursor at the user of concern and click on the    icon to open the context menu. 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.

Chat administration

In the chat menu, you will find multiple options to manage the current conversation, like muting, archiving, leaving or closing the chat.

Archive chat

This is a personal setting and will only affect your own user account.

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.

There are two options to archive a chat

• Open the respective chat and select the Archive option from the menu    in the right upper corner of the screen.
• In your inbox, perform a right click on the respective chat to open the context menu and select Archive.
   

To display archived chats in your inbox, make use of the app's menu bar (or use the menu    next to your name and avatar) and select Teamwire > Chat > Show archived chats. The archived chats now become visible in your inbox. You are able to unarchive a conversation again in the same way as you have archived them.

Mute chat

This is a personal setting and will only affect your own user account.

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.

There are two options to mute a chat

• Open the respective chat and select the Mute option from the menu    in the right upper corner of the screen.
• In your inbox, perform a right click on the respective chat to open the context menu and select Mute.
   

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

Close chat

This is an administrative setting and will affect all members of the chat. Only chat administrators can close a chat.

Close a chat when the conversation is over and no longer needed.
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.

There are two options to close a chat

• Open the respective chat and select the Close chat option from the menu    in the right upper corner of the screen.
• In your inbox, perform a right click on the respective chat to open the context menu and select Close Chat.
   

If you are a chat admin, you can right-click the chat in your inbox to Reopen it. This option is also available in the chat view.

Leave chat

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

There are two options to leave a chat

• Open the respective chat and select the Leave chat option from the menu    in the right upper corner of the screen.
• In your inbox, perform a right click on the respective chat to open the context menu and select Leave Chat.

Save chat history

To save the content of a chat in a PDF file, make use of the app's menu bar (or use the menu    next to your name and avatar) and select Teamwire > Chat > Save as PDF. In the following mask, define the period to be saved. Click again on Save as PDF and select a destination using your file explorer.

Please note that some attachments may not be listed in PDF format.