SignalWire provides APIs for voice, messaging, and video, allowing developers to build ultra-low latency, high-reliability communications. With the Ringotel and SignalWire integration, you can enable SMS and MMS messaging for softphone users in a few clicks.
How does it work
The SignalWire SMS/MMS integration allows you to add your SignalWire phone numbers and assign one or multiple users who will be able to send/receive messages via these numbers.
Note:
SMS/MMS integration is part of the Pro package. Upgrading an organization to Pro pricing is required to enable this feature.
Step 1. Enable SMS integration for a Ringotel organization.
In the organization where you want to enable the SMS integration, navigate to the connection’s Features settings and set Enable SMS via Integrations. Then, hit Save changes.
Navigate back to the organization’s dashboard and switch to the Integrations tab. Click Enable Integration button on the SignalWire panel.
Copy the provided Webhook URL, which we will need in the following steps.
Step 2. Setting up a SignalWire account.
Inbound messages
Firstly, navigate to your SignalWire admin portal > My Resources, create a new Script, and select create a new cXML Script.
In the New cXML Script form, select Messaging in the "Script Will Be Used For" field. Then, in the "Handle Using" field select "External URL" and paste the Webhook URL copied earlier from the Ringotel portal. The HTTP method should be POST. In addition, specify the same Webhook URL and Method in the "Status Change Webhook" section.
Once done, click the Create button to create a new script.
After creating a resource, we need to assign it to our SignalWire SMS number that we'd like to connect to Ringotel. For this, in the newly created resource settings, swtich to the "Addresses & Phone Numbers" tab and click the +Add button.
In the "Add an Address" pop-up, select "Phone Number" and add a phone number to associate it with the resource.
Tip:
Repeat this step with every phone number that you would like to connect to Ringotel. The Webhook URL will be the same for all resources.
Outbound messages
To enable outbound messages, navigate to API Credentials and click the Create a Token button.
In the "New API Token" form, give this token a name and select only the "Messaging" scope in the list of scopes. Click the Save button to generate a token.
Once the token is generated, copy the Token value, along with the Project ID and Space URL fields. Then, navigate back to the Ringotel admin portal and paste the values into the corresponding fields:
Click the Save & Continue button to proceed to the next step.