# Pre-chat survey for visitors

Ask visitors for contact details and an initial question before chat, using reusable forms with configurable expiry.

*Release 3.3 · admin, operator, visitor*

**Settings › Chat › Pre-Chat Survey** · **Settings › Chat › Themes**

## What it is

A pre-chat survey asks visitors for details before ordinary chat starts. You can collect contact information, an initial question and custom answers. Reusable surveys can have different wording, department choices and expiry rules.

## Who uses it and why

People with the **Settings** role decide which details to ask for and when to ask again. Visitors provide those details before continuing. Operators use the submitted information to understand the request and identify the visitor.

## Where to find it

With the **Settings** role, open **Settings › Chat › Pre-Chat Survey** to manage definitions. Select a survey in **Settings › Chat › Themes**, under **General › Settings**.

## How it works

When live assistants are available and a new chat needs intake, INSIDE displays the configured survey. An active chat normally bypasses it, although a visitor event can request another survey. Privacy consent can be required first, and a chat link can disable the survey for that entry path.

Visitors fill in the enabled fields and select the start-chat button. Required answers, invalid email addresses, invalid phone numbers, a required department or an unaccepted disclaimer can prevent submission. The form blocks repeated submission while it processes the request. After acceptance, chat continues or a configured pre-chat task starts.

Previously saved values can prefill fields. Expiry controls how long completion remains valid:

- **Never** keeps completion valid for the recognised visitor without a session-end or chat-end reset.
- **Session End** asks again after the visitor's session expires.
- **Chat End** asks again after chat ends, when the visitor returns to the pane or navigates and starts again.

## Configure it

Create or edit a survey and enter **Prechat Survey Name**. Under **Default Fields**, enable the details you need and select **Required** beside each answer you must collect. Add translated labels, **Pre-Chat Header Text** and **Start Chat Button Label**.

Use **Custom Fields** for additional questions and **Disclaimer/Department** for a disclaimer and department choices. Select **Pre-Chat Survey Expiry**. Where calling is enabled, configure **Start A Call** and **Call Type**. CRM creation options appear only for the relevant enabled integration.

Save the survey and select it in the relevant theme, or use **Set as Default** in the survey list. Setting a default clears the previous default. **Unset as Default** can leave the website without a default survey.

### Settings

| Setting | Where | Applies to | Default | Who can change it | What it does |
|---|---|---|---|---|---|
| Pre-Chat Survey | Settings › Chat › Themes › General › Settings | website | Not set: use the website's default survey if one exists | Settings role | Choose a reusable survey for the theme; the website's default survey can apply when no specific survey is selected. |
| Pre-Chat Survey Expiry | Settings › Chat › Pre-Chat Survey | website | Never | Settings role | Keep completion valid indefinitely for the recognised visitor, until Session End, or until Chat End. |
| Ask for Full Name | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Include the visitor's full name in the form. |
| Ask for Email | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Include an email address field. |
| Ask for Phone | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Include a phone field with country-aware number validation. |
| Ask for Company | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Include a company field. |
| Ask a Question | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Ask for the visitor's initial question before ordinary chat. |
| Required | Settings › Chat › Pre-Chat Survey | website | Off for each standard field | Settings role | Require an answer for the associated enabled name, email, phone, company or question field. |
| Show Field Labels | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Show labels above the fields rather than as inline placeholders. |
| Show Disclaimer | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Display the configured Chat Disclaimer on the intake form. |
| Visitor must agree to disclaimer | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Block submission until the visitor accepts the displayed disclaimer. |
| Start A Call | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Start the audio or video call sequence through the pre-chat form. |
| Call Type | Settings › Chat › Pre-Chat Survey | website | Default Video Settings | Settings role | Use Default Video Settings or select 2-Way Video Call, 1-Way Video Call or Audio Call. |
| Do not allow Chat during Call | Settings › Chat › Pre-Chat Survey | website | Off | Settings role | Prevent ordinary chat during a call started through this survey. |
| Pre-Chat Header Text | Settings › Chat › Pre-Chat Survey | website | Not set: no custom introduction | Settings role | Supply the visitor-facing introduction in each configured language. |
| Start Chat Button Label | Settings › Chat › Pre-Chat Survey | website | Start Chat in English; translated for other languages | Settings role | Supply the text on the form's start-chat button. |
| Chat Disclaimer | Settings › Chat › Pre-Chat Survey | website | Not set: no disclaimer text | Settings role | Supply the disclaimer displayed when Show Disclaimer is enabled. |
| Agree Text | Settings › Chat › Pre-Chat Survey | website | I Agree | Settings role | Supply the label for the disclaimer acceptance control. |

### Fields

| Field | Where | Required | What it is for |
|---|---|---|---|
| Prechat Survey Name | Settings › Chat › Pre-Chat Survey | Yes | Name the reusable definition, using 1 to 50 characters after surrounding spaces are removed. |

### Permissions

| Permission | Lets you |
|---|---|
| Settings | Create and edit reusable pre-chat surveys, their defaults and theme selection. |

## Limits and good to know

