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:

Name
string required
A descriptive title for your survey. Only your team sees this name.
Widget
string required
Which chat widget this survey belongs to — and therefore which website it appears on. A brand has at most one chat widget, so in practice you are choosing the brand.
Published
boolean
Whether the survey is active and can be triggered for visitors. Visitors only get the survey while this is on.
Who gets it, and when
button
The conditions a visitor has to meet before the survey appears. The Edit trigger button opens them; the Trigger button in the title bar does the same.

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.

Always test your surveys across different devices and screen sizes to ensure questions display correctly and collect responses as expected.

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.

Responses are grouped by question type automatically, which makes it easy to compare different kinds of feedback and spot patterns.

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.

Forms on a board

How intake forms are built and managed on the board they file tickets on.

Boards and Tickets

Understand how form responses become tickets in your support workflow.

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
Forms create ongoing relationships through ticketing, while surveys capture snapshot insights from visitor interactions. Choose based on whether you need conversational follow-up or analytical data collection.

© 2026 Yaplet. All rights reserved.