Skip to main content

Upgrading from Legacy

This guide is designed for developers who are familiar with the Legacy APIs and have been onboarded onto their new Universal Platform account. Here, you'll find valuable information on how to leverage the new Universal Platform API to automate your business processes.

If you're unsure if now is the right time to upgrade to Bandwidth's Universal Platform, please contact your account rep.

Important Note

First and foremost - you must convert your existing applications to utilize E.164 formatted phone numbers. This will allow you to format your telephone numbers in a consistent manner across all Bandwidth APIs and services. More information on E.164 formatting can be found in the E.164 Upgrade Guide. This guide assumes you have already completed the E.164 upgrade or will be completing it alongside the other changes required to utilize the Universal Platform

Voice Provisioning

The V1 Legacy Dashboard utilizes Locations (Sip-Peers) for voice configuration. In the Universal Platform, voice configuration is replaced with Voice Configuration Packages (VCPs/).

note

Locations (Sip-Peers) have not been removed and are still a required account fixture - they are still a required account fixture and serve to group numbers as well as allow you to provision messaging settings.

Voice Configuration Packages can be applied to groups of numbers across multiple Locations (Sip-Peers) and are designed to simplify the process of configuring voice settings for your telephone numbers.

Compliance

In order to utilize non-North American Numbering Plan (NANP) numbers, you may be required to provide additional documentation to ensure compliance with local regulations. To make it possible to programmatically manage these requirements, Bandwidth has introduced a suite of APIs to manage compliance requirements, know as Requirements Packages.

Service Activation

Once all regulatory requirements have been met, you can begin activating services on your telephone numbers. When purchasing or porting numbers, service activation can be automatic if the appropriate Requirements Packages have been created and attached to the numbers. For more information - check out our guide on Service Activation.