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. Then, copy Webhook URL provided.
Click Save changes.
Now we need to configure the integration on Bandwidth. For this, navigate to your Bandwidth admin portal (https://dashboard.bandwidth.com) and ensure that your Bandwidth DIDs have SMS Enabled in its SMS Settings.
Next, we need to 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 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.
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.