Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

The Chatbot Widget is a bare public page for iframe embedding at the route /chatbot/widget.

​
Overview

The page loads at /chatbot/widget?configId=<id> and renders a ChatWindow inside a bare layout with no sidebar or top navigation, making it suitable for iframe embedding on external websites. On mount it calls the chatbot-session Edge Function with the configId, visitor ID (generated or retrieved from storage), and source URL to create a session. The ChatWindow then uses this session for conversation. If configId is missing or the session creation fails, an error state is shown.

​
Who it’s for

No explicit permission gate on this route (public route in src/routes/public.tsx).

​
Before you start

  • A valid configId query parameter must be supplied (generated from Chatbot Settings embed code).
  • This page is accessed via an iframe embed on external websites, not directly by staff.

​
Steps

1

Embed on external site

Paste the iframe snippet (from Chatbot Settings → Embed Code) into your website HTML.
2

Widget loads

The widget fetches config via the chatbot-session Edge Function using the configId parameter.
3

Visitor interacts

The visitor types messages in the ChatWindow and receives responses.

​
Key concepts

  • configId — query parameter identifying which chatbot configuration to load
  • chatbot-session — Edge Function that initializes the conversation session
  • Visitor ID — anonymous identifier persisted for session continuity

Platform Foundation

Platform Foundation overview.

Governance & parity

Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/public.tsx
  • src/platform/chatbot/widget/ChatbotWidgetPage.tsx