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.)