InnConnect Docs ← Back to InnConnect

Proactive Suggestions

Show targeted chat suggestions based on which page a visitor is viewing, how far they've scrolled, and what they've interacted with.

What are Page Context Rules?

Page context rules let you configure different AI and widget behaviour per page of your website. For each URL pattern you define, you can: show a proactive chat suggestion (a bubble that appears before the visitor opens the chat), give the AI a behaviour hint, and increase the relevance boost for matching knowledge base articles.

Rules are configured per site under Sites → Edit site → Page context tab.

Proactive Suggestions

A bubble appears above the chat button inviting the visitor to ask a specific question. Clicking it opens the chat and pre-fills the question.

AI Behaviour Hint

Add invisible context to the AI system prompt when a visitor is on a specific page. E.g. 'The visitor is on the pricing page — prioritise plan comparison.'

KB Article Targeting

Knowledge base articles can be linked to specific pages via the Page URLs field. InnConnect treats them as more relevant when a visitor is on that page.

URL Pattern Syntax

URL patterns are matched against the visitor's current page URL. The match is case-insensitive.

Pattern What it matches Example match
/aboutOnly this exact path./about
/products/*One path segment at the wildcard position. Does not cross slashes./products/t-shirt
/products/**Any number of path segments. Crosses slashes./products/t-shirt/blue
/**Every page on the site./contact, /about, /products/anything
Common mistake: /products/* matches /products/t-shirt but NOT /products/t-shirt/blue. Use /products/** to match all nested paths.

Suggestion Types

Type Description
questionA general question the visitor is likely to have on this page.
appointmentPrompts the visitor to book an appointment.
productHighlights a product or service relevant to the page.
customAny custom call-to-action text.

When Suggestions Appear

A suggestion can be shown immediately, or wait for a specific user action.

Trigger Description
Delay (seconds)Wait N seconds after page load before showing the suggestion. 0 = immediate.
Scroll Depth (%)Show the suggestion only once the visitor has scrolled past a certain percentage of the page. E.g. 50 = half-way down.
CSS Element SelectorShow the suggestion only when a specific HTML element (matched by CSS selector) becomes visible in the viewport. E.g. <code>#pricing-table</code> or <code>.product-gallery</code>.
Combining triggers: All configured triggers must be satisfied for the suggestion to appear. If you set both a scroll depth of 50% and a CSS selector, the suggestion shows only when both conditions are met.

AI Behaviour Hint

The AI behaviour hint is a text note added invisibly to the AI's context when a visitor is on a matching page. The visitor never sees it — only the AI uses it.

Use hints to guide the AI without changing the global system prompt. Example: on the /checkout page, add 'The visitor is about to pay. Reassure them about payment security and offer to help with any last questions.'

Targeting KB Articles to Pages

In Knowledge Base → Edit article, you can add Page URLs — a list of URL patterns this article is especially relevant to. When a visitor on a matching page asks a question, InnConnect boosts this article's relevance in the RAG search.

Example: An article titled 'Shipping times' is tagged with /checkout and /cart. Visitors on those pages who ask delivery questions will get this article prioritised in the AI's answer.

Global Settings

Setting Description
Enable proactive suggestionsMaster switch. When off, no suggestions are shown regardless of configured rules.
Default delayHow many seconds after page load before suggestions can appear (applies globally if no per-rule delay is set).
Max suggestionsMaximum number of suggestion bubbles shown at once. Default is 3.
KB relevance boostMultiplier applied to knowledge base article scores when the visitor is on a matching page. Higher values make page-targeted articles rank higher.
Visitor Insights: Go to Visitor Insights in the sidebar to see which pages visitors browse, how many sessions they have, and their topic interests. Use this data to decide which pages benefit most from proactive suggestions.