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.
Table of Contents
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.)