Yazi docs
  • Setting up the WhatsApp API number
    • Setting up WhatsApp number in Yazi platform
      • Add a Payment Method
      • WhatsApp Profile
      • Get your business manager verified
      • Developer Portal method of setting up
  • Using Yazi's app
    • Research Campaign Setup
      • Survey Campaign
      • Diary Study Campaign
      • AI Interview Campaign
        • AI Interview Prompt Template
    • Inviting Participants
      • Sharing Links to access research
      • Create Template message
      • Send template message
      • Template Message history/stats
    • Results
      • Interviewer Results
      • Survey Results
  • APIs & Integrations
    • Setting up event-triggers
  • WhatsApp API Pricing
    • Pricing
  • Security
    • Data Security - Executive Summary
    • Yazi Information Security Policy
    • Data Classification Policy
    • Yazi Security and Data Management Policies
    • Yazi Vendor Management Policy
    • Data Retention Policy
    • Business Continuity Plan (BCP)
  • Yazi Process
    • 🎳Quality Control Plan for Yazi Research (Pty) Ltd
Powered by GitBook
On this page
  • Types of questions
  • Response Types in Detail
  • Multiple choice
  • Types of displays:
  • Multi-Select Multiple choice
  • Critical Response Handling Limitations
  • Best Practices for Media Questions
  • Using Logic and Routing
  • Preview and Testing
  • Campaign Configuration Options
  • Flow Mode
  • Launching Your Survey
  1. Using Yazi's app
  2. Research Campaign Setup

Survey Campaign

PreviousResearch Campaign SetupNextDiary Study Campaign

Last updated 1 month ago

Types of questions

Types of questions:

  • Single-select and multi-select multiple-choice

  • Open text

  • Image

  • Video

  • Voice note

Note: These relate to the response type expected from participants. For sending content to participants, images and videos can only be sent in questions without predefined options (open text, voice note, video, image questions).

Question Type Rules

  • Only answers that match the question type specified will be accepted

  • For example, a voice note will not be accepted for an image question type

  • Important: The system processes one response at a time in sequence. If a participant sends multiple responses quickly, each will be assigned to consecutive questions.

Character Limitations

  • Questions or messages to respondents: maximum 500 characters

  • Multiple-choice option answers: maximum 50 characters (Meta limit)

  • Multiple-choice options with buttons: 1-24 characters recommended for optimal display

Response Types in Detail

Open text

Any answer can be submitted in response to this question. Unlike other question types, open text questions allow the respondent to respond with any type - text, image, voice note, or video (no restrictions on response format).

Single-select

Participants must respond by clicking a button if answers are displayed as buttons.

For multi-select

a) Add this text to your question to show how they must answer: Select all that apply by giving the letters separated by a comma (e.g. a, c, d)

b) Important: Don't use commas in Answer options. The data for multi-select answers comes back as a string in a single cell with the answers separated by a comma. Therefore, for Q16, you might have this answer: Essentials (such as food, housing, clothing), Leisure & entertainment (such as travel and media). This makes it very tricky for software to pick up which are separate answers and which are commas as part of answers. So, rather use a semicolon to separate list items.

Voice note

Participants can record and send audio responses. Voice notes are automatically transcribed in our platform in the language they were spoken in.

Image

Participants can upload photos or screenshots.

Video

Participants can record and send video responses. Videos with speech are automatically transcribed in our platform in the language they were spoken in.

Question Type rules

Only answers that match the question type specified will be accepted. I.e. voice note will not be accepted for image question type

Question text

A question or message sent to a respondent in the bot can't be more than 500 characters

To explain something to a respondent (where you do not want it to be a question): Make it a Multiple Choice question and put 'Continue' or 'Understood' as the answer

Multiple choice

A multiple-choice option answer can't be more than 50 characters (Meta limit) 1-24 character multiple choice options appear as buttons

Types of displays:

1. Buttons

  • 1 - 3 options appear as buttons in the chat

  • Best for short, simple responses

2. List / Burger menu

  • 4-10 options appear in a burger menu

  • Options show up when clicked

  • Ideal for medium-length option lists

3. List with letter options (A, B, C etc)

  • A question where 1 of the multiple-choice options is 25-50 characters

  • OR, if there are more than 10 answer options will appear with letters as the answer e.g. Option 1 is A, Option 2 is B etc

  • OR, if it is a multi-select multiple choice question

Multi-Select Multiple choice

  • Do not use commas in multi-select options as our system detects separate options by commas ❌

  • For multi-select questions, instruct participants to separate their selections with commas (e.g., "a, c, d")

Critical Response Handling Limitations

⚠️ IMPORTANT: One Data Type At A Time

The system only stores one type of data per question. If a participant sends:

  • An image followed immediately by text: The image is stored for the current question, and the text is stored as the answer to the NEXT question

  • Multiple images in succession: Each image will be assigned to consecutive questions in the sequence

These limitations apply to both survey and AI interviewer interactions.

Best Practices for Media Questions

  1. Split media uploads and descriptions into separate questions:

    • First question: "Please upload an image/screenshot"

    • Following question: "Tell us more about what's shown in this image"

  2. Add clear instructions at the beginning of your study:

    • "Important: Please send only one response at a time and wait for the next question before responding again."

    • "For image questions: Send only the image first, then wait for the follow-up question where you can add your description."

  3. Include specific instructions in media question prompts:

    • "Please send ONLY the image here and wait for the next question before adding any description."

    • "After sharing your image, you'll have an opportunity to explain it in the next question."

  4. For multiple media uploads:

    • Create separate, sequential questions for each required media item

    • Add instructions like "Upload your first image here" followed by "Upload your second image here"

    • Consider adding a text question at the end for overall observations about all uploaded images

Using Logic and Routing

You can create conditional paths through your survey based on participants' answers:

  1. Below any question, click "Add logic"

  2. Select the condition (e.g., "When Question 1 contains 'Option A'")

  3. Choose where to route participants (e.g., "then go to Question 5")

  4. This allows you to personalise the journey based on previous responses

Preview and Testing

  • Preview the question type by clicking the 'Eye' icon

  • Always test your survey before sending it to participants

  • Verify that all logic and routing works as expected

  • Check that media questions are properly set up with clear instructions about the one-response-at-a-time limitation


Campaign Configuration Options

Flow Mode

Flow Mode is a new feature allowing surveys to be set up in WhatsApp's new Flows feature:

  • Compared to our usual message-by-message surveys inside WhatsApp chats, Flows make the experience much faster and more user-friendly

  • Respondents can tap answers directly using buttons (including multi-select and radio options) instead of replying with letters

  • This means cleaner data, quicker completions, and a smoother experience for everyone

Campaign Extender

You can redirect participants after they complete a survey:

  • Assign a pre-approved broadcast message to your campaign

  • The broadcast will be sent at the end of the survey

  • Provides respondents the option to either continue the conversation or click a link to be redirected elsewhere

  • Redirect options include another survey, a specific WhatsApp chat, or an external URL

  • Note: Only broadcast messages without variables are available for selection

External Panel Partner

Configure integration with external panel providers for recruitment.

Result Obfuscation

Options for anonymising or obfuscating respondent data in results.

Code Generation

Generate codes for internal tracking or research panel building purposes.

Screener Questions

Set up qualifying questions to screen participants based on specific criteria.


Launching Your Survey

Once your survey is ready:

  1. Click "Publish Campaign" in the top right corner

  2. Select your distribution method (WhatsApp links, Template Messages, etc.)

  3. Monitor responses in the "Results" tab

Buttons for multiple choice question
Burger menu or list for multiple choice question