App configuration

Threema Work allows to remotely edit app settings. You can control the app’s configuration, disable specific features, and the end user is relieved from setting up the app manually.

Configuration via MDM software

On Android and iOS, apps can be installed in a Managed Profile to separate personal and professional use. Apps that are installed this way can be remotely configured using an MDM system.

Threema Work supports the following platforms and profile types:
Platform System requirement Supported profile type
Android Android 5.0+ Android Enterprise / Managed Configurations
iOS iOS 7+ Managed App Configuration
Windows Phone WP 8.1+ Configuration using URL actions (Windows Phone)

To ensure compatibility, please contact the developer of your MDM system.

To learn more about rollout and deployment, please consult the documentation.

Configuration via management cockpit (Threema MDM)

If you don’t use an MDM system for the app’s deployment, Threema MDM is a convenient way of controlling the app’s settings in the management cockpit. With Threema MDM, the same parameters that are available when using a regular MDM system can be configured.

Configuration parameters

Name
Type
Min
Max
OS
Renewable1
User-editable2
Default value
Threema MDM
th_license_username
Username required to activate the app
Type
string
Min
1
Max
255
OS
All
Renewable1
No
User-editable2
No
Default value
-
Threema MDM
No
th_license_password
Password required to activate the app
Type
string
Min
1
Max
-
OS
All
Renewable1
No
User-editable2
No
Default value
-
Threema MDM
No
th_nickname
The nickname appears in the contact details (as well as in push notifications).
Type
string
Min
0
Max
32
OS
All
Renewable1
No
User-editable2
Yes
Default value
-
Threema MDM
Yes
th_firstname
First name of the user; visible in Work cockpit and API.
Type
string
Min
-
Max
255
OS
Android (3.43k), iOS (3.0.9k), WP (2.3.0k)
Renewable1
Yes
User-editable2
Yes
Default value
-
Threema MDM
Yes
th_lastname
Last name of the user; visible in Work cockpit and API.
Type
string
Min
-
Max
255
OS
Android (3.43k), iOS (3.0.9k), WP (2.3.0k)
Renewable1
Yes
User-editable2
Yes
Default value
-
Threema MDM
Yes
th_csi
CSI (Customer Specific Identifier) can be any value (e.g., an internal employee reference); this value is only visible in the management cockpit, not in the app.
Type
string
Min
-
Max
255
OS
Android (3.43k), iOS (3.0.9k), WP (2.3.0k)
Renewable1
Yes
User-editable2
Yes
Default value
-
Threema MDM
Yes
th_category
User category (e.g. group, department); visible in Work cockpit and API.
Type
string
Min
-
Max
255
OS
Android (3.43k), iOS (3.0.9k), WP (2.3.0k)
Renewable1
Yes
User-editable2
Yes
Default value
-
Threema MDM
Yes
th_linked_email
The email address linked to a Threema ID is used for contact synchronization.
Type
string
Min
-
Max
-
OS
All
Renewable1
No
User-editable2
Yes
Default value
-
Threema MDM
Yes
th_linked_phone
The phone number linked to a Threema ID is used for contact synchronization; it must be specified in international format, e.g., +41555114900.
Type
string
Min
-
Max
-
OS
All
Renewable1
No
User-editable2
Yes
Default value
-
Threema MDM
Yes
th_id_backup
This parameter is used to pass precalculated key pairs (Threema IDs) and restore ID backups.
Type
string
Min
99
Max
99
OS
All
Renewable1
No
User-editable2
No
Default value
-
Threema MDM
Yes
th_id_backup_password
Password for ID backup in th_id_backup
Type
string
Min
8
Max
-
OS
All
Renewable1
No
User-editable2
No
Default value
-
Threema MDM
Yes
th_safe_enable
If set to true, Threema Safe must be used; if set to false, Threema Safe cannot be used. (If not set at all, Threema Safe can be used.)
Type
bool
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Yes
User-editable2
No
Default value
-
Threema MDM
Yes
th_safe_password
Password to encrypt (or restore, cf. th_safe_restore_id ) Threema Safe backup (not available in Threema MDM)
Type
string
Min
8
Max
4096
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Yes
User-editable2
No
Default value
-
Threema MDM
No
th_safe_server_url
URL for custom Threema Safe server, e.g., examplecompany.com/threemasafe
Type
string
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Yes
User-editable2
No
Default value
-
Threema MDM
Yes
th_safe_server_username
Username for HTTPS authentication of Threema Safe server defined in th_safe_server_url (if required)
Type
string
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Yes
User-editable2
No
Default value
-
Threema MDM
Yes
th_safe_server_password
Password for HTTPS authentication of Threema Safe server defined in th_safe_server_url (if required)
Type
string
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Yes
User-editable2
No
Default value
-
Threema MDM
Yes
th_safe_restore_enable
If set to false, Threema Safe backups cannot be restored. If set to true, restoring a Threema Safe backup in the setup wizard is either optional (if th_safe_restore_id is not set) or mandatory (if th_safe_restore_id is set).
Type
bool
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
No
User-editable2
No
Default value
-
Threema MDM
Yes
th_safe_restore_id
Threema ID to restore from Threema Safe if th_safe_restore_enable is true
Type
string
Min
8
Max
8
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
No
User-editable2
No
Default value
-
Threema MDM
Yes
th_contact_sync
If set to true, synchronization with the local address book is enabled.
Type
bool
Min
-
Max
-
OS
All
Renewable1
No
User-editable2
Yes
Default value
false
Threema MDM
Yes
th_readonly_profile
If set to true, the user cannot change the following profile settings: nickname, profile picture, email address / phone number linked to the ID, contact synchronization, export ID, delete ID, ID revocation password. The use of Threema Safe and the export of the Threema ID can be prevented using the parameters th_safe_enable and th_disable_id_export, respectively.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_block_unknown
If set to true, unknown contacts (i.e., contacts not contained in the device's address book) are blocked.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_screenshots
If set to true, the user cannot take screenshots on Android, and no thumbnail is displayed in Android’s app switcher.
Type
bool
Min
-
Max
-
OS
Android, WP
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_add_contact
If set to true, the user cannot manually add contacts. Contacts can only be added via contact synchronization (if not disabled; see th_contact_sync) or by receiving messages from unknown contacts (if not disabled; see th_block_unknown).
Type
bool
Min
-
Max
-
OS
Android (2.82k), iOS (2.7.3k), WP
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_export
If set to true, the user cannot export chats.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_backups
If set to true, the user cannot create any kind of backup. This parameter overrides th_safe_enable, th_disable_data_backups, th_disable_system_backups and th_disable_id_export.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_id_exportNew
If set to true, the user cannot export their ID.
Type
bool
Min
-
Max
-
OS
Android (3.7k), iOS (4.2.1k)
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_data_backupsNew
If set to true, the user cannot create data backups (only available on Android).
Type
bool
Min
-
Max
-
OS
Android (3.7k)
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_system_backupsNew
If set to true, Threema data is excluded from iTunes/iCloud backups. Not relevant for Android.
Type
bool
Min
-
Max
-
OS
iOS (4.2.1k)
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_message_preview
If set to true, the message preview in push notifications is disabled.
Type
bool
Min
-
Max
-
OS
Android (3.02k), iOS (2.9.1k)
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_send_profile_picture
If set to true, the user’s profile picture will not be shared with others.
Type
bool
Min
-
Max
-
OS
Android (3.14k), iOS (2.10.1k)
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_calls
If set to true, Threema calls are disabled.
Type
bool
Min
-
Max
-
OS
Android (3.2k), iOS (3.0k)
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_skip_wizard
If set to true, the setup wizard that would show up on the first app launch is skipped.
Type
bool
Min
-
Max
-
OS
Android (3.2k), iOS (3.0.6k), WP (2.1.0k)
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_create_group
If set to true, the user cannot create groups.
Type
bool
Min
-
Max
-
OS
Android (3.3k), iOS (3.0.4k), WP (2.2.0k)
Renewable1
Yes
User-editable2
No
Default value
false
Threema MDM
Yes
th_disable_web
If set to true, Threema Web is disabled.
Type
bool
Min
-
Max
-
OS
Android (3.551k), iOS (4.0.3k)
Renewable1
Yes
User-editable2
No
Default value
-
Threema MDM
Yes