Surveys
Surveys are interactive engagement campaigns that collect structured feedback and data from your website visitors through a conversational form shown in your chat widget. They appear as a guided question-and-answer flow inside the chat interface.
How Surveys Work
Surveys are delivered through your existing chat widget, appearing as an interactive conversation that guides the visitor through a series of questions. Unlike banners or chat messages, which are one-way, surveys collect answers and store them for analysis — useful for structured feedback, research, or qualifying leads.
The Surveys List
Click Add Survey to create one: choose New Item to start from scratch, or pick one of the ready-made templates.
The Surveys list opens as a table with one row per survey, and two buttons at the top right switch between List view and Card view (Yaplet remembers your choice in this browser). A strip of numbers above it shows how many surveys are Live and how many are Drafts, plus three figures for the last 30 days: Shown · 30 days, Answered · 30 days and the Engagement rate, which is all answers divided by all times shown. The All, Live and Draft buttons narrow the list by state, and you can search, filter by widget and sort.
Each row shows the priority arrows, a tile, the survey name and a line with its number of questions and its welcome message, a switch with a Live or Draft badge (flip it to put the survey live or turn it off right from the list), the widget, Shown, Answered and Rate for the last 30 days, the creation date, Responses, Reports and Edit buttons, and a ⋯ menu with Edit, Reports, Responses, Duplicate and Delete. In Card view, every card shows the number of questions and the welcome message, the name, widget, a Live/Draft badge, the creation date and a one-line performance summary: how many people the survey was shown to, how many of them answered it, and what share that is. Hover any figure for the full sentence. A survey nobody saw in that period says so instead of showing zeros.
The Responses and Reports shortcut buttons — hover them to see which is which — let you open either page straight from the list instead of going through the editor.
Editing a Survey
The survey editor is a full-screen builder. The step list sits on the left, with Survey settings pinned as its first row, the Preview in the middle, and the editor for the selected step on the right. The title bar carries the survey name and these buttons: Preview (opens the survey on its own page in a new tab), Responses, Reports, Trigger, Settings, and the save controls. Unsaved changes appears with Discard and Save changes as soon as you edit something, and leaving with unsaved edits asks first.
Triggering Surveys
Surveys can be triggered by events and conditions such as page visits, time-based rules or custom events sent from your application. For details on configuring them, see the trigger documentation.
Trigger Configuration
Learn about all available trigger options and how to configure them for your surveys.
Survey Settings
Basic Configuration
Open Survey settings — the first row of the step list, or the Settings button in the title bar — to see these fields:
Survey Priority
Priority is not set inside the editor. On the Surveys list, use the up and down arrows at the start of each row — or, in Card view, the two arrow buttons beside the Priority number in the card footer. Hover them for Increase priority and Decrease priority. When several surveys qualify for the same visitor at the same moment, only the heaviest one is shown.
Form Builder
Learn how to use the form builder interface to create and customize your surveys with different input types, validation rules, and question configurations.
Preview & Testing
Use the Preview in the middle of the editor to see how the selected step will look. The preview shows the survey flow and question types as visitors see them. The Preview button in the title bar opens the whole survey on its own page in a new tab.
Testing engagement campaigns
Learn how to safely test your campaigns before letting them reach live visitors.
Survey Responses
The survey's own responses page groups the answers by question and lets you narrow them to a date range. Open it either from the Responses button on the survey's row or card in the list, or from the Responses button in the survey editor's title bar. The Responses and Reports pages share a switcher at the top with a Responses view and a Reports view, and the back arrow on both returns to the survey editor.
Response Analytics
Text answers: individual responses in a table, with submission timestamps and visitor IDs.
Rating scales: the average rating, the highest and lowest scores, and how the answers are distributed across the scale.
Choice questions: the distribution of answers with percentages and vote counts, for both single and multiple choice.
File uploads: a card per uploaded file with a View File button that opens it in a new tab, plus an All Files table listing the file URL, upload time and visitor ID.
Reaching the Person Who Answered
Every answer row shows the visitor's ID with two shortcut buttons beside it:
- Open their chat — opens that visitor's conversation in the inbox. If they only ever filled in the survey and never chatted, a conversation is started for them, so you can reply either way. Needs the Inbox permission.
- Security profile — opens the visitor's security profile: trust score, ban state, devices, addresses and past sessions. Needs the Security permission.
Both buttons disappear when the response has no visitor left — an erased anonymous visitor takes the link with them, while the answers themselves are kept.
Date Range Filtering
Filter responses by date range to analyze how the survey performed over a specific period. The default view shows the last 7 days.
Forms vs Surveys
Forms and surveys are technically similar — both are guided interfaces that collect structured information — but they serve different purposes and end up in different places.
How Forms Work
A form is started either by the visitor clicking a form entry in your chat widget, or by an agent asking for it during a conversation. A submitted form becomes a ticket on the board the form belongs to. Forms live on that board: Conversations → Tickets → (board) → Forms. There is no organization-wide forms list, and there is no separate Forms purchase — forms come with the Feedback boards & bug tracker add-on, together with tickets and boards.
How Surveys Differ
Surveys behave like the other engagement campaigns — they fire automatically based on visitor behavior and interactions with your website, such as page views, time spent, or custom events. The answers flow into the survey's own responses page for analysis. They do not create tickets and do not enter a support workflow.
When to Choose Forms vs Surveys
Choose Forms when:
- You need structured ticketing and support workflows
- Agents should be able to request form completion during conversations
- Users need to initiate contact through self-service forms
- You want responses to have a lifecycle with follow-up actions, decisions, and resolution messages
Choose Surveys when:
- You're gathering research data or feedback for analysis
- You want to proactively collect information based on user behavior
- Responses are one-time data collection without follow-up actions
- You need to analyze trends, ratings, and aggregate insights from visitor responses