Embedded Chat Box

Use the Chat Box URL to embed a full-page Knoon chat experience into any mobile or desktop app. This is useful when you want a dedicated “Support” or “Ask AI” page without integrating the floating ChatKit widget.

1. Requirements & notes

• The Chat Box URL is only available when the Knowledge Base is set to Public or Protected.

  • If your knowledge base is Private, you will not see the “Chat Box URL” option.

• Each Chat Box has its own unique URL. You can create multiple chat boxes under the same knowledge base (for support, sales, etc.) and embed each one separately.

• The URL works both:

  • As a normal link (open in a new tab), or

  • Inside an <iframe> so the chat lives inside your page.

2. Get your Chat Box URL

1. Go to Knoon > Knowledge in the left sidebar.

2. Select the “Knowledge Base” that you want to use.

3. Under “Chat Boxes”, find the chat box you want to embed.

4. Click the more menu (⋮) on the right of the chat box.

5. Choose “Chat Box URL”.

A dialog appears showing the full URL, for example:

https://domain.com/chat/1Mlt0C03hCKs0NR49AQr

• Click the copy icon to copy the URL.

• Optional: Toggle “Automatically start conversation” if you want the chat to open straight into an active conversation instead of waiting for the first user message.

3. Optional query parameters

The Chat Box URL accepts query parameters to tweak behavior.

hello (boolean)

• Purpose: Show the conversation screen with a “hello” message instead of the default login screen (when applicable).

• Type: boolean

• Examples: https://example.com/chat/1Mlt0C03hCKs0NR49AQr?hello=true

4. Using the Chat Box URL with Custom Sign-In

If you are using Custom Sign-In, you can start a session and then load the Chat Box URL so that users are already authenticated when they arrive.

Follow the Custom Sign-In guide to:

1. Call your backend endpoint.

2. Retrieve the credentials for the chosen chat box.

After successful sign-in, you should have the following query parameters set for the specific chat box:

• knoon_contact_session_jwt_<chatBoxId>

• knoon_contact_session_jwt_expires_at_<chatBoxId>

• knoon_contact_session_jwt_domain_<chatBoxId> (stores the cookie domain you used, e.g. .example.com)

NOTE
<chatBoxId> must match the ID in your Chat Box URL.

Once these query parameters are present and valid, construct the Chat Box URL to reuse the existing session and the user will be treated as signed in.

• Examples: https://example.com/chat/1Mlt0C03hCKs0NR49AQr?knoon_contact_session_jwt_1Mlt0C03hCKs0NR49AQr=<jwt>&knoon_contact_session_jwt_expires_at_Mlt0C03hCKs0NR49AQr=<datetime>&knoon_contact_session_jwt_domain_1Mlt0C03hCKs0NR49AQr=<domain>