Walkthrough: Adjusting the App with the App Configuration

Using Threema Work’s management cockpit, you can easily manage your subscriptions and users.

As an administrator with a “Professional” subscription, the management cockpit allows you to:

• Create quotations and access orders and invoices
• Increase the number of users and renew subscriptions
• Upgrade existing subscriptions and purchase new ones
• Manage the app’s contact list
• Send automated messages to the entire organization with Threema Broadcast
• Configure the app for all or individual users
• Manage users’ app access
• Manage users’ Threema IDs
• Set an in-app logo
• View app usage statistics
• Request technical support

In addition, “Professional” customers can manage users and subscriptions via API.

Purchase additional licenses for external or temporary employees joining your team. You can integrate them in an existing subscription or keep them in a separate subscription.

Assigning these users a tag, e.g. “temporary”, helps you to keep track of these licenses.

Once the project is finished, you can withdraw their access to the Threema Work app and/or prevent the use of their Threema ID, thereby excluding them permanently from internal communication. Learn more

With the following configuration settings, users of a subscription can only communicate with other users of the same subscription or with contacts that were added in the management cockpit. The communication with external contacts is inhibited.

Hint: If you use Threema Broadcast, you can use this communication principle also for your Broadcast ID (“Availablility: Internal only”).

When deleting users, questions appear that help you to take the right steps, especially when handling staff changes:

“Can this user continue to use their ID?”

Answer “No” if the employee is leaving the company or is no longer allowed to send or receive messages with their Threema ID. This is also useful if a user has accidentally created multiple IDs. (This answer corresponds to the former option “Revoke ID.”)

Please note:

• Revoking an ID cannot be undone.
• As a Threema Work administrator, you can revoke a user’s Threema ID even if they have set an ID revocation password.
• It might take up to one hour for a revocation to take effect. After a Threema ID has been revoked, it will be displayed striked-through in contact lists of other users within 24 hours. If the option “hide inactive contacts” is enabled, the ID disappears entirely.

If you answer “Yes”, a follow-up question will appear in which you can specifiy where the user may continue to use their ID. If the ID is used again in conjunction with a license of this subscription, it will remain in the contact list of active users.

“Is the user allowed to continue opening/using the app?”

Answer “No” if the user has lost their device, for example, or if you want to make sure that they can no longer access any chats or make calls. (This answer corresponds to the former option “Delete credentials.”)

To integrate Threema Work into your central directory service (such as MS Exchange, AD, or LDAP), please use our APIs:

• Threema Work API
• Broadcast API

Different ways of integrating Threema Work into your central directory service are illustrated below.

In-app contact list

The Threema Work app can optionally synchronize its contact list with the address book of the mobile device. If the address book is linked to your central directory service (e.g., MS Exchange, AD, or LDAP), the contacts are mapped automatically to the appropriate Threema IDs, and contacts who use Threema appear in the app’s contact list. Learn here how to label internal contacts.

If you disable contact synchronization on the mobile devices, you can still add contacts via the management cockpit. The Threema Work API allows to automate the process of adding contacts to the management cockpit.

User management

Using the Threema Work API, you can automate administration and user management. Any management task that can be completed using the management cockpit can be completed using the API, for example:

• Add, edit, and delete users
• Manage the app’s contact list
• Configure the app (e.g., prevent video calls or block unkown contacts)

Broadcast: Groups, feeds, and distribution lists

Threema Broadcast is the perfect tool for efficient top-down communication. Using the Broadcast API, you can dispatch messages and manage feeds, distribution lists, and groups. Integrating Threema Broadcast into your directory service (e.g., MS Exchange, AD, or LDAP) is quite easy.

Threema Work users’ contact lists can be managed as follows:

Mark internal contacts

The colored dots next to a contact indicate the verification level. Users of the same subscription and added external contacts can be marked with the blue verification level. Navigate to “User management > Settings > Mark internal contacts” to (de)activate the blue verification level.

Automatically display new users in the app contact list

Newly added users can be displayed by default in the app contact list of all users by checking the box under “User management > Settings > Automatically display new users in the app contact list.”

For users and contacts, you can see whether they are part of the app contact list by checking the “In contact list” column. You can find this information in the overview of the user management and in the detail view of a user or contact in the “User details” section. Once added, you can no longer remove an external contact from the app contact list.

Corporate directory

For large organizations comprising of several hundred or even thousands of members, making all contacts available (s. above) inevitably leads to an overwhelmingly long contact list. Here’s where the “corporate directory” comes into play. It allows users to quickly look up other members of the same organization or subscription group right in the app. Add to that the ability to query all members of a given department using tags (and the wildcard search).

Setting up the “company directory” is simple and straightforward; please refer to the dedicated step-by-step guide for details.

Good to know: If the company directory is active but should not be available in the app to certain users, set the “th_disable_work_directory” configuration setting in the app configuration to “On” and “true” for these users. This way, they won’t be able to access the company directory.

Restrict communication to internal contacts (Closed user group)

Using the following configuration settings, users of a subscription can only communicate with other users of the same subscription or with contacts that were added manually in the management cockpit (see “Make contacts available” above). The communication with external contacts is disabled.

The “subscription group” feature allows you to share the company directory across several subscriptions and thus search contacts in all of the subscriptions that belong to the same group. To use the feature, at least two subscriptions of the Professional and/or Education price plan have to be grouped, and the company directory needs to be activated.

If you want to allow your users to search contacts across several subscriptions , please proceed as follows:

