Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • SIP Provider Name. Create a name to refer to this provider. This is only used for referring to this Provider in other areas of the Admin Suite.

  • Your Account ID. Enter the account ID provided to you by your SIP provider. This may also be called Login, or Authentication ID.

  • Your Password. Enter the password for the account.

  • Hostname/IP Address. Enter the hostname or IP address for the SIP server provided to you by your SIP provider. This may also be called Registrar Server.

  • Callback Extension. Enter the extension to ring when a voice call comes in over this provider or channel. Callback extensions can be any extension type (your receptionist’s phone, an IVR, etc.).

  • Default Fax Extension. Enter the extension to ring when a call comes in over this provider or channel and is identified as a fax. (Switchvox only identifies T.38 faxes over SIP providers. A fax coming in over an IAX provider or a channel, or a fax using a different standard may not be identified as a fax.) You must install a fax license and the fax software to make faxing available. (For details, see the “Digium Addon Products” article.)

  • DTMF Mode. DTMF tones are the sounds emitted when you press buttons on your phone. Options in the dropdown include: RFC4733, Info, and Inband.

    • SIP extensions, refer to your phone's user manual for the DTMF mode that your phone uses.

    • SIP providers, ask your provider which DTMF mode it supports.

...

The Connection settings determine how the connection is established with this provider.

...

  • SIP Port. This is the UDP port used to communicate with this SIP Provider. By default this is set to 5060, the standard port for SIP communication. This port can bechanged if your provider or peer requires it.

  • SIP Expiry. This controls the duration (in seconds) between SIP registration requests sent to your provider. Selecting a value other than 120 may cause problems with NAT routers. Do not change this unless explicitly instructed by your provider.

  • Proxy Host. If your SIP provider says you need to use a SIP proxy, enter the proxy host IP here.

  • Authentication User. If your SIP provider says you need a different authentication name than your account name, enter that authentication name here.

  • Always Trust this Provider. Most providers require this option be set to Yes. It is a little less secure because it does not require authentication on incoming calls from this provider. If you set this to No and it does not work properly, set it back to Yes.

...

The Fax settings determine how faxes are handled with this provider. You must install a fax license and the fax software to make faxing available.  (For details, see the “Digium Addon Products” article.)

...

Info

IMPORTANT: We recommend that you only send T.38 faxes over SIP. We do not recommend sending faxes over IAX connections. Switchvox cannot necessarily recognize a fax over an IAX connection.

...

The following are the Provider Information fields:

...

  • IAX Provider Name. Any string to identify this VoIP provider. This is only used for referring to this VoIP Provider in other areas of the Admin Suite.

  • IAX Provider Label. Label this provider gives itself when placing calls to your system. This is usually the name inside of [ ] brackets in Asterisk configuration examples.

  • Your Account ID. Username provided by IAX Provider to authenticate your Switchvox PBX to the provider during IAX registration and outbound calls.

  • Your Password. Your password for the account.

  • Hostname/IP Address. Primary hostname or IP address of your provider's IAX

  • Server. This hostname will be used to send registration requests. It will also be the host that will send any inbound calls to your PBX. If your provider has multiple servers for their IAX service, you can use the Primary, Secondary, and Tertiary Outbound Host settings to list them. Otherwise, the Hostname/ IP Address field will be used for placing outbound calls as well as inbound calls and registration requests.

  • Callback Extension. The extension to ring when a voice call comes in over this provider or channel. Callback extensions can be any extension type (your receptionist’s phone, an IVR, etc.).

  • Incoming Authentication Type. Select one of these choices from the dropdown: MD5, plaintext, and RSA. MD5 and plain text use your password for authentication. It is preferable to use the MD5 method over the plain text method. RSA uses public and private encryption keys to authenticate the provider. If you select this option, enter the public RSA key in the RSA Authentication Key field.

  • RSA Authentication Key. Select from the dropdown of available keys, or from your computer hard drive.

...

The Peer Settings determine the relationship with this provider.

