> ## Documentation Index
> Fetch the complete documentation index at: https://docs.caplena.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The respondent experience

> What respondents see when they open a Caplena survey: a chat-style conversation they can answer by typing or by voice, on desktop or mobile.

> [!NOTE]
>
> Surveys is in **closed beta** and not yet available to all customers. [Join the waitlist](https://caplena.com/en/ai-survey-tool) to get access. The respondent experience may still change.

Caplena surveys feel like a conversation instead of a form. Questions arrive one at a time as chat messages, and answers appear as replies. This page describes what your respondents experience, so you know what to expect when you send a survey out.

![A survey in progress on a phone](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/respondent-mobile.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=3ea72b9530b9ba6a556e23fb851a9502)

## Start screen

When **Voice conversation** is on (default), respondents first see a start screen with your logo, the **start screen title** and the estimated time to complete. They choose how to answer:

* On **mobile**: **Start with voice** or **Type answers instead**
* On **desktop**: **Type answers** or **Voice mode**

![The start screen on desktop](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/respondent-start.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=05405d1e61f26c5bcce8f39617bd62d7)

The start screen says: "By clicking start you agree to your answers being processed."

When **Voice conversation** is off, respondents go straight to the first question.

## Answering questions

![Answering a matrix question on desktop](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/respondent-matrix.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=be2992ca3bbfed89cdc94b78493184a6)

* Each question appears as a message. Respondents answer with the buttons, sliders or pickers below the question, or by typing in the message box at the bottom.
* Choices, scales and ratings are saved as soon as they're tapped. Multi-select questions have an **Apply** button.
* Open-text answers are typed in the message box and sent with **Enter** (**Shift + Enter** adds a new line).
* Optional questions have an **N/A** button to skip them.
* Respondents can change their **most recent answer** with the edit icon next to it.
* The header shows progress as "Question 3 of \~8", plus a progress bar unless you've turned it off.
* Answers are saved continuously, so nothing is lost if the respondent closes the tab.

### Matrix questions

Matrix rows are shown one after the other in a single card. Answered rows collapse into a summary with the chosen value (for example **4 / 5**), so respondents can see their progress through the list and change a row with the edit icon.

### Follow-up questions

When [probing](https://docs.caplena.com/surveys/logic-probing-and-parameters.md#ai-follow-up-questions-probing) is on, a follow-up question may appear right after an open-text answer, in the same conversation. Respondents answer it like any other question.

![An AI follow-up question after an open-text answer](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/respondent-probing.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=a64ee61e102768b2c0b44f3265719e96)

## Answering by voice

Respondents can speak instead of typing in two different ways. Both are in the message box at the bottom of the survey:

![The microphone button and the voice mode button in the message box](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/respondent-voice-buttons.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=8d79b93deb0c53765d29e931faaf5370)

| | **Microphone** | **Voice mode** |
| - | - | - |
| **What it does** | Turns speech into text for **one** open-text answer | Runs the **whole survey** as a spoken conversation, hands-free |
| **Button** | Microphone icon | Round button with a sound-wave icon, or **Start with voice** / **Voice mode** on the start screen |
| **Works on** | Open-text and email questions | All question types: ratings, choices, open text, and so on |
| **How the respondent finishes** | Stops recording, checks the text, edits it if needed and sends it | Just keeps talking: the survey moves on by itself |
| **Tapping or typing** | Works as usual | Stops voice mode, and the tapped or typed answer is used |
| **Available when** | Always | Only if **Voice conversation** is on in the [survey settings](https://docs.caplena.com/surveys/build-your-survey.md#survey-settings) (on by default) |

### Microphone: dictate one answer

The microphone is a typing shortcut. The respondent taps it, speaks, and taps it again to stop. The spoken words appear as text in the message box, where the respondent can correct them before sending, just like a typed answer.

### Voice mode: talk through the whole survey

Voice mode turns the survey into a spoken conversation, a bit like a phone interview:

1. The respondent starts it with the sound-wave button, or with **Start with voice** (mobile) or **Voice mode** (desktop) on the start screen.
2. The microphone stays on. The respondent answers each question out loud and the survey moves on to the next one by itself.
3. Spoken answers are matched to the question automatically. For a rating, "I'd say a nine… actually, eight" is saved as **8**. For a choice question, the respondent can say the option in their own words.
4. For open-text questions and questions where several options can be picked, the respondent says **"next"** when they're done.

While voice mode is on, the message box shows a sound wave and what the respondent is saying, with buttons to **mute** the microphone or **exit** voice mode.

Voice mode stops when the respondent:

* **taps an option or types** an answer. The survey shows "Voice mode was stopped because you typed or selected an answer." and the answer is kept,
* edits an earlier answer, or
* stays silent for 30 seconds.

They can then continue by tapping and typing, or start voice mode again with the sound-wave button.

![Voice mode listening on a phone](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/respondent-voice.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=0fd7950a25014ffa79bbcd0eeb5361f7)

> [!NOTE]
>
> Turning off **Voice conversation** only removes voice mode and the voice options on the start screen. The microphone for dictating open-text answers stays available.

The browser asks for microphone permission the first time. If it's denied or not available, respondents are asked to type instead.

> [!TIP]
>
> For each answer, Caplena records whether it was **typed**, **spoken** or **mixed**, and whether the respondent chose voice mode, so you can compare these groups in your analysis.

## End of the survey

There's no submit button. When the respondent has answered the last question shown to them, the response is completed automatically. They see your **closing message**, and the header shows **Completed**.

![The completed survey with the closing message](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/respondent-complete.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=1fab975487615b8e5df792e9ffcbf67b)

## Branding and devices

* Your **logo**, **primary color** and **background** from [Branding](https://docs.caplena.com/surveys/build-your-survey.md#branding) are applied throughout.
* The survey is built mobile first and works in any modern browser on phones, tablets and computers. On phones, native date and country pickers are used.

## Data collected with each response

Besides the answers, each response includes:

| Field | Description |
| - | - |
| Response ID, survey ID, version | A unique ID for the response, and which survey and [version](https://docs.caplena.com/surveys/review-and-publish.md#how-versions-work) it belongs to |
| Status | Complete or partial |
| Start, end and recorded date | When the respondent started and finished, and when the response was added to your project |
| Language | The language the survey was shown in |
| Input, voice mode selected | Whether the respondent typed or spoke their answers, including the raw transcript of spoken answers, and whether they chose voice mode |
| Device, browser | The respondent's device type and browser |
| Country, city, timezone, locale | Where the respondent was, based on their internet connection, and their browser's time zone and language and region settings |
| IP address | The respondent's IP address |
| URL parameters | Any [parameters](https://docs.caplena.com/surveys/logic-probing-and-parameters.md#url-parameters) passed in the link |

> [!WARNING]
>
> Responses can include personal data, such as IP addresses, email addresses, URL parameters or what respondents write and say. Project [anonymization](https://docs.caplena.com/get-started/project-settings/anonymization.md) only applies to **text to analyze** columns, such as open-text answers. The IP address, email answers, URL parameters and the input column with raw voice transcripts are **not** anonymized.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.