1. Log into your Threema Work admin account.
2. Activate the company directory in the subscriptions you want to group: navigate to “User management > Settings” and check the box next to “Activate company directory.”
3. In the “Subscriptions” overview, tap on the “Create new subscription group” button.
4. Define a name for your subscription group.
5. Drag and drop the required subscriptions into the subscription group.

If the company directory should not be available in the app for certain users, adjust the corresponding configuration setting in the app configuration in the management cockpit as described here under “Company directory.”

Good to know: contacts that have been found and added to the local address book via the company directory are labeled with two blue dots as an internal contact.

The tilde character (~) in front of a contact name indicates that the name displayed is a nickname (e.g. “~Bob”). A user can choose any nickname, and it might not correspond to the actual name of said user (e.g. “Robert Smith”).

In the following cases, the tilde is not displayed:

• You define the first and last name of users using your administrator privileges (via configuration settings or in the contact list that you provide through the management cockpit).
• Contact synchronization is enabled, and the ID matches an email address and/or telephone number of a contact stored in the local address book. In this case, the contact list will show the name stored in the local address book instead of the nickname.
• The user entered the name manually in the contact details in the app. In this case, the contact’s name is displayed, not the nickname.

Contact list in the app

It can take up to 24 hours until new users are visible or contact changes become effective in the app’s contact list. However, the synchronization can be forced manually in the app by pulling down the contact list.

Contact list in the management cockpit

The management cockpit and Threema’s directory server sync once per hour. Therefore, it can take up to one hour until new users are visible in the management cockpit’s “Contacts”.

Company logo

Increase your employees’ identification with the app by placing your company logo in the app’s header.

Internal support form

Define how your users get first-level support by integrating an URL for your internal support into the app.

As a subscription’s administrator, you can add additional administrators and define the scope of their access privileges.

In the management cockpit, navigate to “Access privileges”. First, click on “Add user” to add a user. Then, set the user’s access privileges by ticking the appropriate checkboxes.

Additionally protect access to your management cockpit with two-factor authentication using Threema or another service of your choice.

1. Log in at https://work.threema.ch/en/login.
2. In the menu, select “Profile”, and click on “Login and security”.
3. Follow the instructions.
4. Store the backup codes you obtain after completing the setup. Using these codes, you are able to sign in if you should ever lose your mobile device.

Firewall settings can prevent the Threema Work app from establishing a connection to the Threema server, or they might block access to the management cockpit. To resolve this issue, please open the appropriate TCP ports.

Threema Work app: TCP ports 443 and 5222 need to be open for outgoing connections. Messages are transmitted through port 5222; port 443 serves as fallback in case of delays. For directory queries (synchronization of contacts, etc.) and media transmissions, HTTPS port 443 is used.

Threema calls: UDP port 3478 needs to be open for outgoing connections.

Threema group calls: UDP ports 22500–22532 need to be open for outgoing connections.

Management cockpit: TCP port 443 needs to be open for outgoing HTTPS connections.

If you experience connectivity issues with the desktop app or the web client, please refer to this FAQ article.

Threema Work offers several backup options that differ in various respects:

	ID export	Data backup	System backup	Threema Safe
Configuration Setting	th_disable_id_export	th_disable_data_backups	th_disable_system_backups	Documentation
OS	Android, iOS	Android	iOS	Android, iOS
Threema ID
Chats, including media files
Contacts, group memberships, and app settings
Can be managed by admins		With external MDM system	With external MDM system
Can be created by users
Storage location	File or email	File	iTunes or iCloud	Threema / Custom server
Storage duration	Custom	Custom	Custom	180 days / Custom

By default, all backup options are available. Use configuration settings to restrict some or completely disable all backup options:

Don’t allow any kind of backup

To prevent your users from creating any kind of backup, use th_disable_backups. (This configuration setting overrides all configuration settings listed below.)

Prevent ID exports

To prevent your users from exporting their Threema ID, set the parameter th_disable_id_export totrue.

Prevent data backups (Android)

In Threema Work for Android, users can create data backups. To prevent this, set the configuration setting th_disable_data_backups, to true.

Prevent inclusion in OS backups (iOS)

iTunes backups can include Threema data. Set th_disable_data_backups to true to exclude Threema data from OS backups. Due to a restriction on iOS’ part, it’s not possible to distinguish between iTunes and iCloud backups.

Threema Safe

Set the configuration setting th_safe_enable to false to prevent users from creating Threema Safe backups. To learn more about the configuration of Threema Safe using configuration settings, please refer to this Help article.

You can use configuration settings to define which backup options are (not) available to your users. By default, all backup options are available.

Do not allow any backups at all

To prevent your users from creating any kind of backup, use th_disable_backups . (This configuration settings overrides all settings listed below.)

Prevent ID export

To prevent your users from exporting their Threema ID, set the configuration setting th_disable_id_export to true.

Prevent data backups (Android)

In Threema Work for Android, users can create data backups. To prevent this, set the configuration setting th_disable_data_backups to true.

Prevent inclusion in OS backups (iOS)

iCloud/iTunes backups can include Threema data. Set th_disable_system_backups to true to exclude Threema data from OS backups.

Threema Safe

Set the configuration setting th_safe_enable to false to prevent users from creating Threema Safe backups. To learn more about the configuration of Threema Safe using configuration settings, please refer to this Help article.

User management in management cockpit

The following browsers are supported (on any operating system): Mozilla Firefox, Google Chrome, Chromium, Opera, and Safari. No other browsers are supported.

App use on mobile device (smartphone or tablet)

Other operating systems are not supported.