Telephony > Softphones

Configure Softphone global parameters and individual Softphone parameters. Click Edit to change the Softphone settings.

Note: Softphone configuration is only available if the design running on the Q-SYS Core contains one or more Softphones.

Prerequisites

Use the Q-SYS Softphone to connect to VoIP (Voice over IP) telephone systems, including IP-PBX and SIP-based devices (for example, Cisco CUCM and FreeSwitch). The Softphones page facilitates registration with these systems. Before configuring the Softphone:

Tip: You can also use the Softphone component in unregistered mode, which allows making ad-hoc IP-to-IP calls (for example, Core-to-Core) and connecting to other non-registered SIP-compatible equipment.

Shared Settings

These settings apply to all Softphones.

Core Interface

Select the LAN interface to use for all SIP traffic, which must have a route to the SIP device to which you want to connect.

SIP Port

This is the listening (source) UDP port of Q-SYS Softphones. The default is 5060. See SIP Port Restrictions. (Outbound calls always use port 5060.)

Logging

Select to enable SIP logging. This log can be used by Q-SYS Support to troubleshoot problems you may be experiencing.

SRTP

Select to enable the SRTP (Secure RTP) protocol, which encrypts the RTP voice / media payload. Some phone systems may require SRTP – for example, Avaya IP Office.

DTMF INFO

Select to enable DTMF to be sent as SIP INFO requests. When enabled, DTMF is not sent via RFC 2833.

RFC2833 DTMF Type

This number is the 'RTP Event' Payload Type Number that indicates that the transmitted packet contains DTMF digits. The default is 101, but you can enter any number from 96 to 127. On the remote SIP device, RX and TX DTMF Payload Types must match this value.

Note: Some SIP devices can specify separate RX and TX DTMF Payload Types and some, such as Q-SYS, cannot. On systems that cannot have separate values, RX and TX DTMF Payload Types must both match this value.

STUN

Select to enable the STUN (Session Traversal Utilities for NAT) feature, which allows you to communicate with a cloud-based PBX. STUN is a protocol that finds the public IP of a service (Q-SYS) that is behind a firewall or network address translator. A STUN packet is sent to a publicly accessible STUN server, which responds with the public-to-private IP address. Once Q-SYS receives the public address, it uses that address to communicate with a cloud-based PBX.

Note: If you enable STUN, all Softphones in your Q-SYS design use STUN.

STUN Server (Optional)

If STUN is enabled, Q-SYS uses STUN server stun.freeswitch.org by default, but you can specify a different server here. A listing of free STUN servers is available via the internet.

Hold

Some phone systems do not properly re-enable call audio after taking a call off hold. This can be due to changes in the RTP port used during the connection. Deselect this option to allow compatibility with these phone systems. This option is enabled by default.

Insecure Ciphers

You might need to enable this option for compatibility with VoIP services that still use deprecated (and insecure) ciphers. This option is disabled by default for new designs in Q-SYS 9.1.0 and later. To maintain compatibility with existing systems, it is enabled by default when upgrading from Q-SYS 9.0.1 and earlier.

Note: If Access Control is enabled on the Core, changing this setting requires Technician-level access or higher.

Domain Based Calling

Select whether to enforce using a domain name for SIP authentication – as specified in the Domain field for each Softphone – instead of the Proxy IP address. For many cloud-based PBX services, this is useful for white-listing a single domain name instead of multiple proxy IP addresses. This option is disabled by default.

Note: Domain Based Calling is required by NuWave, Momentum Telecom, and Zoom.

Audio Codecs

Select all supported audio codec types to be available for use and order them by preference of connection. Click and drag a codec to change the connection order.

Softphones List

This list contains all Softphone components from your design inventory. Select a Softphone to change its settings.

Username

This is the number or name you use to call the Softphone. For Softphones registered to a SIP or IP-PBX, the provider supplies this name (typically an extension number), along with a Password. For unregistered Softphones, the Username can be anything – for example, the local portion of an email address (before the @ sign).

CID Name

(Optional) This is the name to use for caller ID.

Transport

Select the transport protocol - UDP, TCP, or TLS.

Note: Q-SYS supports TLS version 1.2. TLS (Transport Layer Security) is a protocol that runs over TCP and provides end-to-end security for SIP signaling by encrypting SIP messages that are exchanged between Q-SYS SIP Softphones and far end SIP endpoints or PBXs.

Proxy

The destination IP address (or hostname) and port number of the SIP provider, IP-PBX, or SIP gateway. For example, 192.168.1.205:15060.

Backup Proxy

(Optional) The IP address or resolvable name of the SIP provider, IP-PBX, or SIP gateway to use if a connection to the primary proxy cannot be established.

Register with Proxy

Select 'Yes' to register the Softphone with a proxy. Enter an Authentication ID and Password, both supplied by the SIP or IP-PBX provider.

Domain

Enter the Domain name of the PBX's network, if required. This field is required when the Domain Based Calling option is enabled in Shared Settings.

Registration Timeout

(Optional) Set the expiration interval, in seconds, for this registration at the VoIP PBX. The default is 3600 seconds (1 hour) if you leave this field blank or enter an invalid parameter. This is typically used on some cloud-based PBXs that use a smaller interval to keep firewalls open.