# Embage

> Build AI agents for your customers that talk, act, and analyse — on your website (chat and browser voice) and on Telegram.

Embage is an AI-powered agent platform that connects verified business knowledgebases, specialized subagents, real-time browser voice, structured Datastore records, and multi-channel customer communications without siloed infrastructure.

## Core Platform Pillars

### 1. Channels & Voice
- **Web Widget**: Chat via a lightweight `<script>` embed; browser voice via its own embed. Both are also available as hosted share links.
- **Browser Voice**: Speech-to-speech in the browser with live transcription and mid-sentence interruptions. No phone lines or SIP trunks needed. Not included on the Free plan.
- **Telegram**: Connect a Telegram bot. The agent answers from its instructions, saves contact details and hands off to your team; teammates can take over and run sub-agents from the inbox. Knowledge base search, AI Forms and app actions mid-conversation are available in website chat and voice only.
- *(Note: WhatsApp, Email, Discord and Slack are not conversation channels. Slack and Discord are supported as alert integrations.)*

### 2. The Orchestration Core & Subagents
- **Main Agent**: Real-time conversation coordinator that manages state, enforces system guardrails, and delegates tasks to background helpers.
- **Knowledgebase Subagent**: The knowledge base reaches the main agent through a sub-agent that has the knowledge base tool and is set to one knowledge base. It runs semantic (vector) search over content split into ~1,000-character sections from uploaded files (PDF, Word, PowerPoint, Excel, CSV, EPUB, text, Markdown), imported web pages (one URL per import) and pages written in the built-in editor, and returns the 10 closest passages. Scanned image-only PDFs are not supported.
- **Datastore Subagent**: Automatically extracts structured data fields (email, seat count, budget tier, intent, status) during dialogue and writes rows to your private Datastore table.
- **Integrations & Tools Subagent**: Executes actions in external SaaS applications (Shopify inventory, order status tracking, Google Calendar bookings, Gmail drafts).
- **Live Human Handoff Subagent**: Seamlessly escalates complex conversations to human operators with instant live notifications sent to the Embage dashboard.

### 3. Post-Conversation Intelligence
- Runs asynchronously after each session concludes.
- Computes an overall conversation score (0-100), outcome and sentiment.
- Generates high-level conversation summaries, action items, and topic tags.
- Identifies knowledge gaps and unanswered user queries for continuous improvement.

### 4. Enterprise Architecture & Security
- **Database-per-tenant isolation**: Every organization has its own private LibSQL/Turso database. Data never co-mingles across tenants.
- **Encryption**: Secrets, tokens, and credentials are encrypted at rest using AES-256-GCM.
- **Bring Your Own Key (BYOK)**: Connect your own OpenRouter or Vercel AI Gateway key per agent, so the agent's replies in chat, voice and Telegram don't use Embage AI credits. Sub-agents run on Embage credits; voice sessions, knowledge searches, AI Form writes and integration calls still follow the plan.

## Public Website & Documentation Routes

- **Homepage**: https://embage.com/ — Overview, interactive architecture infographic, live demo widget, dashboard mockup, and customer use cases.
- **Documentation**: https://embage.com/docs — Hub for all platform documentation.
  - **Getting Started**: https://embage.com/docs/getting-started — Quickstart from signup to a live widget.
  - **Architecture**: https://embage.com/docs/architecture — How a conversation turn is coordinated across the main agent and sub-agents.
  - **Multi-Channel Setup**: https://embage.com/docs/channels — Website chat and voice embeds plus a Telegram bot, and what each channel supports.
  - **Browser Voice Agent**: https://embage.com/docs/voice — Browser speech-to-speech with interruption handling and live transcription.
  - **Knowledge Base**: https://embage.com/docs/knowledgebase — Upload sources, semantic search through a knowledge sub-agent, knowledge gap detection.
  - **Subagents**: https://embage.com/docs/subagents — Focused helpers for knowledge search, datastore writes and connected-app actions.
  - **Datastore**: https://embage.com/docs/datastore — Structured record capture during conversations.
  - **Live Human Handoff**: https://embage.com/docs/handoff — Operator takeover on chat and voice with full context.
  - **Post-Conversation Workflows**: https://embage.com/docs/post-conversation — Scoring, summary, action items, and automated follow-ups.
  - **Website Embed SDK**: https://embage.com/docs/web-embed — Chat script, chat and voice iframes, share links, styling and allowed domains.
  - **Shopify, Gmail & Calendar Integrations**: https://embage.com/docs/integrations — Connected apps for lookup, booking, and follow-up.
  - **Security & Tenancy**: https://embage.com/docs/security — Database isolation, AES-256-GCM encryption, scoped permissions.
  - **Developer Reference**: https://embage.com/docs/api-reference — Embed snippets and share links. A public REST API and webhooks are not available yet.
- **FAQ**: https://embage.com/faq — Full searchable knowledge base answering questions across channels, security, subagents, and billing.
- **Features Hub**: https://embage.com/features — Overview of all platform capabilities.
  - **Voice Agent**: https://embage.com/features/voice-agent — Low-latency browser voice calls with interruption support.
  - **Knowledgebase**: https://embage.com/features/knowledgebase — Answers from your own documents and web pages, connected to the agent through a knowledge sub-agent.
  - **Datastore**: https://embage.com/features/ai-forms — Structured table intake without third-party form builders.
  - **Subagents**: https://embage.com/features/subagents — Background micro-agents for specialized execution.
  - **Website Embed**: https://embage.com/features/website-embed — One snippet for web chat and voice.
  - **Channels (Multi-Channel)**: https://embage.com/features/multi-channel — One agent across the website widget and Telegram, with the same knowledge and records.
  - **Human Handoff**: https://embage.com/features/human-handoff — Live operator takeover on chat and voice with the full transcript in context.
  - **Conversation Intelligence**: https://embage.com/features/conversation-intelligence — Automated transcript scoring and review.
  - **Choose Your Model**: https://embage.com/features/choose-your-model — Pick a managed model or bring your own OpenRouter / Vercel AI Gateway key per agent.
  - **Integrations**: https://embage.com/features/integrations — Shopify, Gmail, Google Calendar, HubSpot and 360+ apps through sub-agents.
  - **Security**: https://embage.com/features/security — Database isolation and scoped permissions.
- **Solutions**:
  - **Shopify**: https://embage.com/solutions/shopify — Product catalog lookups, stock availability, and tracking.
  - **Gmail**: https://embage.com/solutions/gmail — Automated email drafting, lead routing, and follow-ups.
- **Use Cases**: https://embage.com/use-cases — Real-world scenarios (E-Commerce, SaaS support, Inbound Sales, Scheduling).
- **Interactive Playground**: https://embage.com/playground — Test the live Chat and Voice widget.
- **Pricing**: https://embage.com/pricing — Transparent plan quotas and credit models.
- **Changelog**: https://embage.com/changelog — Chronological record of product releases.
- **Blog**: https://embage.com/blog — Technical articles and engineering deep dives.
- **Contact**: https://embage.com/contact — Team reach-out and sales inquiry.

## LLM Integration Context
- Primary entity: Embage (`embage.com`).
- Modalities: Chat (text) and Voice (speech-to-speech in the browser).
- Channels: Web Widget (chat + voice), Telegram.
- Backend stack: Cloudflare Workers, Hono, Durable Objects, LibSQL / Turso Drizzle ORM, Svelte 5 runes.