...

  • Registration Type. This setting controls registration between this Switchvox and the remote host. Provider is the default setting where this Switchvox sends registration to the remote host. Client is the setting where the remote host is the client and it sends registration requests to this Switchvox. Peer is the setting for peered hosts that do not need to register. If you choose Peer, make sure that both hosts have static IP addresses.

  • Host is a Switchvox PBX. If this VOIP Provider is a peered Switchvox, set this to Yes. This lets you use advanced functionality with the peered Switchvox.

  • Treat system’s users like local users. If you want Switchvox to exchange presence and line-use information with this peered Switchvox, set this option to Yes.

  • Jabber Hostname. You can specify a hostname for the peered Switchvox’s Jabber server. To find this hostname, look in the peered server's Network Settings page. This is important if you are peering Switchvoxes and want to use functions such as Presence or the Chat Panel.

  • Apply Incoming Call Rules to Provider. This option lets you alter the routing of incoming calls. Yes is the default setting. It uses the rules on the Incoming Calls section as well as the Callback Extension to decide which extension to ring when you receive a call over this provider. Select No if this provider is a peer. This allows callers from this peer to directly dial any extension in Switchvox. Incoming calls will not follow the rules in the Incoming Calls section and they will not ring the Callback Extension.

  • Outgoing Call Rules. If the Apply Incoming Call Rules to Provider option is No, use this section to define how the remote peer can place outbound calls through this PBX. Use the check boxes to assign which outgoing rules apply to this peer. Check the Allow box to apply the rule to this peer's inbound calls. Check Deny to block all calls that match that rule, such as blocking all long-distance numbers. To bypass a rule, leave both options unchecked. See the “Outgoing Calls” article for more information about each outgoing rule.

Caller ID Settings

...

  • Caller ID Name / Caller ID Number. Enter a name and phone number to display as your Caller ID when making outbound calls with this provider.

...

The Connection settings determine how the connection is established with this provider.

...

  • Primary, Secondary, Tertiary Outbound Hosts. Some IAX providers use different hosts for registration, incoming, and outgoing calls. If your provider has multiple hosts for placing outbound calls, you can use the Primary, Secondary, and Tertiary Outbound Host fields to specify them. If these are left blank, the PBX will use the host specified in the Hostname/IP Address field for outgoing calls.

  • Incoming Password. If this provider uses passwords for incoming call authentication and the password is different from your account password, specify it here. This condition is rare unless you are peering with a remote host and have explicitly configured the inbound and outbound passwords to be different.

  • Qualify Hosts. Enabling this option will periodically send IAX POKE packets to the remote host and time their response. This latency measurement can then be seen in the System Status page.

  • Enable Trunking. Trunking can be used to reduce the bandwidth used across multiple simultaneous calls; however, it must be enabled on both sides of the link. This is useful when you have two systems peered together over IAX with heavy voice traffic. If using commercial IAX services, check with the provider to see if it supports trunking. Enabling trunking on only one host will result in one-way audio on phone calls. Use RSA Authentication for Outgoing. Before setting this option, place your public RSA key on the remote host. You can retrieve this system's public RSA key in System Setup> VOIP Providers.

...

The Call settings determine how to manage calls with this provider.

...

  • Audio Codecs. Some providers support more than the normal audio codecs. These additional codecs may provide compression or other features that save bandwidth or lead to better call quality. However, you should check with your provider before selecting another codec, to be sure it is supported. If your Switchvox is a peer with another Switchvox, you can choose any audio codec. The table in the SIP Providers section describes the audio codecs. If you entered a license key for the G729 Codec in Tools > Digium Addon Products, you will also see G729 in the list of codecs.

...

The Fax settings determine how faxes are handled with this provider. You must install a fax license and the fax software to make faxing available. (For details, see the “Digium Addon Products” article.)

...

Note

IMPORTANT: We recommend that you only send T.38 faxes over SIP. We do not recommend sending faxes over IAX connections. Switchvox cannot necessarily recognize a fax over an IAX connection.

...