beginner

SMS Distribution

Send survey invitations via SMS from the Distribute tab with contact lists, merge tags, and scheduling

10 min readUpdated September 2, 2026

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

1

Open your survey and go to the Distribute tab.

2

Click Invite with SMS.

3

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

FieldWhat it does
Campaign NameRequired. Internal name for this send.
Send From NumbersChoose one or more phone numbers configured in Telephony settings.
SurveyPre-filled when you launch from Distribute. Links the campaign to your survey for reporting and {{SURVEY_URL}}.
Messages Per MinuteRequired send rate (default 60). Controls how quickly messages leave the queue.
Enable SchedulingOptional. 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

TagPurpose
{{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

OptionBehavior
Send nowLeave Enable Scheduling off. Messages start sending as soon as you confirm Send Campaign.
ScheduleTurn 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.

Related

Was this article helpful?