Incoming calls from DID provider (manual configuration)

This chapter demonstrates how to set up the PSTN-to-SIP service so that your customers will be able to receive calls on their SIP phones when someone dials their number from a fixed-line or mobile phone.

Please refer to the UI help for detailed instructions on how to navigate and operate the web interface, as well as for detailed explanations of particular fields.

If you receive calls from your vendor via a PRI interface (E1/T1), you will need to send them to a VoIP gateway (such as Cisco or Quintum) and then forward them to PortaSIP.

The simplest and the most efficient way to set this up is to not define this gateway as your node. Instead, simply describe it as a “From vendor” connection, as explained in the next chapter.

1. Initial configuration of PortaBilling
2. Create a vendor tariff for incoming DID costs
3. Enter rates
4. Create a DID supplier vendor
5. Define connections
6. Create a customer tariff to charge your subscribers
7. Enter rates
8. Modify rating list for a product
9. Create accounts
10. Testing

If you have just installed the PortaBilling software or dedicated a new billing environment to configure the services described in this handbook, make sure to first perform the initial configuration of PortaBilling. To do this, use the Initial configuration of PortaBilling handbook.

A tariff is a single price list for calling services; in this case, for calculating how much your DID provider will charge you for delivering incoming calls to your network.

1. On the navigation menu on the left, select Service catalog > Tariffs and click + Tariff.
2. On the Add tariff panel, fill in the tariff details:
   • Name – a short name for the tariff object; this is the name you will see in the select menus.
   • Currency – indicates the currency in which the vendor charges you.
     The currency for the tariff may be chosen only once, and cannot be changed later.
   • Service – select Voice calls.
   • Applied to – select Vendor.
   • Routing – leave the Routing disabled, since no routing actually takes place for this vendor, i.e., the vendor will be sending calls to your network.
   • Define prices – select per individual rate code.
   • Code group set – select None.

     

3. Click Save.

1. On the vendor tariff’s panel, click Rates and enter the rates applied to you by the DID provider. Please refer to the Basic Residential VoIP Service handbook for a detailed description of the available rate attributes.

   

2. Click Save.
3. Repeat these steps if you need to enter more rates.

Please consult the instructions provided in the Rate Import section for more information regarding this.

This entity is required in order to keep track of your incoming DID expenses, and also to provide an adequate level of security on your network. Since every incoming call to your network must be authorized, you can create an account under the vendor which will be used for such authorization.

1. In the left upper corner click to open the navigation menu.
2. On the navigation menu, select Infrastructure, then select Vendors.
3. On the Create vendor panel, fill in the vendor details. Please refer to the instructions provided in the Basic Residential VoIP Service handbook for a detailed description.

   

4. Click Save.

Connections represent the points from which calls leave or enter a network. They are directed to or from vendors where charges are incurred. In this case, a connection represents the point where calls enter your network via the PSTN gateway.

1. On your vendor’s panel (DID Supplier), navigate to Connections and click Add.
2. On the Create connection panel, fill in the connection details:
   • Description – type a descriptive name for this connection. It will be displayed in the list of connections.
   • Service type – select Voice calls.
   • Type of connections  – select SIP.
   • Direction – select From vendor.
   • Tariff – choose the tariff that defines your termination costs for this connection/vendor.
   • Active – use a slider to set this connection as active.
   • Node – select PortaSIP.
   • Service and rating access code – if you would like to use different rate plans for the same service based on where the call comes from, specify the corresponding access code. This allows the appropriate entry specified on the product’s Usage charges panel to be selected. For example, the default value for a “From vendor” connection (applied to calls to the PortaSIP server arriving from outside your network and terminated to one of your SIP phones) should be set to 'INCOMING'.
   • Capacity – specify the Capacity value for this connection.
   • Remote IP – enter the address of the vendor’s gateway.
   • Vendor authorization – select the corresponding record for VoIP connections where authorization between you and the vendor is done using a SIP username and password.

     

3. Click Save.

The tariff is a single price list for calling services; in this case, for your customers’ incoming calls.

