SIP Softphone Lines
This chapter describes how to add and configure SIP softphone lines. The line can be used by the ProCall client to make phone calls via a SIP PBX by assigning the line number to a user.
Add and configure new lines
Click the Add Telephone System button on the Lines dialog and choose the desired system from the list of known telephone systems. Pressing Add calls up an SIP wizard which will guide you through the configuration. If you want to modify an existing line, you can right-click on the corresponding line or line group and modify Properties.
Configure the location settings in the Line Group
- Name of the Line Group
Choose a unique name as desired for the group of lines. If multiple telephone systems should be integrated into UCServer, a name that identifies the telephone system used will be helpful.
- Registrar/IP Address (of the PBX)
Please enter here the FQDN or the IP address of the PBX registrar. Enter the port number (typically e.g. 5060). The UCServer requires access via LAN using a local IP address of the PBX registrar. The registrar is also be used as proxy.
- Register expires
UCServer will send a SIP REGISTER notification to the telephone system so that the softphones will be made available for calls. If necessary, choose the time period that should be entered for cyclical SIP REGISTER notifications in accordance with RFC3261 using the Expires entry. The value should be equal or greater than the related configuration at the PBX registrar. A value too small may lead to registration problems. In case of the PBX registrar responds with a different value during the registration process, it is being used by the UCServer automatically.
- Register delay
UCServer can insert a delay between SIP REGISTER messages. This makes it possible, in large installations with many registrations, to avoid overloading the telephone system when starting UCServer. If necessary, deviate from the default value and select an appropriate value.
- NAT Refresh
The UCServer can send cyclical "NAT Refresh" messages to the SIP registrar, in case the SIP registrar is located behind a NAT Device. This is the case e.g. if a UCServer located in the internal LAN has to log on to an SIP registrar of a SIP provider in the public internet (WAN). In many cases, the time between two SIP registrations is sufficient (see menu item Reregister after) to keep the ports on the NAT open for incoming calls. Then cyclical NAT Refreshes can be deactivated by setting 0 s. However, if there is not enough time, a corresponding value may be selected. The value does not depend on the set SIP provider, but rather depends on the used NAT Device. This menu item is only available for specified telephone systems (e.g. SIP provider).
- User name(s)
Enter the user name for logging onto the SIP-Registrar. The user name will correspond to the phone number for the SIP softphone line. If multiple phone numbers that have the same password should be registered with the PBX, multiple phone numbers can also be defined (such as 123 or 100-120 or also 150;177;200-220).
If multiple phone numbers should be registered with the PBX that do not have the same password, activate the Configure Additional Softphones option. Doing so will list all registrations from that group of lines. The registrations can be changed, deleted or others added.
Enter the password for SIP authentication, if present.
- Auth. user name
If you have to configure an authentication user name please uncheck Take authentication user name from user name. Enter the value into the field Auth. user name. If you enter multiple numbers and these are a part of the authentication user name you may use the place holder <*>. At the appropriate place in the Authentication user name, <*> is replaced by the number entered in the User name field.
Line group name (defined under Registrar)
Activation of the SIP Softphone Lines
Once the SIP softphone line appears as a line in the group(s) of lines, the line can be activated by checking the left checkbox and clicking the Accept button at the top. A colorful icon symbolizes the line status or the success of the SIP registration with the telephone system. Green indicates successful registration. A mouse tooltip will provide additional indicators about the current status (such as Line is functional). To see the SIP notifications, the corresponding line can be right-clicked and Display SIP Events selected from the context menu to inspect them more precisely and track the SIP notifications in an event window. To reset the line (send a new SIP registration message), right-click on the corresponding line and re-start by selecting Reset Line on the context menu.
Once registration is successful (the icon is green), the line can be assigned to a User (see User Administration - Users). Right-clicking on the corresponding user and selecting Properties from the context menu will display the Telephone Numbers tab page where the line can be selected from the Business entry or the First Telephone entry using the button on the right. Alternatively, the number that corresponds to the line number can be entered manually.