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
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 user account credentials in the Username and Password fields, and specify your Bandwidth Account ID (the Application ID you will get form the next configuration step). Then, copy Webhook URL provided.
Bandwidth provides a 'user-based' permission and authentication scheme. It's recommended to create a new user with ONLY API access and the necessary roles on your account. The API user can be leveraged to access all of Bandwidth's APIs. Learn more about how to create a user in your Bandwidth admin portal via this link.
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.