>

 

Documentation

Incoming Calls from PSTN

Incoming DID Calls (from PSTN)

Incoming DID Calls (from VoIP Vendor)

Create a Vendor Tariff for Incoming DID Costs

Enter Rates

Create a DID Supplier Vendor

Define Connections

Create a Customer Tariff to Charge Your Subscribers

Enter Rates

Modify Rating List for a Product

Create Accounts

 

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 PortaBilling Web Reference Guide PDF file for detailed instructions on how to navigate and operate the web interface, as well as for detailed explanations of particular fields.

 

Incoming DID Calls (from PSTN)

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 “VoIP from Vendor” connection, as explained in the next chapter.

Incoming DID Calls (from VoIP Vendor)

Checklist

Print the following page and use it to check off operations you have completed while performing the system setup according to the instructions in this chapter. Please make sure that you perform all of the operations in the order designated (all of the boxes should be checked), otherwise the service will not work.

 

Adobe SystemsThe checklist below assumes that you have already configured the basic SIP service according to the instructions provided in the earlier chapter.

 

 

Operation

 

Done

Rating configuration (Vendor)

 

Create a tariff A, which describes the costs of incoming DIDs from this DID provider (it should not be of the Routing type).

[     ]

Enter rates in tariff A for the incoming DID range.

[     ]

Create a vendor for the DID supplier.

[     ]

Create a “VoIP from Vendor” connection for this vendor using tariff A.

[     ]

Rating configuration (Customer)

 

Create a tariff B, which will be applied to SIP subscribers for their incoming calls.

[     ]

Enter rates in tariff B for the destinations covering your incoming DID range, i.e. the rates you plan to charge your customers.

[     ]

Create a new rating entry in your SIP product, using the PortaSIP node, tariff B and the access code INCOMING.

[     ]

Account provisioning

 

Check that the retail SIP service customer is already created according to the instructions in the Basic SIP Service chapter of the Basic Residential VoIP Service section.

[     ]

Create a new account for this customer, with the account ID identical to the SIP phone number (DID).

[     ]

Testing

 

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

[     ]

Initial Configuration of PortaSwitch®

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

Create a Vendor Tariff for Incoming DID Costs

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.      In the Rating section of the Admin-Index page, choose Tariffs.

2.      On the Tariff Management page, choose  Add.

3.      Fill in the Add Tariff form (please refer to the Basic SIP Service chapter of the Basic Residential VoIP Service section for a detailed description of the available tariff attributes). In the Applied To select menu choose Vendor then clear the check-box Routing, since no routing is actually done for this vendor, i.e. the vendor will be sending calls to your network.

4.      Click  Save.

Enter Rates

Enter the rates applied to you by the DID provider.

 

 

1.      On the Tariff Management page you will see a list of the available tariffs. Click the  Rates icon previous to the name of the tariff.

2.      On the Edit Rates screen, click  Add.

3.      Fill in the required information regarding the costs of incoming DID calls; please refer to the Basic SIP Service chapter of the Basic Residential VoIP Service section for a detailed description of the available rate attributes.

4.      Click the  Save button in the toolbar, or the  icon on the left end of the row.

5.      Repeat these steps if you need to enter more rates.

Uploading a Rate List from a File

Please consult the instructions provided in the Rate Import section and PortaBilling Templates Guide for more information regarding this.

Create a DID Supplier Vendor

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 Participants section of the admin interface, choose Vendors.

2.      On the Vendor Management page, choose  Add.

 

 

3.      Fill in the Add Vendor form. Please refer to the instructions provided in the Basic SIP Service chapter of Basic Residential VoIP Service section for a detailed description.

4.      Click  Save.

Define Connections

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.      In the Participants section of the admin interface, choose Vendors.

2.      Click on the Connections icon next to the vendor name. 

 

 

 

 

 

 

3.      Press  Add to add a new connection.

4.      Fill in the connection information:

o       Choose Calls to Vendor via SIP as the Type of connection and your PortaSIP® node as the Node, then select the tariff which defines your incoming DID costs for this vendor.

o       For VoIP connections where authorization between you and the vendor is done using a SIP username and password, select the corresponding record in the Vendor Authorization menu.

o       In RTP Proxying, specify this vendor’s capabilities regarding NAT traversal (if you are not sure whether this vendor can do NAT traversal, select On Nat).

o       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 in the Assign Access Code field. This allows the appropriate entry specified in the product’s Services and Rating tab to be selected.

      For example, the default value for a “Calls to Vendor via SIP” 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'.

o       Specify Description and Capacity as they are mandatory for all connection types.

5.      Click  Save.

Create a Customer Tariff to Charge Your Subscribers

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

 

 

 

1.      In the Rating section of the Admin-Index page, choose Tariffs.

2.      On the Tariff Management page, choose  Add.

3.      Fill in the Add Tariff form:

o       Name – A short name for the tariff object; this is the name you will see in the select menus.

o       Currency – Indicates the currency in which you charge your customers.

NOTE: The currency for the tariff may be chosen only once, and cannot be changed later.

o       Applied To – Choose Customer here, since this tariff will be applied to your subscribers.

o       Managed By – Choose “Administrator Only” here (this option is only visible after you select Applied to: Customer above).

