Skip to main content

Managing Voice Configuration Packages on the Universal Platform

This article explains how to create and update VCPs, as well as assign and move phone numbers between them in the Bandwidth App.

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:

  1. Log in to the Bandwidth App.

  2. In the left-hand side navigation bar, click Service Management, then click Voice Configuration.

  3. 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.

  4. 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.

    The Create new panel on the Voice Configuration page, showing the Package name, Description, and Package type fields and the Routing section with the Add standard link.
  5. 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.

  6. 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.

    The route type drop-down open in the Primary route box, listing Route to domain name, Route to IP, Route to SIP URI, Forward to phone number, Route to AI-bridge bot, and Route to integration.
  7. 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.

    The Primary route box with Route to IP selected and the IP address and port fields displayed, with the Add endpoint and Optional attributes links.
  8. Optionally, scroll down and turn on the settings the VCP needs. The Optional package settings table below describes each section.

    The lower part of the Create new panel showing toggles for Configure with HTTP voice protocol, Pindrop integration, Caller name (CNAM), Inbound verification results, Transit identity header service, and Identity Authentication Enabled.
  9. 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:

  1. Log in to the Bandwidth App.

  2. In the left-hand side navigation bar, click Service Management, then click Voice Configuration.

  3. 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.

    The Update package panel for a selected VCP, showing the package name, description, package type, and Primary route.
  4. 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.

    The lower part of the Update package panel showing the Delete and Save buttons and the Associated numbers table with Phone numbers, Country, and Override columns.

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:

  1. Log in to the Bandwidth App.

  2. In the left-hand side navigation bar, click Numbers, then click My Numbers.

  3. On the My Inventory tab, under How do you want to search?, select a search option (for example, All numbers), then click Search.

    The My Numbers page on the My Inventory tab showing the search options, including All numbers, Missing voice configuration, and Search for Numbers on a VCP.
  4. In the Search result table, select the checkbox beside each phone number to move.

  5. In the bar at the bottom of the page, click Actions. The Update your numbers panel opens.

    The Update your numbers panel showing Quick bulk actions and the actions for selected numbers, including Change voice configuration.
  6. Under the heading for the selected numbers, click Change voice configuration.

  7. In the Change voice configuration dialog, confirm that the selected numbers option is selected under Phone numbers to update, then click Next.

    The Change voice configuration dialog showing the Phone numbers to update options and the Next button.
  8. 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.

    The second step of the Change voice configuration dialog showing the Voice Configuration Package drop-down, the Override button, and the Save button.

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.

Did this answer your question?