Skip to main content

thinQ

Navigate to SMS Management

Add an SMS provider​

  • Log into your Vodia Tenant portal.

  • Click Trunks on the left menu then SMS Management

  • Under the Providers tab click the [+ | Add] button

  • Complete the information.

  • Name: Provide a name (for your purposes)

  • Provider: Select thinQ

  • Username: Enter your credentials in the format accountId/apiUsername (two values separated by a forward slash).

    • accountId — your thinQ account ID
    • apiUsername — your thinQ API username

    For example -

    12345/jsmith_api
    note

    Both values are required and must be in the order accountId/apiUsername. The account ID is used in the API URL path; the API username and token form the HTTP Basic authentication.

  • Password / Application Secret: Enter your thinQ API token.

  • Click [Save].

Add your SMS numbers​

Now you need to add your DIDs into the Numbers tab.

  • Under the section SMS Management (Trunks on the left menu then SMS Management)
  • Click the Numbers tab and click the [+ | Add] button.
  • Provide a name (for your purposes)
  • Enter your phone number in E.164 format (e.g., +12025551234).
  • Policy: If you have any policy in place, choose it. (optional)
  • Provider: Choose the provider name you have created.
  • URL prefix for receiving messages: Enter something you will use for your SMS callback URL. Eg: thinqinbound
  • Source: It could be your extension number.
  • Destination: It could be your extension number.
  • Click [Save].
note

Vodia converts numbers to local (national) format when sending to thinQ and back to E.164 on inbound, so store your numbers in E.164 (+) format in Vodia.

Configure the thinQ inbound webhook​

To receive SMS and MMS messages, configure thinQ to deliver inbound messages to your PBX. In the thinQ portal, locate the inbound SMS/MMS webhook settings (consult the thinQ documentation for the exact location) and set:

  • Webhook URL: Your PBX URL with the prefix you specified above, for example: https://your-pbx-domain.com/thinqinbound
  • Format: JSON (form-encoded POST is also accepted)

Vodia expects the inbound payload as JSON with a type of sms or mms, containing from, to, and message. For MMS, if the message is a URL, Vodia downloads the media; otherwise it is treated as inline base64.

Outbound SMS is sent to https://api.thinq.com/account/<accountId>/product/origination/sms/send; MMS to the corresponding mms/send endpoint.

Your thinQ SMS integration is now configured and ready to use.