Prerequisites
- PortaSwitch MR129 or a later version.
- An active Bandwidth account with E911 Dynamic Location Routing enabled. You will need your Bandwidth account ID and API credentials.
- An active free trial or paid subscription to the E911 (Bandwidth) module in the Add-on Mart.
Configuration overview
- Configure the module in the Add-on Mart management portal
- Grant your system access to the Add-on Mart services
- Enable the Bandwidth emergency module in the Configuration server web interface
- Set up the Emergency service feature on a product
Step 1. Configure the module in the Add-on Mart management portal
Log in to the Add-on Mart management portal, locate your E911 (Bandwidth) subscription, and click Configure.
On the configuration page, fill in your Bandwidth account details:
- Bandwidth Account ID – your Bandwidth account identifier.
- Login for the API user – the username of the API user created in the Bandwidth system.
- Password for the API user – the password of the API user created in the Bandwidth system.
Click Save.
Step 2. Grant your system access to the Add-on Mart services
To grant your system access to the Add-on Mart services:
- In the Add-on Mart management portal, open the My modules page and copy the credentials.
- In the Portabilling web interface, navigate to My company > Company info > Add-on Mart, and enter these credentials.
Step 3. Enable the Bandwidth emergency module on the Configuration server web interface
Log in to the Configuration server web interface and set the EmergencyModule.Bandwidth_Provider_Enabled option to Yes.
Also, in the EmergencyModule.Numbers field, enter the numbers to be treated as emergency calls (e.g., 911 for live calls, and 933 for test calls).
Save and apply the configuration.
Step 4. Set up the Emergency service feature on a product
To enable routing of 911 calls to Bandwidth, configure it at the product level:
- Open the product record in PortaBilling.
- Navigate to Services > Voice calls > Outgoing calls, and enable the Emergency service feature.
- Select Bandwidth in the Module field.
- Save the product.
When you save the product, PortaSwitch schedules a background task to provision existing addresses to Bandwidth for all accounts using this product. By default, provisioning starts 60 minutes after saving, allowing you to reverse this change if it was enabled by mistake. To start provisioning sooner, you can reduce this delay via the E911.ProviderChangeDelay option in the Configuration server web interface.
Emergency locations can be entered by the service provider’s admin or by the customer through the self-care portal. An address must include: Country, State/Province, City, Address line, and ZIP/Postal code.
