Summary
This article will guide your through the process of configuring your VoicePulse FIVE account for Inbound calling. This article assumes that you have read and completed the steps in Getting Started 1: Initial Configuration and Outbound calling and have successfully created an Organization, Gateway, Endpoint, and Trunk as per that article. If you have not yet completed these steps please click the link above to complete them now.
Step 1: Add a Phone Number
From the left hand menu click "Phone Numbers". This will bring you to the Phone Numbers page as seen in the image below.
(Figure 1.a)
Click "Add Phone Number" button toward the top of the page. This will bring up the "Add a Phone Number" popup as seen below. Select a number from the list and click the "Add" button toward the top of the window. If you are done adding numbers (you can only add 1 number on a Trial account) click the x at the top right of the window to close the window. You should now see your phone number in the grid as in the image above.
(Figure 1.b)
You have now added the phone number to your account but you need to assign it to a Trunk that Allows Inbound Calling in order to activate the number and receive calls. If you do not add the phone number to a Trunk, you are simply "parking" the number on your account and inbound calls to that number will not complete. "Parking" a phone number is not free and "parked" numbers incur the same monthly fee as active assigned phone numbers.
To assign a number to a trunk, click "Assign to Trunk" button toward the top of the page. This will bring up the "Assign phone number to Trunk" popup as seen below. From the dropdown select the Gateway and Trunk combination you created in "Getting Started 1". Click "Confirm".
(Figure 1.c)
You should now see the selected Trunk and gateway next to your number in the grid as in the image below. You now have an active, assigned phone number on your VoicePulse FIVE account.
(Figure 1.d)
Step 2: Create a Call App
A Call App tells your VoicePulse Gateway how to handle your Inbound call. A Call App can contain as many destinations (Endpoints) as you wish. Your Gateway will attempt to send your Inbound call to each Endpoint in line until it receives an answer. It is in this way you can set up multiple Endpoints for failover purposes. Your Call App needs to contain at least 1 active Endpoint for Inbound calls to complete. For this example we will use the Endpoint we created in "Getting Started 1".
In the left hand menu click "Call Apps". This will open the Call Apps page as seen below.
(Figure 2.a)
Click "Create" toward the top of the page. This will open the "Create Call App" popup as seen below. Enter a name (for display only) and select the Gateway we created in "Getting Started 1" . Click "Create". Your Call App should now show in the grid as seen in the above image.
(Figure 2.b)
You now need to add a destination (Endpoint) to your Call App as explained above. Click on the Call App you created in the grid and click the "Edit" button toward the top of the page. This will bring up the "Edit Call App" popup as seen below.
(Figure 2.c)
Enter a name for the Call App (for display only), click "Add Step" at the bottom left of the window. Click inside the box under action and select either "Forward" or "Dial" from the dropdown that appears there.
The "Forward" option will send the call to your SIP Endpoint without changing the "Request URI". So Inbound calls to your phone number (e.g. 17323395100) will be sent to your SIP Endpoint as 17323395100@[SIP Endpoint IP]. This is the standard option and is the most common. Note: If you chose "IP Authentication" when you created your Endpoint in the previous article, you should choose "Forward" for any Call Apps that send to that Endpoint.
The "Dial" option will modify the "Request URI" from 17323395100@[SIP Endpoint IP] to [Endpoint username]@[SIP Endpoint IP]. The Endpoint username will be the username you created when you created your Endpoint in the previous article. Note: If you chose "IP Authentication" when you created your Endpoint in the previous article, you should choose "Forward" for any Call Apps that send to that Endpoint.
Click inside the box under Endpoint and select the Endpoint we created in "Getting Started 1". Click "Save".
You now have a Call App that will send your Inbound calls to the Endpoint you created. You can create a second Endpoint the same way you created the first one and add that Endpoint to this Call App the same way if you wish to have a second Endpoint for failover.
Step 3: Create an App Map
An App map allows you to route calls to different Call Apps depending on the phone number that was called, or you can simply just send all Inbound calls to the same Call App. App Maps and Call Apps work together and function much the same way an Inbound Route on a PBX does.
In the left hand menu click "Gateways". This will bring you back to the Gateways page. Select the Gateway your created in the grid and click the "App Map" tab toward the bottom of the page as seen below.
(Figure 3.a)
Click "Add a new record" and select the Call App you just created from the dropdown menu. Click in the box under Match Expression to enter a "Regular Expression" such as ^.*$ to send all Inbound calls to the selected Call App. Your App Map should look like the one in the image above. Click "Save changes".
If you have multiple numbers and do not want them to all go to the same destination you can change the "Regular Expression" under Match Expression to match a specific phone number. The "Regular Expression" would then be ^(11 digit phone number)$ (e.g. ^17323395100$). Your App Map would then look like the image below. Click "Save changes". Note: You would need to also create a second Call App and a second Endpoint in order to send your calls a different destination.
(Figure 3.b)
Step 4: Configure SIP Endpoint
You have now configured your FIVE account for Inbound calling. You now need to configure your SIP Endpoint (PBX, SIP phone, etc) to connect to your VoicePulse Gateway using the authentication method chosen when you created your Endpoint if you have not already done so. Once you have successfully configured your SIP Endpoint you can begin testing Inbound and Outbound calling on your FIVE account.
If you need help configuring your SIP Endpoint see our PBX configuration article Getting Started 2: Configuring a PBX trunk to connect to your FIVE Gateway
If you are still unable to make Inbound or Outbound calls please contact support at 732-339-5100 9am-5pm EST M-F or on our live chat at five.voicepulse.com.