Skip to main content
Pre-Chat Form configuration showing qualification questions and options

Pre-Chat Form

The Pre-Chat Qualification Form allows administrators to qualify widget users before they begin a conversation. When enabled, users are presented with a single question (e.g., “Who are you?”) and must select an answer. Each answer maps to a permission that determines which agents the user can access.

​
How It Works

  1. A widget user opens the chat for the first time (or on a new day).
  2. The qualification form is displayed with the configured question and options.
  3. The user selects an option.
  4. The system assigns the corresponding permission to the user.
  5. The user sees only the agents associated with that permission.
  6. The form response persists for the rest of the day. Returning users see the chat directly without repeating the form.

​
Configuring the Pre-Chat Form

Navigate to Settings > Pre-Chat Form in the admin panel.

​
Enable/Disable

Use the toggle to enable or disable the pre-chat form. When disabled, widget users go directly to the chat without seeing any qualification question.

​
Question Text

Enter the qualification question that will be displayed to widget users. For example:
  • “Who are you?”
  • “What best describes your role?”
  • “How can we help you today?”

​
Options

Each option represents a possible answer to the qualification question. For every option, configure:
  • Label: The text displayed to the user (e.g., “Customer”, “Partner”, “Employee”).
  • Permission: The permission assigned when the user selects this option. This determines which agents the user can access.
  • Order: The display order of the option in the form (lower numbers appear first).
Click Add Option to add more options. Click the trash icon to remove an option.

​
Authenticated Users (API Data Integration)

If a user already has permissions assigned — for example, via JWT authentication, auth token, or default logged-in permissions configured in the API Data Integration settings — the pre-chat form is automatically skipped. The form is only shown to users who have no permissions yet.

​
Prerequisites

Before configuring the pre-chat form, you need to have permissions set up in Settings > Access Control. Each option in the form must be mapped to an existing permission.

​
Deleting the Form

To remove the pre-chat form entirely, click the Delete Form button in the page header and confirm the deletion. This removes the form configuration and all its options.