«trueconf:» Protocol Designed to Interact with TrueConf Client Applications

Konstantin Olmezov
August 20, 2018
Konstantin Olmezov
Categories: Knowledge Base

TrueConf client applications support special trueconf: protocol that operates at the system level and allows you to manage calls and other functions using short commands that can be placed in a browser link or button, run in a console, or inserted into a script.

trueconf: protocol is supported in v. 7+ client applications, but for TrueConf Client 6.x.x, it provides only the most basic functions.

The previous protocol name — visicall: — is currently obsolete; new applications may not support this version, and we do not recommend using it.

This article describes the main protocol features and showcase its uses. For clarity, we’ve only shown how to use it as a link in a browser.

Format of Access to «trueconf:» Protocol

All possible trueconf: protocol calls can be described as follows:

trueconf:[target]@[server]&[param_1]=[value_1]&[…]&[param_n]=[value_n]

Where:

  • [target] is a user login, conference id, RTSP link for connection, etc. We’ll further call this parameter an addressee;
  • [TrueConfServer] is an IP address or FQDN to which a call should be made. We’ll further call this parameter a server;
  • [param_n] is a name of an additional parameter;
  • [value_n] is a value of an additional parameter.

Protocol Actions

Function Call Format and Examples Version 6.X Version 7.X
Launch and Authorization
Application launch trueconf:
Authorization  trueconf:login=[login]&password=[password]&encrypt=1

trueconf:login=user&password=pswd&encrypt=1

Authorization on another server  trueconf:h=[TrueConfServer]&login=[login]&password=[password]&encrypt=1

trueconf:h=192.168.12.123&login=user&password=pswd&encrypt=1

Calling User
Call within a server trueconf:[user]

trueconf:john

You can use any call string instead of server user name. For example:
Call to another server trueconf:[user]@[TrueConfServer]

trueconf:john@conf.company.com

Join an RTSP broadcast trueconf:#[rstp_address]
use %2f instead of /

trueconf:#rtsp:%2f%2fdomainn.company.com:554

Joining Conference
Joining a conference with ID [CID]  trueconf:[CID]&conftype=multi

trueconf:4154248070&conftype=multi

trueconf:\c\[CID]

trueconf:\c\4154248070

Call to a conference where [user] is a host  trueconf:[user]&conftype=hotquery

trueconf:john&conftype=hotquery

Other Functions
Close an application after end of call/conference Add &autoclose=1 to the end of any command

trueconf:john&autoclose=1

User authorization and call to a conference or another user can be combined in one command:

trueconf:\c\4154248070&login=user&password=pswd&encrypt=1

How to Change Default Application

At times, two TrueConf client applications are installed on the user’s computer at the same time: classic (TrueConf Client) and new (TrueConf for Windows), but commands controlled by trueconf: protocol are still forwarded to an obsolete version of an application.

This means that TrueConf Client was installed later than TrueConf for Windows, as trueconf: protocol commands are forwarded to the latest installed (or updated) version of an application.

As already mentioned above, trueconf: protocol is intended for use in TrueConf for Windows, and it is desirable that commands are forwarded to this client application. To do this, download and install it again (it is not necessary to delete it before this.)

Sign up for newsletter