Message: response / clientInfo (app -> client)

Back to overview

Return information about the app's device.

This message MUST be sent by the app in case the device information has been requested by the client.

Acknowledgement

This message acknowledges:

Message Condition Error Codes
request/clientInfo (client -> app)

(None)

Name Description
internalError

An internal error occurred

Args

None

Data

Field Description Type Optional Nullable
device

The device name

String False False
os

The operating system

Allowed values: "android", "ios"

String False False
osVersion

The operating system version (e.g. "5.1")

String False False
appVersion

The app version (e.g. "4.0.1")

String True False
isWork

Whether the app is the work variant of Threema

Boolean False False
pushToken

The GCM / APNS push token
For APNS, this is the 32 byte hex-encoded device token, followed by the endpoint (either p or s) and the bundle id, separated by semicolons.

String True False
configuration

The device configuration

Map<Configuration> False False
capabilities

The device capabilities

Map<Capabilities> False False

Models

Configuration

Field Description Type Optional Nullable Default
voipEnabled

Whether calls are enabled

Boolean True False True
voipForceTurn

Force all VoIP traffic to go through the TURN server

Boolean True False False
largeSingleEmoji

Show single emoji with a larger font size

Boolean True False True
showInactiveIDs

Whether to show inactive contacts in the contact list

Boolean True False True

Capabilities

Field Description Type Optional Nullable Default
maxGroupSize

The maximum supported group size

Integer True False 50
maxFileSize

The maximum file size when sending files

Integer True False 52428800
maxMessageBodySize

The maximum message body size (in bytes) that can be sent to the Threema server

Integer True False 3500
distributionLists

Whether distribution lists are supported by the device

Boolean True False True
recurrentPushes

Whether this device supports grouping Threema Web pushes by affiliation ID

Boolean True False False
quotesV2

Whether this device supports sending quotes v2 (with a message ID) for file and media messages.

Boolean True False False
imageFormat

The image format used

Map<ImageFormat> False False
mdm

MDM configuration

Map<MdmRestrictions> True False

ImageFormat

Field Description Type Optional Nullable Default
avatar

The avatar mime type, for example "image/png"

String False False
thumbnail

The thumbnail mime type, for example "image/jpeg"

String False False

MdmRestrictions

Field Description Type Optional Nullable Default
disableAddContact

Set to true to disable adding of new contacts

Boolean True False False
disableCreateGroup

Set to true to disable the creation of groups

Boolean True False False
disableSaveToGallery

Set to true to make it harder to download media (hide download button)

Boolean True False False
disableExport

Set to true to disable exporting of chats

Boolean True False False
disableMessagePreview

Set to true to disable message contents in desktop notifications

Boolean True False False
disableCalls

Set to true to disable VoIP calls

Boolean True False False
readonlyProfile

Set to true if editing the profile is disabled by an MDM setting

Boolean True False False