- Survey names must contain 1 to 50 characters after trimming surrounding spaces.
- If **Ask a Question** is enabled, saving requires its question text in the website's default language.
- Clearing **Show Department** also clears its forced-selection and dropdown options when saved.
- Clearing **Start A Call** clears **Do not allow Chat during Call** when saved.
- **Never** does not mean the same person will be recognised on another browser or device.
- Communication opt-ins are separate from permission to begin chat.

## Depends on and works with

### This feature uses

- **Requires** [Visitor chat pane](VX-002.md): The pre-chat survey is displayed within the visitor chat pane.
- **Configured in** [Visitor event rules and actions](ENG-001.md): Visitor events can select a different pre-chat survey or task.
- **Configured in** [Visitor chat themes and branding](VX-003.md): The theme selects and presents the pre-chat survey.
- **Configured in** [Visitor tracking consent and communication opt-ins](VX-012.md): Privacy consent can precede intake; disclaimer acceptance and communication opt-ins have separate purposes.
- **Configured in** [Chat links for visitors](VX-024.md): A chat link can disable pre-chat intake for its entry path.
- **Works better with** [Contact matching](CRM-003.md): Submitted contact details can help identify or match a contact.
- **Works better with** [Salesforce leads and Zendesk contact creation](CRM-013.md): Enabled CRM creation options can create a lead from intake details.
- **Works better with** [Visitor identity](VIS-001.md): Browser recognition lets returning visitors reuse valid survey completion and saved details.
- **Works better with** [Department selection before chat](VX-009.md): A survey can include department selection.
- **Works better with** [Custom fields in visitor forms](VX-010.md): Custom fields add structured questions and validation.
- **Works better with** [Joining calls and approving Co-Browse](VX-026.md): A survey can start an enabled audio or video call.
- **Works better with** [Visitor chat languages and text direction](VX-031.md): Survey labels, text and custom choices support language variants.
- **Related** [Starting, ending and expiring chats](CHAT-001.md): Chat End survey expiry asks for intake again after the conversation ends.
- **Related** [Visits and returning visitors](VIS-002.md): Session End survey expiry follows the visitor session rather than each page load.
- **Related** [Visitor chat status and waiting](VX-007.md): Availability and an existing conversation affect whether the pre-chat survey appears.

### Used by

- **Configures** [Chat accessibility and keyboard navigation](VX-005.md): Pre-chat survey settings control persistent field labels and the wording used to name form controls.
- **Configures** [Visitor messages and sending feedback](VX-006.md): Required pre-chat intake can precede ordinary messaging.
- **Configures** [Department selection before chat](VX-009.md): Pre-chat survey settings control department selection in the current pane.
- **Configures** [Custom fields in visitor forms](VX-010.md): Pre-chat surveys define their custom questions and requiredness.
- **Configures** [Visitor tracking consent and communication opt-ins](VX-012.md): Pre-chat supplies the distinct email and text opt-in controls.
- **Configures** [Chat links for visitors](VX-024.md): Configured pre-chat forms or tasks can gate chat entry.
- **Configures** [Joining calls and approving Co-Browse](VX-026.md): Pre-chat can request audio or video permission and control text-chat availability during the call.
- **Configures** [Previous chat history for visitors](VX-033.md): A visible pre-chat form with conversation-end or session-end expiry can defer earlier-history loading.
- **Configures** [Browser video and audio calls](RTC-017.md): Pre-chat survey settings can start an audio or video call and restrict text chat during it.
- **Configures** [Salesforce leads and Zendesk contact creation](CRM-013.md): Pre-chat intake controls automatic CRM capture.
- **Enhances** [Chat links](CHAT-030.md): A link can invoke the configured pre-chat survey or task.
- **Enhances** [Visitor chat themes and branding](VX-003.md): A pre-chat survey adds an intake form to the themed visitor experience.
- **Enhances** [Chat tasks and topics for visitors](VX-017.md): A following task can reuse details collected by the pre-chat survey.
- **Enhances** [Legacy chat pane settings](VX-032.md): Older panes support pre-chat with version-specific behaviour.
- **Enhances** [Proactive chat invitations](ENG-004.md): Clicking an invitation can open pre-chat intake.
- **Enhances** [Virtual Assistant task setup](ENG-009.md): A pre-chat survey can collect details before a task starts.
- **Enhances** [Virtual Assistant task steps and branches](ENG-011.md): Pre-chat intake can use a task before a conversation begins.
- **Enhances** [Contact matching](CRM-003.md): Pre-chat forms can supply identifying information.
- **Enhances** [Customer survey and NPS reports](REP-010.md): Pre-chat intake supplies the Pre-Chat Survey report.

## FAQ and troubleshooting

### Why is the survey not appearing?

Check the selected theme, survey expiry, existing chat and assistant availability. A chat link or visitor event can change the intake path.

### Why is a visitor asked again?

Check whether expiry is **Session End** or **Chat End**. The visitor may also have a new browser identity, or an event may request another survey.

### Why will the form not submit?

Check the highlighted required fields, email and phone format, department choice and disclaimer acceptance.

### Can I show different forms to different visitors?

Yes. Themes and visitor events can select different reusable surveys. Maintain the language variants for each one.