thinQ

thinQ develops voice-enabled apps and messaging services for the enterprise and telecommunications industries. With Ringotel and thinQ 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 thinQ SMS-enabled phone numbers and assign multiple users who can send/receive messages via these numbers.

Enable SMS service

1. Navigate to the connection’s features settings in an organization where you want to enable the integration. Then, set Enable SMS via Integrations and hit Save changes.

Open

Set up the Integration

Navigate to your Ringotel admin portal → organization → Integrations tab, and click the Enable integration button on the thinQ card. The integration settings panel should appear. Press the Copy button beside the provided Webhook URL.

Open

Next, log into your thinkQ portal and make sure that your thinQ DIDs have the SMS feature activated. To activate DIDs go to Number Management. You may edit a single one by clicking the Edit Icon (shaped like a pencil). To bulk add SMS, select more than one DID by clicking on it (or "Select All") and highlighting them gray. A Pencil icon will appear above the number management table. If you click on it, a "Bulk Edit" pop-up will appear. Check the SMS checkbox, slide the button to the green position, and click the "Set" button.

To receive inbound messages on Ringotel, configure an account-level value in the Messaging → Message Settings section. This is where all incoming messages will be forwarded if you do not configure a DID-level override. Paste the Webhook URL previously copied from your Ringotel admin portal into the Delivery Confirmation URL and Inbound Message URL fields. (Alternatively, you can override the default URL for individual DIDs using an "SMS Routing Profile").

To enable outbound SMS, navigate to the API → Tokens section and create a new Token by clicking on "Add Token" in the upper right corner. A pop-up will appear. Select which function(s) to associate with the token.

Once you have created a Token, you should see a Token key. Lastly, get the Account and Username values from the Profile → User Profile that you'll need (along with the Token key) to enter in thinQ integration settings in your Ringotel admin portal.

Navigate back to your Ringotel admin portal and enter your thinQ Account, Username, and Token values into the corresponding fields in the integration settings panel:

Then click the Save & Continue button.

Add phone numbers

Once the integration settings are successfully saved, you need to add your SMS-enabled thinQ phone numbers and assign users who can send/receive SMS/MMS via these phone numbers. 

In the Phone number field, specify your thinQ 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.

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.