From Kolmisoft Wiki

Jump to: navigation, search


[edit] Description

In the old PSTN world, Providers were called Trunks. Providers are your route out of your VoIP network to the outside world.

Providers can be one of several types: ZAP, SIP, IAX2, and H323. The type determines which technology is used to connect to the Provider.

At the very start, you need to create a Provider through which you will dial out to PSTN or other VoIP networks.

Every Provider will charge you for calling a destination through his service (although the rate might be zero). The rate to every destination is different. Because of this, we need to have a Tariff (or Price List) for each Provider. This Tariff will tell our billing what price we will pay to a destination when using this Provider's services. In other words, this will be our Selfcost.

[edit] Usage

Go to SETTINGS –> Billing –> Providers.


Here you can see a list of all Providers:


  • Click image:add.png New Provider to create new Provider, enter the Name for a new Provider, select its Technology, Tariff, Asterisk server which should be used for this provider and click Create.
  • Click image:icon_edit.png icon to change settings for old Provider.
  • Click Image:icon_check.png icon to disable Provider and it will not be used while it is cross in Active column. It affects only outgoing calls. Incoming calls from this provider will be accepted.
  • Click Image:icon_cross.png icon to enable Provider if you want to use it again.
  • Click Image:icon_vcard.png icon to access Provider Contact Info.


  • You can't create a new Provider if there are no Tariffs available for Providers.
  • A Provider is also able to send calls, not just receive them. More info here. In case you want to sell services to a provider you have to create such a provider.

[edit] Settings

[edit] General

File:Prov addon.png

  • Name – a name for the provider, for informational purposes.
  • Technology – out of SIP/IAX2/ZAP/H323, choose which technology your provider uses - that is, the way you connect to the provider.
  • Tariff – the list of rates the provider charges you.
  • DTMF Mode – the available options are inband, info, RFC2833, and auto. Choose the one used by your provider.
  • Location – which Localization rules are set to apply to INCOMING calls COMING FROM this provider.
  • Automatic Number Identification - used in a special case explained here: Provider with ANI
  • Ringing Timeout – this setting lets you set for how long this provider should be dialed before giving up. The default value is 60 seconds, and the minimum value is 30 seconds.
  • Call Timeout – this setting lets you set the duration of the whole call: ringing and the period after connection.
  • Device ID – informational data.
  • Call limit – explained here: Simultaneous call limitation.
  • Hidden?hide/unhide provider
  • Balance – provider balance. Provider balance increases when calls are made via that provider. Currently it is not available to decrease provider's balance. You can read more about Provider Billing Addon here.
  • Balance limit – this is the limit of balance that can be reached by the provider. After he reaches the specified balance, calls aren't sent through this provider anymore. Balance limit value of zero means that balance is unlimited.
  • Responsible Accountant – dropdown to choose Provider's responsible accountant.

[edit] Authentication

[edit] For ZAP providers

  • Channel – which channel (or channel group) to use on a PRI/BRI/PSTN card. Channels and groups should be configured in zapata.conf.

