SIP/Telephony

Some sections are described in more detail here. For the other sections consult the sample configuration.

Account options

The SIP account is configured in the section account0. Most options are passed through to PJSIP and are documented in the sample configuration. The following options are worth a closer look:

Example 1. 01-sip-base.conf
[account0]
userUri=sip:user@example.org
registrarUri=sip:example.org
registrationTimeout=60
publishEnabled=true
realTimeText=false
registrationTimeout

The registration timeout in seconds. You might need to lower this value, e.g. if a stateful firewall drops idle connections early. If not set or 0, the PJSIP default is used.

publishEnabled

Whether GOnnect publishes its own presence state via SIP PUBLISH. Disable this if your PBX does not support it. (optional, default: true)

realTimeText

Enables Real-Time Text (RTT, RFC 4103) in calls. (optional, default: false; in GOnnect 2.4 the default was true)

Togglers

Togglers can be used to change the state of a configuration in your PBX by sending a special sequence or to show the state of a certain configuration setting.

The section name starts with toggler_ postfixed with a number.

Example 2. 20-toggler.conf
[toggler_0]
account=account0
label=Transfer call if no SIP client is connected (CFNC)
description=A really good toggler :-)
subscribe=sip:*2%CFG[generic/number]%@example.org
toggle=sip:*2@example.org
display=statusbar
account

The SIP account to use. Usually "account0"

label

The text, which is shown in the UI

description

A description of the toggler (currently not used)

subscribe

A SIP-URI to subscribe for the toggler state

toggle

A SIP-URI to dial to toggle the state

display

Where should the toggler be shown?

  • menu - The toggler is shown in the hamburger menu

  • tray - The toggler is shown as entry in the tray menu

  • statusbar - The toggler is shown in the status bar of the main window

  • settings-phoning - the toggler is shown on the settings page in the phoning section

Emergency

GOnnect is able to show an Emergency call button in the main bar. If you press the button, a page with configurable entries shows up.

The section name starts with emergency_ postfixed with a number.

Example 3. 50-emergency.conf
[emergency_0]
number=0112
displayName=Feuerwehr / Krankenwagen

[emergency_1]
number=0110
displayName=Polizei

[emergency_2]
number=911
displayName=Ersthelfer
number

The number to dial

displayName

The title of the button

The button is only visible if at least one emergency number is configured. To hide it although emergency numbers are configured, set showEmergencyButton in the generic section to false:

Example 4. 50-emergency.conf
[generic]
# optional, default: true
showEmergencyButton=false