SMS Distribution
SMS distribution sends survey invitations to SMS contact lists with short links, delivery tracking, and optional scheduling. Use this flow when the message's main job is to invite people into a specific survey.
Use SMS Campaigns when you want to create or manage SMS campaigns outside the survey Distribute tab.
Before you start
- Create or import your audience in SMS → Contacts. See Uploading an SMS Contact List and Sending an SMS Campaign.
- Configure at least one sending phone number in Admin Settings → Telephony (Twilio or Telnyx, depending on your account). See Phone Numbers and Communications Credits for purchase, monthly rent, release, and what Outbound suspended means.
- Make sure your survey is ready to field. If the survey uses restricted access, each recipient needs a valid access ID in their link — include
{{SURVEY_URL}}in your message so Quali-Fi can insert the correct link per contact when applicable.
Note
Invite with SMS requires the SMS distribution feature on your subscription. If the option shows Upgrade on the Distribute page, contact your Quali-Fi account team.
Start from your survey
Open your survey and go to the Distribute tab.
Click Invite with SMS.
Quali-Fi opens New SMS Campaign with your survey already selected.
You can also start from SMS → Campaigns → New Campaign, then choose the survey manually.
Create the SMS campaign
The campaign builder has four steps: Settings, Audience, Content, and Review.
Settings
| Field | What it does |
|---|---|
| Campaign Name | Required. Internal name for this send. |
| Send From Numbers | Choose one or more phone numbers configured in Telephony settings. |
| Survey | Pre-filled when you launch from Distribute. Links the campaign to your survey for reporting and {{SURVEY_URL}}. |
| Messages Per Minute | Required send rate (default 60). Controls how quickly messages leave the queue. |
| Enable Scheduling | Optional. Set a Start and End window instead of sending immediately. |
If no sending numbers appear, purchase a number in Admin Settings → Telephony first. Numbers with Outbound suspended billing will not send.
Audience
Select one or more SMS contact lists. The page shows how many contacts are in each list and your total recipient count.
You must select at least one list before continuing.
Content
Write your SMS Text and use the mobile preview on the right to check how it will look on a phone.
Click a merge tag button to insert common placeholders, or type them directly in the message.
Common merge tags
| Tag | Purpose |
|---|---|
{{NAME}} | Recipient name |
{{SURVEY_URL}} | Survey link for the linked survey |
{{first_name}} | First name from the contact record |
{{last_name}} | Last name from the contact record |
{{phone_number}} | Recipient phone number |
{{links}} | Custom link field from an imported contact list |
Merge tags are case-insensitive — {{links}}, {{LINKS}}, and {{Links}} all resolve the same way.
Any extra column from a CSV import can also be used. Quali-Fi normalizes the column header into a tag — for example, a column named first name becomes {{first_name}}.
Tip
Include {{SURVEY_URL}} in survey invitation messages so each recipient gets the correct link. Messages over 160 characters are sent as multiple SMS segments.
The default message template includes a Reply STOP to unsubscribe line. Keep opt-out language in your copy when sending to broad lists.
Review
Confirm campaign name, linked survey, recipient count, send rate, and the SMS preview.
Then choose one of:
- Send Campaign — sends immediately, or schedules within your chosen window
- Save Draft — saves without sending so you can finish later
Quali-Fi asks you to confirm before sending or scheduling.
After you send
Track the campaign from SMS → Campaigns:
- Open View Report for delivery totals (queued, sending, sent, failed, cancelled)
- Open Replies to review inbound SMS responses when two-way messaging is enabled
- Cancel an in-progress campaign if needed
For status definitions and troubleshooting failed messages, see SMS Campaigns.
Send now vs schedule
| Option | Behavior |
|---|---|
| Send now | Leave Enable Scheduling off. Messages start sending as soon as you confirm Send Campaign. |
| Schedule | Turn on Enable Scheduling and set Start and End times. The campaign status becomes Scheduled until the window opens. |
The end time must be after the start time.
Notes
- Survey distribution creates an SMS campaign linked to that survey. You manage and duplicate it from SMS → Campaigns.
- If you need personalized external links per contact (not the Quali-Fi survey URL), import them in your contact list and reference the column with a merge tag such as
{{links}}. - For Twilio numbers added outside Quali-Fi, inbound replies and STOP handling require the number's SMS webhook to point to your Quali-Fi environment.