[edit] For SIP/IAX2 providers

  • Login – username if your provider asks for it.
  • Password – password used for authentication by your provider (characters @ : / are not allowed when Register option is enabled)
  • Authenticate by IP – just check the checkbox (Login/Password can be left empty).
    • Make sure you put the correct Hostname/IP address!
  • Register – should we register the provider? (option is not visible when Dynamic is selected in Network related section)
  • Register extension – if the provider asks to use an extension for registration (usually they don't), enter it here.

[edit] Provider CallerID

CallerID – consists of two parts: Name and Number. The "Number" part is transferred by default on all technologies (GSM, PSTN, SIP etc), but the "Name" part only on some. The number you see on your mobile phone when someone is calling you is the "Number" part.


  • Name – the "Name" part of CallerID.
  • Number – the "Number" part of CallerID.
  • Random Number from Number Pool – the "Number" part of CallerID selected from Number Pool

. NOTE: If you have this configured all incoming call from this provider will have that CallerID. If you leave these fields empty, calls coming from this provider will have CallerID set by the Provider. It should almost always be this way.

[edit] Network related

  • Hostname – hostname of the provider.
  • Server IP – the provider's IP. The value can be "dynamic", which means that provider can change its IP. To discover this value, do ping to the provider's hostname. Use command "dig +short". Example dig +short
  • Port – port used to connect to the provider (default: 5060 for SIP, 4569 for IAX2, 1720 for H323).

[edit] H323 specific network settings

  • Fast Start – an option specific to H323; it is either on or off.
  • h245 Tunneling – an option specific to H323; it is either on or of

[edit] SIP specific network settings

  • Media control – canreinvite/transfer. Do you want your server to stay in the media path between your clients and your provider? Disable if you have a lot of 1-second answered calls.
  • NAT – the available options are: yes, no, never, and route. For a detailed explanation of these settings, refer to here.

[edit] IAX2 specific network settings

  • IAX2 Trunking Mode – enable/disable trunking mode, which allows multiple voice streams to share a single "trunk" to another server, reducing overhead created by IP packets. More details here

[edit] SIP and IAX2 specific network settings

  • Qualify – how often to "ask" the provider about availability. More details here for SIP providers and here for IAX2 providers.

[edit] Blacklist/Whitelist


Enable static Source - enables a static Blacklist or a Whitelist.

  • No - use neither a Blacklist nor a Whitelist.
  • Blacklist - set a Number Pool which is used to block a Provider from receiving specific Source Numbers. When a Source Number (RPID and PAI headers included) is found within a selected Number Pool this Provider is skipped with a Hangupcause Code 272.
  • Whitelist - set a Number Pool which is used to allow a Provider to receive only specific Source numbers. When a Source Number (RPID and PAI headers included) is NOT found within a selected Number Pool this Provider is skipped with a Hangupcause Code 273.

[edit] Servers

Allows to select on which Asterisk servers this provider should be used.

[edit] Codecs

Choose the codecs your provider uses.

NOTE: When no fields are checked, all codecs are available. (Image:asterisk_icon.png For example, settings in sip.conf or iax.conf are effective).

[edit] Advanced

  • Grace time – if call duration is less than Grace Time, it will not be accounted.
  • Progressinband:
    • yes – when "RING" event is requested, always send 180 Ringing (if it hasn't been sent yet) followed by 183 Session Progress and in-band audio.
    • no – send 180 Ringing if 183 has not yet been sent, establishing an audio path. If the audio path is established already (with 183), then send in-band ringing (this is the way Asterisk historically behaved because of buggy phones like Polycom's).
    • never – whenever ringing occurs, send "180 ringing" as long as "200 OK" has not yet been sent. This is the default behavior of Asterisk.
  • Video support – does your provider support Video over IP? More info here.
  • Allow duplicate calls – the default setting is "no".
  • Interpret NO ANSWER as FAILED – default option is no (This will change the provider in LCR like it is failed, in last calls you will see

the real hangupcause – no answer)

  • Interpret BUSY as FAILED – default option is no (This will change the provider in LCR like it is failed, in last calls you will see

the real hangupcause – busy)

  • Fake Ring – should system generate Fake Ring or not? Use only if your Device/Provider has bad protocol implementation and does not send RING signal properly.
  • Common Use – Provider can be used by Resellers which are able to create their own Providers. Reseller will be billed using this Provider. If provider is marked as common use and is used in one of reseller's LCR or is in Terminators list - admin is not allowed to delete this provider or remove common use option.
  • Anti-resale (Auto-answer) – when option is set to YES, MOR answers the call before sending it to provider in order to generate FAS. Work only when provider is the originator of the call. This option does not affect the billing.
  • Transport – lets you choose protocol [tcp, udp] for data transfer. Appears only if Provider is SIP and when Asterisk 1.8 is enabled. Default value: udp. If TCP is used, it has to be enabled in Asterisk.
  • Time limit per day - Total time available for provider per day. When limit is reached another provider in LCR is used (total time is calculated after rounding rules and minimal time adjustment, so if your provider tariff has increment higher than 1 or minimal time set, then total provider time may be different than actual call time).
  • Limit up to X, during Y seconds – you can set limit how many calls (X) can be done in some interval of seconds (Y). Last Calls will show FAILED(243).
  • Enforce same codec as on Leg A - this option takes effect only when Device/Provider is used as Terminator. When this option is enabled, system checks what codec is used on Leg A. Then if Leg A codec matches one of codec enabled on Codecs list, system enforces callee to use that codec, by offering only that single codec in SDP data.
  • Execute AGI script - Execute custom AGI script. More info here.

[edit] SIP Specific

  • Fromusermore details
  • Fromdomainmore details
  • Trustrpid – This defines whether or not Remote-Party-ID is trusted. It's defined in
  • Sendrpid – defines whether a Remote-Party-ID SIP header should be sent. It defaults to "No". This field is often used by wholesale VoIP providers to provide calling party identity regardless of the privacy settings (the From SIP header).
  • Insecuremore details
  • T.38 Support – should we support T.38 pass-through?
  • SIP Session Timers - SIP Session Timers provide an end-to-end keep-alive mechanism for active SIP sessions (more info here). Possible values are "accept", "originate", "refuse":
    • originate - request and run session-timers always.
    • accept - run session-timers only when requested by other UA.
    • refuse - do not run session timers in any case.
  • SIP Session Refresher - The session refresher (uac|uas). Defaults to 'uas'.
    • uac - default to the caller initially refreshing when possible.
    • uas - default to the callee initially refreshing when possible.
  • SIP Session Expires - maximum session refresh interval in seconds. Defaults to 1800 secs.
  • SIP Min Session - minimum session refresh interval in seconds. Defaults to 90 secs.
  • SIP 302 Reinvite Support – turns this SIP feature on or off.
  • P-Asserted-Identity usage – The P-Asserted-Identity header field can be used to convey the proven identity of the originator of a request within a trusted network. If pass_pai =0 in Mor.conf and PAI usage in provider settings =1, then core will add PAI header.
  • Periodic check - if enabled, periodic SIP OPTIONS requests will be sent to Provider to check if it is reachable. If Periodic Check is enabled and Provider does not respond to OPTIONS request then Provider will be marked as unreachable and will be skipped when making Calls. Once Provider starts to respond to OPTIONS request it will be marked as reachable and Calls will be routed through this Provider. Providers are checked every 5 minutes. Options packets are sent from IP address defined in /etc/asterisk/sip.conf
  • Enable MNP tags - adds MNP tags in SIP INVITE requests (if MNP is configured).
  • Custom SIP Header - adds custom header to SIP request. Format is header: value (for example x-My-Custom-Header: my value)
  • Custom Destination Header - allows to read Destination number from specific SIP header (for example x-DID: 123) instead of SIP URI.
  • Privacy CallerID - allows to change CallerID (From: <sip:xxxxxx@yyyyyyy>) when originator sends Privacy: id. If originator does not send Privacy: id or Privacy CallerID is empty, then SIP From header will not be modified.
  • Privacy From Domain - allows to change Domain (From: <sip:xxxxxx@yyyyyyy>) when originator sends Privacy: id. If originator does not send Privacy: id or Privacy From Domain is empty, then SIP From header will not be modified.
  • Playback before dial - allows to play selected sound file to originator before dialing to Provider. Select 'none' to disable this feature.
  • Playback before dial mode - controls how Playback before dial handles media.
    • Early media - uses 183 Session Progress to send audio to originator. This is preferred way of sending media to originator since it does not require legA call to be answered. One drawback is that not all providers resend SIP 183 early media correctly. In those cases originator will hear silence.
    • Answer and play - if this mode is selected, then MOR will answer legA and play media to originator. This way originator should always hear media but there are various drawbacks since legA is already answered. One of drawbacks is that MOR will generate false answer if Provider rejects call. Use this mode only if you know what you are doing.

[edit] VIDEO: How to create Provider

[edit] See also

Personal tools


Try M2