A VCP defines voice origination (Inbound) settings and routing for a group of phone numbers, regardless of geography or the Location where the numbers are stored on your account. Every number in a VCP receives the same configuration, so a single update replaces the work of configuring each Location.
Note: Assigning phone numbers to a VCP enables the numbers for the features configured on that VCP.
To support the expanded scope of regulatory requirements for global services, the Inbound and Routing settings on the Universal Platform have moved from Locations to Voice Configuration in the Bandwidth App. Location settings remain in use for other products, such as Messaging.
Creating VCPs
VCPs are created for groups of similarly configured numbers. Before creating a VCP, make sure that:
The account is configured for Global Services and VCPs.
A Voice Integration exists for the numbers, if applicable.
To create a VCP, complete the following steps:
Log in to the Bandwidth App.
In the left-hand side navigation bar, click Service Management, then click Voice Configuration.
Next to the Voice Configuration page title, click Create new. The Create new panel opens on the right side of the page, and the list of existing VCPs appears on the left side.
In the Create new panel, enter a name in the required Package name field and, optionally, enter a Description. Leave the Package type drop-down set to Phone numbers.
Under Routing, click Add standard. A Primary route box appears with a traffic percentage field (set to 100 by default), a route type drop-down, and a destination field.
In the route type drop-down, select a route type. This example uses Route to IP, which routes calls to an Internet Protocol (IP) address. The Route types table below lists every option.
In the destination fields, enter the details for the selected route type. For Route to IP, enter the IP Address and Port. Click Add endpoint to add another endpoint, or click Optional attributes to display optional attributes for the route.
Optionally, scroll down and turn on the settings the VCP needs. The Optional package settings table below describes each section.
At the bottom of the panel, click Save. After the VCP is saved, assign ordered or ported numbers to the VCP.
Route types
Route type | What the route does |
Route to domain name | Routes calls to the domain name that you enter. |
Route to IP | Routes calls to the IP address and port that you enter. |
Route to SIP URI | Routes calls to the Session Initiation Protocol Uniform Resource Identifier (SIP URI) that you enter. |
Forward to phone number | Forwards calls to the phone number that you enter. |
Route to integration | Routes calls to a configured integration. |
Optional package settings
Section | Settings in the section |
Voice protocol | Configure with HTTP voice protocol (Hypertext Transfer Protocol) |
Pindrop | Pindrop integration |
Inbound caller information | Caller name (CNAM) |
STIR/SHAKEN (Secure Telephone Identity Revisited and Signature-based Handling of Asserted information using toKENs) | Inbound verification results and Transit identity header service |
Identity Authentication | Identity Authentication Enabled and the Analytics Engine drop-down |
Updating VCPs
To update a VCP, complete the following steps:
Log in to the Bandwidth App.
In the left-hand side navigation bar, click Service Management, then click Voice Configuration.
In the Phone numbers list on the left side of the page, click the VCP to update.
Enter text in the Search package name field to filter the list. The Update package panel opens on the right side of the page.
Change the settings to apply to all numbers assigned to the VCP, then click Save at the bottom of the panel. After the system validates that all assigned numbers function correctly with the new settings, the VCP updates.
Below the Save button, the Associated numbers table lists the numbers assigned to the VCP, with the columns Phone numbers, Country, and Override. The Delete button deletes the VCP.
Tip: Click View in Visual Builder next to the Update package heading to open the VCP in Visual Builder.
Assigning numbers to VCPs
A single VCP can hold any phone numbers that support the enabled features and share the same route rules, irrespective of geographical Location. Create a new VCP in these scenarios:
Create a VCP for phone numbers that do not support the features enabled in another VCP. For example, a phone number from France cannot join a VCP enabled for Caller Name (CNAM).
Create a VCP for groups of phone numbers assigned to the same routing destination or integration. Numbers configured for a specific Voice integration can share one VCP.
Create a VCP for a single phone number with special configuration settings that do not match another VCP, such as Call Forwarding for an individual number.
Create a VCP for any customer-determined grouping of numbers. Limit the number of VCPs to a small set of configurations, or separate the numbers into multiple VCPs to match business requirements.
To find numbers that need a VCP, open My Numbers and select the Missing voice configuration search option.
Moving numbers between VCPs
To move numbers to a different VCP or make changes to individual numbers that are part of the same VCP, complete the following steps:
Log in to the Bandwidth App.
In the left-hand side navigation bar, click Numbers, then click My Numbers.
On the My Inventory tab, under How do you want to search?, select a search option (for example, All numbers), then click Search.
In the Search result table, select the checkbox beside each phone number to move.
In the bar at the bottom of the page, click Actions. The Update your numbers panel opens.
Under the heading for the selected numbers, click Change voice configuration.
In the Change voice configuration dialog, confirm that the selected numbers option is selected under Phone numbers to update, then click Next.
In the Voice Configuration Package drop-down, select the VCP, then click Save. After Bandwidth verifies the move, the provisioning process reconfigures the phone numbers into the new VCP.
Note: Numbers that do not support the features in the chosen VCP are not updated.
Questions? Open a ticket with your Bandwidth Support Team or call us at (855) 864-7776.