o       Service – Choose Voice Calls here.

o       Default Off-peak Period – If you do not differentiate between peak and off-peak rates, just choose Not defined; otherwise, select one of the previously defined off-peak periods.

o       Destination Group Set – If you wish to enter rates in the tariff not for every individual prefix, but for a whole group of prefixes at once, you should create a destination group set and destination groups beforehand. Leave this select menu empty for now.

o       Round Charged Amount – Instead of calculating xDRs with a 5-decimal-place precision, round up xDR amount values (e.g. to cents, so that 1.16730 becomes 1.17). Set the rounding pattern to XXXX.XX000 (as shown on the picture) so every call will be rounded to the equal cent amount.

o       Default Formula – Default rating formula, which will be applied to every rate created in the tariff. If you leave this empty, the “old-style” rating will be used.

o       Short Description – A short tariff description. This will be shown in the rate lookup on the admin interface and the self-care pages for your accounts and customers.

o       Description – An extended tariff description.

4.      Click  Save.

Enter Rates

 

 

1.      On the Tariff Management page you will see a list of the available tariffs. Click the  Rates icon previous to the name of the tariff.

2.      On the Edit Rates screen, click  Add.

3.      Fill in the required information regarding the costs of incoming DID calls; please refer to the Enter Rates chapter of the Basic Residential VoIP Service section for a detailed description of the available rate attributes.

4.      Click the  Save button in the toolbar, or the  icon on the left end of the row.

5.      Repeat these steps if you need to enter more rates.

 

Adobe SystemsAdobe SystemsIf you provide free incoming calls to all (or a majority of) destinations instead of creating zero cost rates for multiple destinations, you can simply create a single rate for a special INCOMING destination.

This rate will be applied to any incoming call to any incoming number.

 

Modify Rating List for a Product

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

 

 

 

 

1.      In the Rating section of the Admin-Index page, choose Products.

2.      Click on the product name to enter the Edit Product screen.

3.      After selecting the Services and Rating tab, click the  Add icon.

4.      Choose Voice Calls in the Service select menu.

5.      In the Node select menu select the PortaSIP®.

6.      Type INCOMING in the Access Code column.

7.      Service Allowed to Suspended Users – This parameter allows / disallows end users to use certain services when their accounts are suspended:

·         None – No services are provided to suspended users;

·         Only Zero Charged Services – Allows your customers to continue using free services during suspension.

8.      Info Digits do not apply to this type of service (i.e. you do not differentiate between calls your customers receive from fixed or mobile networks). Therefore, just leave this field empty.

9.      In the Tariff menu, select the tariff which applies to your customers for receiving incoming calls.

10.  Click  Save&Close to save this rating entry.

Create Accounts

1.      Go to the Customers screen (the one containing a list of customers). It should resemble the screenshot below:

 

 

 

2.      Next to the customer name, click the  icon (the one in the Accounts column) to go to account management for that customer.

3.      Click on  Add.

4.      In this example, we assume that you are creating accounts manually, so choose Manually from the drop-down menu (do not use any of the Quick Form options).

 

  

 

 

5.      Fill in the Add Account form:

o       Account ID – SIP ID, i.e. the phone number which will be used to login to the SIP server and receive incoming calls.

o       Blocked – You may create the account as blocked, although this is rarely done with SIP service accounts.

o       Opening Balance – The initial balance on the account.

Account Info tab

o       Type – Select the type of credit being used for the postpaid services.

o       Credit Limit – For a credit account, specify the credit limit. If you leave this field empty, it means there is no credit limit for this account (but a customer credit limit may still apply).

o       Adobe SystemsService 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.

o       E-mail – Enter the account owner’s email address here. If he ever forgets his password for the web self-care pages, the password may be reset, and a new one will be sent to this email address. You can also just leave this field empty.

o       Batch – A batch is typically used to manage large quantities of one customer’s accounts, so for incoming calls from PSTN you can leave it empty – in other words, the account created will not be tied to any specific batch.

Products

o       Main Product – choose the main product, which you would like your account to have.

Web Self-Care tab

o       Login – Account login to web self-care pages. Can be the same as account ID.

o       Password – Password for the web self-care pages.

o       Time Zone – The time zone for the account self-care interface.

o       Web Interface Language – The language to be used on the account self-care web interface.

Additional Info tab

o       IP Device, IP Device Port – Leave these fields empty for now and use manual provisioning instead. SIP phone auto-provisioning is described in the Setting up Auto-provisioning of IP Phones chapter of the Auto-provisioning of IP Phones section.

Life Cycle tab

o       Start Using – The date from which the account is usable.

o       Expiration Date – Account expiration date; since we are setting up a postpaid service, which should function for a long time, leave this field blank.

o       Life Time – Relative expiration date; since we are setting up a postpaid service, which should function for a long time, leave this field blank.

Service Configuration tab

Using this tab, you can activate / deactivate various features of the services provided to this account. Note that features are defined per service type (the physical service provided to the user such as Conferencing, Data Service, Voice Calls, Messaging etc.)

 

Please consult the PortaBilling Web Reference Guide for a description of parameters available here. For now you may leave these with their default values.

 

6.      After clicking  Save&Close, you will see a confirmation screen announcing that a new account has been created.