WIDGETS

Embed an AI Chat Widget on Your Website

Add a fully functional AI assistant to any website with a single script tag. Connect it to your knowledge base and let your visitors get instant, citation-backed answers drawn from your own documents and data.

One-Line Install. Five Minutes to Live.

There is no SDK to configure, no build step to add, and no framework dependency to manage. You paste two small script blocks before your closing </body> tag, and the widget appears on your site immediately. The first block sets your widget key and preferred position. The second loads the runtime from Orckai's CDN.

The widget script is under 40 KB gzipped, loads asynchronously with the defer attribute, and will never block your page render. It works on static HTML sites, WordPress, Shopify, React SPAs, Next.js, and anything else that serves HTML to a browser.

  • No npm install, no build step, no dependencies
  • Async loading with zero impact on page speed
  • Works on any platform that renders HTML
  • Automatic updates from the Orckai CDN
Step-by-Step Guide
<!-- 1. Configure your widget -->
<script>
  window.ORCHESTRAI_CONFIG = {
    widgetKey: 'wk_your_widget_key',
    position: 'bottom-right',
    apiUrl:   'https://orckai.app/api'
  };
</script>

<!-- 2. Load the runtime -->
<script
  src="https://orckai.app/orchestrai-widget.min.js"
  defer>
</script>

Knowledge Base Answers with Automatic Citations

When a visitor asks a question, the widget does not just call an LLM and hope for the best. It runs a full RAG (Retrieval-Augmented Generation) pipeline against your connected knowledge base. Documents are processed, indexed with semantic vector search, and the most relevant passages are provided to the AI alongside the user's question.

Every answer includes inline citations in the format [Source: filename], so your visitors can see exactly which document each claim comes from. This builds trust, reduces hallucination, and gives your support team an audit trail they can verify.

  • Upload PDFs, Word docs, Excel spreadsheets, and 50+ file types
  • Semantic vector search for accurate retrieval
  • Automatic [Source: filename] inline citations
  • Secure document download through the widget interface
Widget Documentation
User:  What is your return policy?

Widget: Our standard return policy allows
returns within 30 days of purchase for
a full refund. Items must be in their
original packaging and unused condition.

For electronics, the return window is
14 days and a restocking fee of 15%
may apply.

[Source: return-policy-2025.pdf]
[Source: electronics-terms.docx]

Make It Yours

Every widget is fully customizable to match your brand identity and user experience requirements, without writing any CSS.

Custom Branding & Colors

Set your brand's primary color, logo, and welcome message directly from the Orckai dashboard. The widget automatically generates complementary hover states and dark/light theme variants so it looks native on any site, whether your background is white, dark, or somewhere in between.

Flexible Positioning

Place the chat bubble in the bottom-left or bottom-right corner of the viewport. The widget is responsive by default and adjusts gracefully on mobile screens, tablets, and desktops. It stays out of the way of your existing UI elements and only expands when the visitor clicks.

Prompt Templates

Define prompt templates to guide conversations in a specific direction. For example, you can configure the widget to always greet visitors with product-specific context, enforce a particular tone, or restrict answers to topics covered by your knowledge base. Templates are managed in the dashboard and update instantly.

Enterprise-Grade Security

Every widget interaction is authenticated, scoped, and auditable. Your data stays protected from the first request to the last.

API Key Authentication

Each widget is issued a unique API key with the wk_ prefix. Keys are SHA-256 hashed at rest and validated on every request. If a key is compromised, you can rotate it from the dashboard in seconds without touching your embed code. Old keys are invalidated immediately.

Per-Widget Permissions

Each widget is scoped to a specific knowledge base and prompt template. It cannot access data outside its assigned scope, even if someone reverse-engineers the API key. Organization-level row isolation in PostgreSQL ensures that widget requests never leak data across tenants.

Secure Document Downloads

When a citation references a source document, visitors can download it directly through the widget interface. Downloads are authenticated through the same API key and are served from organization-scoped storage paths, so there is no way to access files belonging to another organization.

Built for Real Use Cases

The Orckai widget is already powering AI assistants across customer support, internal operations, and product documentation.

Customer Support Bot

Upload your help center articles, FAQs, and policy documents into a knowledge base. The widget answers common questions instantly, reducing ticket volume and giving your support team time to focus on complex issues. Every answer cites the source, so customers trust what they read.

Internal Knowledge Assistant

Embed the widget on your company intranet or internal tools portal. Connect it to HR policies, engineering runbooks, onboarding guides, and operational playbooks. New hires find answers on day one instead of searching through Confluence. The citation trail means they always know which document to reference.

Product Documentation Helper

Place the widget alongside your product docs. When users search for a feature, the AI surfaces the relevant guide sections with direct citations. It handles follow-up questions with full conversation context, so users get a guided experience instead of bouncing between search results.

Industry Use Cases

See how teams across industries deploy Orckai widgets to automate conversations, deflect tickets, and capture leads — all grounded in their own data.

E-Commerce Product Assistant

Embed a widget on every product page to answer sizing, shipping, and return questions pulled directly from your product catalog and policy documents, freeing support teams to handle complex order issues.

Example: "Does this jacket run true to size, and can I return it if it doesn't fit?"

SaaS Onboarding Copilot

Place a widget inside your SaaS application to guide new users through initial setup, answer feature questions in context, and link directly to relevant documentation pages.

Example: "How do I connect my Slack workspace and set up automated notifications?"

Healthcare Patient Portal

Deploy a widget on your patient portal to answer questions about insurance coverage, appointment scheduling, and medication refills. Every response includes citation trails back to official policy documents, providing the auditability that healthcare compliance demands.

Example: "Is my annual physical covered under my current plan, and how do I schedule one?"

Real Estate Virtual Agent

Add a widget to property listing pages to answer visitor questions about square footage, neighborhood amenities, school districts, and mortgage estimates. The widget captures visitor leads and routes qualified prospects to your sales team automatically.

Example: "What are the HOA fees for this property, and are there good schools nearby?"

Enterprise-Grade Security & Control

Every widget interaction passes through five distinct security layers before reaching the LLM. This defense-in-depth approach means a single compromised layer cannot expose your data or allow abuse. Every conversation is logged, every visitor is tracked, and every token is budgeted.

  • 5-layer security — domain validation, per-widget rate limits, per-IP protection, daily token budgets, and input sanitization
  • JWT assertion authentication for verified user identity pass-through
  • Conversation audit trails with full transcripts and metadata
  • Geo-location tracking for visitor analytics and regional compliance
  • Custom branding to match your website's look and feel
  • Self-hosted deployment option for air-gapped or on-premises environments
Layer 1 — Domain Validation
Layer 2 — Per-Widget Rate Limits
Layer 3 — Per-IP Protection
Layer 4 — Daily Token Budget
Layer 5 — Input Sanitization
Request reaches LLM — fully validated and budgeted

Measurable Impact, Day One

Orckai widgets deliver concrete results across deployment speed, availability, and support efficiency.

Lower

Support Load

Help customers answer common questions before they become repetitive support tickets.

5 min

Deploy Time

From creating a widget in the dashboard to having it live on your website with a single script tag.

24/7

Always Available

Instant responses around the clock with no queues, no hold times, and no staffing constraints.

50+

Document Types

Upload PDFs, Word, Excel, PowerPoint, CSVs, Markdown, and dozens more into your knowledge base.

Explore More Features

Add AI to Your Website in 5 Minutes

Create a widget, connect your knowledge base, and paste the embed code. Your visitors get instant, cited answers from your own data.