Surveys

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.

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.

Survey Settings

Basic Configuration

Survey Priority

Priority is not set inside the editor. On the Surveys list, each card footer shows a Priority number with two arrow buttons beside it — 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.

Preview & Testing

Use the built-in preview to see how your survey will appear in the widget. The preview shows the survey flow and question types in your widget's chat interface.

Survey Responses

The survey editor's top bar carries a Responses button. It opens the survey's own responses page, which groups the answers by question and lets you narrow them to a date range.

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.

Date Range Filtering

Filter responses by date range to analyse 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: Communications → Tickets → (board) → Forms. There is no organisation-wide forms list any more, 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 behaviour 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 behaviour
• Responses are one-time data collection without follow-up actions
• You need to analyse trends, ratings, and aggregate insights from visitor responses