Skip to main content

QuestBlue

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 QuestBlue

  • Username: Enter the API user you created on your QuestBlue account.

  • Password / Application Secret: Enter a JSON object containing both your API user password and your QuestBlue Security-Key (API token), in this exact form:

    {"password":"YOUR_API_USER_PASSWORD","token":"YOUR_QUESTBLUE_SECURITY_KEY"}
    note

    QuestBlue requires two secrets: the API user's password and the account Security-Key (API token). Vodia reads them from a single JSON value in the password field — password is sent via HTTP Basic auth with the username, and token is sent in the Security-Key header. Both must be present and valid. Generate the API user/password and activate the API token in the QuestBlue portal under Services → Programmers API — consult the QuestBlue documentation for the exact location. The API token can take 10-15 minutes to activate after creation.

  • 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: questblueinbound
  • Source: It could be your extension number.
  • Destination: It could be your extension number.
  • Click [Save].
warning

QuestBlue SMS supports US/Canada numbers only. Both the source and destination must begin with +1. International numbers are rejected.

Configure the QuestBlue inbound webhook​

To receive messages, configure your QuestBlue number to post inbound SMS to your PBX. In the QuestBlue portal, navigate to Services → SMS → SMS settings and edit the number you want to activate (consult the QuestBlue documentation for the exact location). Set:

  • SMS service status: URL to Post SMS
  • URL to Post SMS: Your PBX URL with the prefix you specified above, for example: https://your-pbx-domain.com/questblueinbound
  • URL posting method: XML (JSON and form-encoded POST are also accepted)

Vodia accepts inbound messages in XML, JSON, or form-encoded format and normalizes the numbers. For MMS, image attachments are extracted (from inline base64 in XML, or downloaded from media URLs in JSON).

Outbound messages are sent to https://api2.questblue.com/smsv2.

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