1. On the navigation menu, select Service catalog > Tariffs and click + Tariff.
2. On the Add tariff panel, fill in the tariff details:
   • Name – type a short name for the tariff object; this is the name you will see in the select menus, (for example, SIP Subscribers - Incoming).
   • Currency – this indicates the currency in which you charge your customers. Note that the currency for the tariff is chosen only once, and cannot be changed later.
   • Service – select Voice calls.
   • Applied to – select Customer as this tariff will be used to charge your customers.
   • Managed by – select Administrator only here, since we are setting up a service without the involvement of resellers.
   • Define prices – select per individual rate code.
   • Code group set – select None.

     

3. Click Save.

1. On your customer tariff’s panel (SIP Subscribers - Incoming), go to Rates and click + Rate.
2. On the Add rate panel, fill in the required information regarding the costs of incoming DID calls; please refer to the Enter Rates section of the Basic Residential VoIP Service handbook for a detailed description of the available rate attributes.

   

3. Click Save.
4. Repeat these steps if you need to enter more rates.

 If you provide free incoming calls to all (or a majority of) destinations, instead of creating zero cost rates for multiple rate codes, you can simply create a single rate for a special “|” (pipe) rate code. If the tariff doesn’t specify otherwise, this rate will be applied to any incoming call and to any incoming number.

Now you must specify when the tariff you have created to charge your customers for incoming calls will actually be applied to them.

1. On the navigation menu, select Service catalog and click Products.
2. Go to the needed product, open the Usage charges panel and click Add.
3. Fill in the required information:
   • Service – select Voice Calls.
   • Node – select the PortaSIP node.
   • Access code – type in INCOMING here.
   • Tariff – choose the tariff that will be used to calculate the charges for incoming calls.
   • Overdraft protection – to configure overdraft protection for this product, consult the Configure Overdraft Protection Section within the Product section in the Overdraft Protection Configuration handbook.
4. Click Save.

Check that the retail SIP service customer is already created according to the instructions in the Basic Residential VoIP Service handbook. Create a new account for this customer, with the account ID identical to the SIP phone number (DID):

1. On your customer’s panel, navigate to Accounts / DIDs and click + Account.
2. On the Add account panel, specify the account’s details on the General tab:
   • Type – select Credit for the postpaid services.
   • Account role – select Phone line.
   • ID – click DID to select a DID number from the available DID numbers list.

     

   • On the Assign DID panel that opens, specify whether to search through unallocated DIDs or among the DIDs assigned to this customer. You can also specify the geographical location and DID number pattern (e.g., specify 44 to search for DIDs with the prefix 44). Click Next.

     

   • On the Assign DIDs panel, you will see a list of available DID numbers that match your search query and the charges associated with them. The charges for DIDs from the DID pool are pre-populated from the customer’s pricing batch. Select a DID number and click Assign.

     

   • Once a DID number has been assigned, continue filling in the details on the Add Account panel:
     • Service password – together with the account ID, this password will be used to authenticate registrations and call attempts on the SIP server. It is very important to assign a secure (difficult to guess) password to prevent the account from being wrongfully entered and used to inject fraudulent calls to your network.
     • Balance control – define the way the balance of the account is controlled. Select Subordinate in this field.
       • Subordinate – the balance will directly depend on the customer’s balance (only the customer tops up the balance);
       • Individual credit limit – this account may have its own balance and credit limit (the customer credit limit still applies).
     • Activation date – choose the date from which the account is usable. By default, the account is activated immediately upon creation.
     • Expiration date – this identifies the date when the account expires. Since we are setting up a postpaid service, which should function for a long time, set this option to Never.

       

   • Contact info tab:
     • Here you can fill in the account owner’s email address in the Email field. If the account owner ever forgets the password for the web self-care pages, they will be able to reset it, and a new password will be sent to this email address.
   • Additional tab:
     • Here you can enable Auto-provisioning and assign a device to the account. Leave this option disabled for now.
   • Products tab:
     • Select the main product in the Product field.

       

   • Web self-care tab:
     • Login – specify the account login for the self-care web interface. It can be the same as account ID.
     • Password – generate a password for the self-care web interface.
     • Role  – select Account.
     • Time zone – select a time zone for the account self-care web interface.
     • Web interface language – select a language to be used on the account self-care web interface.
3. Click Save.
4. Open the account’s panel and navigate to Service configuration.

   On this panel, you can activate/deactivate various features of the services provided to this account.

   For now, you may leave these with their default values.

5. Click Save.

When accounts with DID numbers are created, the DIDs are added to a customer’s pricing batch.

Program the parameters (phone #, password and SIP server address) into the SIP phone and make a test call.