SIP Protocol Providers

The following table describes the settings for SIP Protocol Providers.

SIP Provider Details

Setting

Description

Name

Name of the service provider.

Description

Description of the provider.

Maximum Retries

Number of times to resend a notification before potentially using an alternate service provider; allowable values are from 0 to 10.

Retry Interval

Amount of time in seconds to wait between retries.

Use Device Engine Settings

When selected, the Protocol Provider uses the settings specified in the Inbound SIP Registration List on the SIP Device Engine Details page. Clear this checkbox to use specific settings for this Protocol Provider, as described in the following table, “SIP Provider - Inbound Registration settings”.

Note that AlarmPoint attempts to use the specified settings to send a notification once, and then attempts to use the settings specified in the SIP Device Engine details. These two attempts count as one “try” toward the maximum number of retries as specified above. If these attempts fail beyond the maximum number of retries, then AlarmPoint will attempt to use the next Protocol Provider specified in the User Service Provider, if available.

Call-out Script

Name of the script used to handle the outbound call.

Phone Class Details

Defines the Phone Class to use for this Protocol Provider. For more information about Phone Classes and a description of these settings, see Phone Class Resources.

Initial Silence

Maximum duration (in milliseconds) of silence before the greeting. If this duration is exceeded, then AlarmPoint treats the answerer as a machine.

Greeting

Maximum duration (in milliseconds) of the greeting phrase. If this duration is exceeded, then AlarmPoint treats the answerer as a machine.

After Greeting Silence

Maximum duration (in milliseconds) of the silence after detecting a greeting. If this duration is exceeded, then AlarmPoint treats the answerer as human.

Minimum Word Length

Minimum duration (in milliseconds) of voice to consider as a word.

Maximum Word Length

Maximum duration (in milliseconds) of voice to consider as a word.

Maximum Number of Words

Maximum number of words in a greeting. If this value is exceeded, then AlarmPoint treats the answerer as a machine.

Between Words Silence

Minimum duration (in milliseconds) of silence after a word to consider the audio that follows as a new word.

Silence Threshold

The threshold to use to determine silence on the line; larger values are less sensitive to static. If the amount of "noise" on the line is larger than this value, then the inbound is treated as a voice; otherwise, it is treated as silence. Valid values are from 0 to 65535; the default value is 256.

The silence threshold required for Protocol Providers may vary. Some phones attempt to amplify the speaker's voice, which can also amplify any ambient noise and make the default value of 256 too low. Other phones may be designed to suppress the noise, and unintentionally suppress the voice as well. To determine the appropriate value for phones in your system, you may need to enable detailed logging and experiment using different values.

Total Analysis Time

Maximum amount of time (in milliseconds) allowed for the algorithm to determine whether the answerer is HUMAN or MACHINE.

Phone Class Exceptions

Defines any Phone Class Exceptions for this Protocol Provider. For more information about Phone Class Exceptions, see Phone Class Resources.

The following table describes the settings for SIP Provider Inbound Registration.

SIP Provider - Inbound Registration settings

Setting

Description

SIP Server Address

IP address of the SIP server.

SIP Server Port

Port to use on the SIP server.

Local Port

Local port to which the Device Engine will bind and which the SIP Server will use to communicate with AlarmPoint.

SIP Domain

Domain used by the SIP server.

SIP Outbound Proxy Address

If required, the IP address of the outbound proxy server.

SIP Outbound Proxy Port

If required, the port of the outbound proxy server.

RTP Port (min)

The lower limit to the port number on which RTP is allowed.

RTP Port (max)

The upper limit to the port number on which RTP is allowed.

DTMF Payload ID

Number identifying the DMTF payload. The default value is 101, though some SIP Server environments may require a different value. Contact your SIP Server Administrator for more information.

Registration Attempts

How many times the Protocol Provider should attempt to register.

Registration Timeout

How long, in seconds, to wait before timing out on a registration attempt. The default is 60.

Session Timeout

How long, in seconds, to wait before timing out a SIP session. The default is 3600.

User Name

User name to use on the SIP server.

Password

Password, if required, for the user name on the SIP server.

Display Name

Name displayed as source of call.