Support Form Deflector

The form deflector attaches to any support form on your site. Before submission, it sends the user’s question to the form-deflect endpoint, and if BeforeQuery is confident it can resolve the issue, it shows the answer with sources in a modal:

“That answered my question” — the user dismisses without submitting a ticket.
“Continue to submit ticket” — the original form is re-submitted untouched.
Follow-up questions can be asked directly in the deflection modal.

Users are never blocked. If confidence is low (deflect: false) or the API call fails, the form submits normally.

Script-tag setup

No backend changes, no form HTML changes — just point at your form with CSS selectors:

<script
  async
  src="https://widget.beforequery.com/beforequery-widget.js"
  data-project-id="proj_xxx"
  data-client-key="bq_pk_..."
  data-deflect-form="#support-form"
  data-deflect-question-field="#description"
></script>

data-deflect-question-field accepts a CSS selector or a field name attribute value (e.g. message). Works with Zendesk, Freshdesk, Front, Jira Service Management, and custom HTML forms.

Programmatic setup

import { attachFormDeflector } from "@beforequery/widget";

attachFormDeflector({
  projectId: "proj_xxx",
  clientKey: "bq_pk_...",
  deflectForm: "#support-form",
  deflectQuestionField: "#description",   // CSS selector or field name
  primaryColor: "#343CED",                // optional
  colorScheme: "auto",                    // optional
});

Or via the window global:

window.BeforeQueryFormDeflector.attach({
  projectId: "proj_xxx",
  clientKey: "bq_pk_...",
  deflectForm: "#support-form",
  deflectQuestionField: "textarea[name=message]",
});

How the decision is made

The deflector calls POST /api/v1/public/projects/:projectId/form-deflect, which runs a non-streaming RAG pass and returns:

{
  "answer": "You can reset your password by ... [1]",
  "citations": [{ "index": 1, "url": "...", "title": "..." }],
  "confidence": 0.82,
  "deflect": true,
  "conversation_id": "conv_uuid"
}

deflect is true when confidence meets the threshold (default 0.55). Follow-ups use the normal chat SSE endpoint with thread_id set from conversation_id. Every deflection attempt is logged as a deflection trace and appears in your analytics, so you can measure exactly how many tickets never got filed.

Get Started

Knowledge Sources

Knowledge Connectors

Community Sources

Helpdesk Tickets

Deploy

Platform

Account Management

Support Form Deflector

Script-tag setup

Programmatic setup

How the decision is made

​Script-tag setup

​Programmatic setup

​How the decision is made

Script-tag setup

Programmatic setup

How the decision is made