Setting the SIP URI Content

Last Updated : Sep 16, 2022 |

Each SIP line in the system has a Call Details form which can contains SIP URI entries. They set which headers are used and how the header data is populated or the values against which headers are matched.

Every incoming and outgoing call which uses the line is matched to one of these.

Display

As above, the line URI associated with the call also sets the display name source for any headers that require it, for example the From and To headers.

Setting

Description

Auto

The system automatically determines the appropriate value to use. It will use external numbers if forwarding incoming calls, and internal numbers for calls made by a local user.

  • On incoming calls, if the Local URI is set to Auto, the system looks for matches against extension numbers and system short codes.

  • On outgoing calls, it allows short code manipulation of the caller number and name. For example: S to explicitly set the caller number, W to set withheld, A to allow (override any previous withhold setting), Z to set the caller name.

Use Internal Data

Use the SIP settings of the user (User > SIP), group (Group > SIP) or voicemail services (System > Voicemail > SIP) making or receiving the call:

  • Use the SIP Display Name (Alias) setting.

  • If the Anonymous is selected, use that value instead.

Manual Entry (Explicit)

If required, you can type in a value. This is only used for fields configured as Explicit. This is typically used to set the DDI to be associated with SIP line appearances.

Credential Values

If a set of SIP Credentials has been selected in the URI settings, then the User name, Authentication Name or Contact values from the SIP credentials can be selected as values.

Content

On both incoming and outgoing SIP calls, the system associates one of the SIP line's URI entries with the call. The settings of that URI specify how the system should populate and use the content part of the SIP URI in various header. The possible settings are:

Setting

Description

Auto

If Auto is selected, the system automatically determines the appropriate value to use. It uses external numbers when forwarding incoming calls, and internal extension numbers for calls made by a local user.

  • On incoming calls, the system looks for matches against extension numbers and system short codes.

  • On outgoing calls, the system allows short code manipulation of the caller number and name. For example: S to explicitly set the caller number, W to set withheld, A to allow (override any previous withhold setting), Z to set the caller name.

Use Internal Data

Use the SIP settings of the user (User > SIP), group (Group > SIP) or voicemail services (System > Voicemail > SIP) making or receiving the call:

  • Use the SIP Display Name (Alias) setting.

  • If the Anonymous is selected, use that value instead.

Manual Entry

If required, you can manually type in a value to use. The value is then used by other fields configured as Explicit. This is typically used to set the DDI to be associated with SIP line appearances.

Credential Values

If a Credentials entry has been selected above, then the User name, Authentication Name and Contact values from the selected credentials entry can be selected as values. The value is then used by other fields configured as Explicit.

  • URI values should only be set using credentials when required by the line provider. For example, some line providers require the From header to always contains the credentials used for registration, whilst other headers are used to convey information about the caller ID.