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