Bandwidth

Bandwidth

Bandwidth provides software application programming interfaces for voice and messaging using their IP voice network. With Ringotel and Bandwidth integration, you can enable SMS and MMS messaging for softphone users in a few clicks.

How does it work

The Bandwidth SMS/MMS integration allows you to add your Bandwidth phone numbers and assign multiple users who will be able to send/receive messages via these numbers.

SMS/MMS integration is part of the Pro package. Upgrading an organization to Pro pricing is required to enable this feature.

How to enable

  1. Navigate to the connection features settings where the users for which you would like to enable integration are created. Then, set Enable SMS via Integrations and hit Save changes.

How to set up

In your Ringotel Shell admin portal, navigate to your organization → Integrations tab. Click Set up Integration button on the Bandwidth panel.

In the integration settings, provide your Bandwidth API Credentials in the Client ID and Client Secret fields, and specify your Bandwidth Account ID (the Application ID you will get form the next configuration step). Then, copy Webhook URL provided.

Bandwidth is switching to a new authentication method as of Dec 2026 so API User Credentials used before are no longer valid. Full steps on how to create new API Credentials can be found here: https://dev.bandwidth.com/docs/account/credentials/management/#oauth-20-client-credentials-flow

 

On the next step, navigate to your Bandwidth admin portal (https://dashboard.bandwidth.com) and create a new Application. According to Bandwidth, Applications help to direct call and messaging events, like taking an incoming call and connecting it with the right phone number or endpoint.

In the new Application form, provide the Application name and a Callback URL (i.e. Webhook URL which you have copied from your Ringotel Shell admin portal earlier).

Click Create Application.

Once an application is created, we need to create or associate our application with a location so that when a phone number receives an event, the application will send the appropriate callback to the specified Callback URL. For this, in the application settings, scroll down to the Associated Locations section and click Create a location or Associate a location with this application.

Once the application is created, navigate back to the Ringotel portal and specify the Application ID in the corresponding field of the integration settings.

Click Save & Continue.

Manage users

Return to your Ringotel Shell admin portal and click the Manage users button on the Bandwidth integration panel. Add your Bandwidth phone numbers and assign users who will able to send/receive SMS/MMS via these phone numbers. 

In the Phone number field, specify your Bandwidth phone number in the E164 format, for example, +18443997981.

Select Users who will send and receive SMS/MMS via this phone number. You can click Select all to select all users from this connection. 

In the Session stickiness field, specify a timeout during which the subscriber’s phone number will stick to a user who initiated a conversation by sending an outbound message.

Reformat outbound/inbound numbers options allows mitigating chats duplication when, for example, an incoming SMS is coming in one format (e.g., E.164), but users are sending outgoing SMS in another format (e.g., National). In addition, you can set a similar option for calls in the connection’s settings.

Click Save.

You can add more phone numbers by clicking Add SMS number button.

After setting up an integration, users who you assigned to the phone numbers will need to re-login from their Ringotel app.