This article lists the messages you can see while setting up and using Text My QB, grouped by where they appear, and the values Text My QB writes to your records after each text. For each one you get the cause and what to do. Messages are quoted exactly as they appear, so you can search this page for the text you see. Common questions are answered at the end, in Frequently asked questions.
Available to: all roles with the Text My QB extension.
How messages appear
Toasts. Most configurator messages slide in at the bottom right of the window. A colored bar on the left shows the type: green for success, blue for information, red for errors. Some close on their own after about 15 seconds and show a shrinking progress bar; the rest stay until you select them. Select a toast to dismiss it.
Error page. If an error stops the configurator from loading, the window shows Oops! Something went wrong., then the reason, then Please close this window. Close the window, then open the configurator again from the Text My QB extension page.
Results of each text. The configurator doesn't show what happened when texts were sent. Text My QB writes the result to the Status Field on each outbound record, and to the Delivery Status Field in your activity table. See Status Field values. For incoming texts, see Incoming texts.
Opening the configurator
Message | Cause | What to do |
|---|---|---|
Text My QB configuration URL is not available. | You selected Text My QB Configuration on the extension page, and the configurator's address couldn't be found for your account. | |
A Client ID must be passed in. Please contact support. or Client ID is required. | The configurator was opened without your company's details, for example from a saved link. | Open the configurator from the Text My QB Configuration button on the extension page. |
An unexpected error occurred while loading configurations. Please contact support. | The configurations list couldn't load. | Close the window and open the configurator again. If it keeps happening, submit a technical support case. |
A Record ID# must be passed in. Please contact support. | A configuration window was opened without a configuration. | Open the configuration from the list with Edit. |
We were unable to find a Configuration with the ID 'ID'. Please contact support. | The configuration you opened can't be found. | Close the configurator, open it again so the list refreshes, and try again. |
An AppID must be set on the record before TextMyQB Configurator can load. Please contact support. | The configuration has no Quickbase app. | Submit a technical support case. |
A red message about authorization | The configuration's app is no longer authorized for Text My QB, or its user token no longer works. |
Creating a configuration
These appear in the New Configuration window when you select Save. The fields are checked in order, and only the first problem is shown. Missing-field messages are blue the first time and red if you select Save again without fixing them. See Create a Text My QB configuration.
Message | Cause | What to do |
|---|---|---|
Please enter a configuration name. | Configuration Name is empty. | Enter a name. |
Please select an application. | No app is chosen in Quickbase Application. | Choose an app. If your app isn't listed, authorize it for Text My QB with Authorize New App on the extension page. |
Please select a license key. | Nothing is chosen in the License Key dropdown. | Choose an existing key, or Enter a license key. |
Please enter an Esendex license key. | The license key box is empty. | Enter the license key from your Esendex account. |
You have no applications authorized to use Text My QB - please use the Setup Wizard to authorize an application before using this configurator. | No app is authorized for Text My QB yet. | Close the window, select Authorize New App on the Text My QB extension page, then try again. See Before you start. |
Something went wrong with the license key - please contact support. | Esendex didn't accept the key you entered. | Check the key in your Esendex account and try again. If it still fails, submit a technical support case. |
The selected license key could not be verified. Please try again or contact support. | The key you chose from the dropdown couldn't be checked. | Choose the key again, or enter it, and save. If it keeps happening, submit a technical support case. |
An encrypted license key must be provided. Please contact support. | The license key didn't reach the configurator. | Submit a technical support case. |
Failed to process the license key for the new configuration. Please contact support. | The license key couldn't be processed. The configuration wasn't created. | Submit a technical support case. |
The configuration was created but the inbound SMS postback URL could not be registered. Please contact support. | The inbound configuration exists, but the connection that sends texts from Esendex to Text My QB wasn't set up, so texts may not reach it yet. | Submit a technical support case so the connection to Esendex can be completed. |
An error occurred. Please contact support. | Saving the new configuration failed without more detail. | Try again. If it keeps happening, submit a technical support case. |
Editing and saving
Message | Cause | What to do |
|---|---|---|
Successfully saved settings. (green) | You selected Save and all tabs were saved. | Nothing. |
Please save or cancel changes before proceeding. (blue, then red) | You tried to switch tabs with unsaved changes. It turns red if you try again. | Select Save to keep your changes or Cancel to undo them, then switch tabs. |
The Esendex Phone Number given is not valid. (red) | The Phone Number on the EsendEx Info tab is missing or isn't a valid number. A phone number is required on every save. | Enter the Esendex number from your Esendex account: 10 digits for the US or Canada, or 11 to 15 digits including the country code. |
Unable to save configuration to Quickbase. (red) | Saving failed. Your changes weren't saved. | Try again. If it keeps happening, submit a technical support case. |
Copied to clipboard. (green) | You selected the Config Key on the Config Info tab. | Paste the key where you need it. |
A red message about authorization, when fields load or when you save | The app is no longer authorized, or its user token no longer works. |
Copying a configuration
These appear in the Copy Configuration dialog. See Copy a configuration.
Message | Cause | What to do |
|---|---|---|
Please enter a configuration name., Please select an application., Please select an outbound table., or Please select a messages received table. (red) | A required box in the dialog is empty. | Fill it in and select Copy again. |
A configuration name is required. or An application must be selected. | The copy request reached the server without a name or app. | Fill in Config Name and Application and select Copy again. |
An unexpected error occurred while opening the copy dialog. Please contact support. | The dialog couldn't load the apps and tables after you selected Copy on a row. | Try again. If it keeps happening, submit a technical support case. |
An unexpected error occurred while loading tables. Please contact support. | The tables for the app you chose in Application couldn't load. | Check that the app is still authorized for Text My QB, then try again. |
An error occurred while saving the configuration settings. Please try again. | The copy's settings couldn't be saved. The copy wasn't created. | Try the copy again. |
Source configuration not found. Please contact support. | The configuration you're copying can't be found. | Close the configurator, open it again so the list refreshes, and try again. |
An unexpected error occurred. Please contact support. | The copy request failed. | Close the configurator and open it again, and check whether the copy is in the list before you try again. |
No message, and no window opens after Copy | Your browser blocked the copy's pop-up window. The copy was still created. | Close the configurator, open it again, and select Edit on the copy's row. Allow pop-ups for next time; see Allow pop-ups. |
Processing tab: Execute On Demand and the Configuration String
See Processing tab.
Message | Cause | What to do |
|---|---|---|
On-demand execution has been requested. (green) | You selected Execute On Demand, and the run was queued. | Check the Status Field on your records after a few minutes. |
This config still has a pending on-demand execution. (blue) | You selected Execute On Demand while an earlier request hadn't finished. No second run was queued. | Wait a few minutes and check your records. If you still see this long after your request and no texts went out, submit a technical support case so the pending request can be cleared. Before you request a run, make sure the configuration is Enabled (or Test Mode) and the report has records. |
An error occurred while requesting on-demand execution. or An error occurred while requesting on-demand execution. Please try again. (red) | The request didn't go through. | Select Execute On Demand again. |
Could not find the configuration record. (red) | The configuration can't be found. | Close the window, refresh the list, and reopen the configuration. |
Please select an outbound table first. (in the Configuration String box) | No Outbound Table is chosen. | Choose an Outbound Table on the Outbound Setup tab and save. |
Save the configuration to generate the config string. (in the Configuration String box) | The configuration hasn't been saved yet. | Select Save. |
Configuration string copied to clipboard. (green) | You selected Copy under Configuration String. | Paste it as the body of your email notification. See Triggered. |
Unable to copy to clipboard. Please copy the configuration string manually. (red) | Your browser blocked the copy. | Select the text in the box and copy it with Ctrl+C (Cmd+C on a Mac). |
Frequently asked questions
Where do I get my Esendex license key and phone number?
From your own Esendex account. Text My QB sends and receives texts through it. If you don't have an account, sign up with Esendex, then get the license key and a phone number (DID) from your Esendex account and enter them when you create a configuration. See Before you start.
Execute On Demand keeps saying "This config still has a pending on-demand execution." What do I do?
The earlier request hasn't finished. Wait a few minutes and check your records. Before you request a run, make sure the configuration is Enabled (or Test Mode) and saved, and that the report has records. If you still see the message long after your request and no texts went out, submit a technical support case so the pending request can be cleared.
The Outbound Setup tab says 2mb. What's the attachment size limit?
Keep the total for one text under 1.5 MB. The note on the Outbound Setup tab says 2mb, but above 1.5 MB the recipient's carrier may not deliver the text. Attachments must be in file attachment or URL fields in the File Attachments list, and files in URL fields must be reachable without signing in. For the file types you can send, see Send images.
How do I delete a configuration?
Configurations can't be deleted. Set Configuration Status to Disabled and save. See Stop using a configuration.
Do Test Mode texts count as usage, and who gets them?
Test sends aren't counted as Text My QB usage. They're still real texts, sent through your Esendex account to the numbers on your records, so test with records that have only your own number.
Nothing opens when I select Add, Edit, or Copy. Why?
These open a separate pop-up window, which your browser may be blocking. Allow pop-ups for the Extensions Portal and try again; see Allow pop-ups. If a window opened behind your browser, look for it in your taskbar. After Copy, the copy was created even if its window didn't open: close and reopen the configurator, and select Edit on the copy's row.
A field or table isn't in the dropdown. Why?
The lists are read from your app when the window opens. Close the configuration window and open it again with Edit. If you're copying to a different app, make sure that app is authorized for Text My QB.
Still stuck? Submit a technical support case and include the configuration's name and any message you saw. See also the Text My QB Configurator overview.