Apidaze is a cloud-based Communications platform as a service (CPaaS) that allows customers, partners and developers to embed real-time communication capabilities to their business software applications. With Ringotel and VoIP Innovations integration, you can enable SMS and MMS messaging for softphone users in a few clicks.
How does it work
The integration allows you to add your VoIP Innovations SMS-enabled phone numbers and assign multiple users who can send/receive messages via these numbers.
SMS/MMS integration is part of the Pro package. Pro package can be applied per organization where the integration is required.
Enable SMS service
Navigate to the connection’s features settings in an organization where you would like to enable the integration. Then, set Enable SMS via Integrations and hit Save changes.
Set up the Integration
Navigate to your Ringotel admin potral -> organization -> Integrations tab, and click the Enable integration button on the VoIP Innovations card. The integration settings panel should appear. Press the Copy button beside the provided Webhook URL.
Log into your VoIP Innovations portal, and navigate to Apps → Create a Dev App.
In the Create New App settings, specify App name and Region, then check the SMS box and in the SMS Script URL, paste the Webhook URL copied from the Ringotel portal. Click Create App.
Once the VoIP Innovations app is created, copy its API Key and API Secret and enter them into the designated fields in the VoIP Innovations integration settings in your Ringotel portal:
Then click the Save & Continue button.
Add phone numbers
Once the integration settings are successfully saved, you need to add your SMS-enabled VoIP Innovations phone numbers and assign users who can send/receive SMS/MMS via these phone numbers.
In the Phone number field, specify your VoIP Innovations phone number in the E.164 format (without +), for example, 18584376047.
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.
Session stickiness determines how long a client number will stick to a user who initiates a conversation by sending an outgoing SMS. For example, a user creates a new chat with an external client number 5136553082. If a client replies to an SMS within the session stickiness time, the message will be routed directly to the user who initiated the conversation. Once the session stickiness timeout, the next incoming message from a client will create a new chat, and the users assigned to the SMS phone number will receive a message and be able to communicate with a client.
Note: If Session stickiness is set to Disabled, it sets the timeout to 0, so every incoming or outgoing message with a new client will create a new group chat.
Reformat outbound/inbound numbers options allow 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 (Match phone numbers with the e164 format option).
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.