This page describes how to receive calls to public numbers on the system from outside sources. For example a PSTN number could be forwarded to the system by a SIP origination provider.

Choosing a system dial plan

An important decision to make early on when setting up the system is what system dial plan to use. There are dial plans available for each country (in the two letter format, e.g. "us" for the United States or "uk" for the United Kingdom), "nanp" for the North America Numbering Plan, and "e164" for the E.164 international number format. Here are some factors to consider when choosing which to use:

• Will the system have customers in one country or multiple countries.
• All calls to the system from an outside source (e.g. from the PSTN, not those from telephones registered with the system) must have the calling and called numbers provided in the system dial plan format. If using a SIP origination provider you should ask them what number format they send.
• All publicly reachable (e.g. PSTN) numbers configured on the system must be in the system dial plan format.
• All system routes must be in the system dial plan format. The only exception is a route with no prefix (to match any number called) as previously configured.

1. Using the top-right selection box ensure you're working as the system level user, not a sub-customer.
2. Click on Global » Settings » Configuration.
3. Click on "System dial plan".
4. Enter the system dial plan, for example "us", "uk" or "e164" (without the quotes).
5. Save the setting.

Configuring an inbound group

An inbound group is a set of numbers that are billed at the same rate, and normally have the same area code.

This example assumes you have a public telephone number which is routed to the system's SIP proxy address.

1. Click on Global » Routing » Inbound groups.
2. Click on "New" in the bottom-right corner and you'll get a form for this inbound group's details to be entered. Most settings do not need changed.
3. The "Name" field can be anything you like, but often the area code of numbers contained within that inbound group is used, so enter the area code of a public number you own and are going to use for testing.
4. Save the inbound group.
5. Click on the "Add numbers to this group" link.
6. In the "Numbers" field enter your public number, remembering that all numbers entered must be in the system dial plan format. For example, if the system dialplan is "us" and your number is in New York you might enter the number starting with "212". If the system dial plan is "e164" and your number is in London you might enter the number starting with "4420".
7. In the "Assign to customer" field select the end-user your test telephone line is in.
8. Add the number.
9. Click on the "Continue editing the group" link.
10. At the bottom of the edit inbound group page click on the "Inbound call costs" link.
11. You'll see a default cost of 0.00 has been set for calls to numbers in this inbound group. Click on the "Default" time to edit the cost.
12. In the "Cost per minute once billing starts" field enter "0.30". Your rate plans set markups so the actual cost to sub-customers will be higher.
13. Save the cost.

Configuring the number

You've now added the number to the system and assigned it to a customer, but not yet told it where to send calls which arrive at this number.

1. Using the top-right selection box switch to your end-user customer.
2. Click on Devices and numbers » Numbers » Numbers.
3. Click on the number you added above and you'll get a form for this number's details to be entered. Most settings do not need changed.
4. Scroll down to the "Route calls to" section. For the "Default destination" field select "Telephone line" and then your test telephone.
5. Save the number.
6. Using a PSTN phone call your public number and the call should be routed to the telephone selected above.
7. If the call to the number does not work have a look at taking traces. Taking an ngrep trace on the SIP proxy server should quickly show you if the call is arriving at the system, and taking a trace using Billing and analysis » Analysis » Traces will give you a detailed record of what happened within the system.
8. Click on Calls and messages » Calls » Call history to view the calls received and what was charged.
9. Remember that back when you set up the rate plans markups of 100% and 50% were applied, resulting in a price three times the system level. So although the price is 0.30 per minute in the inbound group costs, the reseller customer should be charged 0.60 per minute, and the end-user customer 0.90 per minute.