KlicForgeKlicForge
Developer SDK · API Reference

Integrate in minutes.
Customise everything.

Add KlicForge to any website with one script tag. Or use the NPM package for full control inside your React, Next.js, or Vue app.

View docsNPM package

Three ways to integrate

Pick the method that fits your stack. All three use the same agent you configure in the dashboard.

CDN

Script tag

Best for: WordPress, Shopify, Webflow, any HTML site.

Paste two lines into your site's HTML. No build step, no dependencies.

html
<script src="https://cdn.jsdelivr.net/npm/@bymos/agentkit-sdk/dist/agentkit-widget.iife.js"></script>
<script>
  AgentKit.mount({
    agentId: 'your-agent-id',
    tenantId: 'your-tenant-id',
  })
</script>
NPM

NPM package

Best for: React, Next.js, Vue, or any JS framework.

Install the SDK, call AgentKit.mount() once, and you're done.

bash
npm install @bymos/agentkit-sdk
javascript
import AgentKit from '@bymos/agentkit-sdk'

AgentKit.mount({
  agentId: 'your-agent-id',
  tenantId: 'your-tenant-id',
})
REST API

REST API

Best for: Custom integrations, server-side usage, mobile apps.

The widget communicates with KlicForge over a documented REST API. Send messages, manage sessions, and receive streamed responses directly.

View API reference

Mount options

All options for AgentKit.mount() — works the same for CDN and NPM.

OptionTypeRequiredDescription
agentId
string
Required
Your agent ID from the KlicForge dashboard.
tenantId
string
Required
Your tenant ID from the KlicForge dashboard.
apiBaseUrl
string
Optional
Custom API base URL — use for self-hosted deployments.
mode
'floating' | 'inline'
Optional
Widget display mode. Defaults to 'floating'.
theme
object
Optional
Color overrides for the widget UI (primaryColor, backgroundColor, etc.).
Runtime intelligence

Memory + Intelligence APIs

Every conversation becomes structured memory and tenant-level events. Tap into them from your runtime, dashboard, or external pipelines.

Memory atoms

Per-contact second brain

Vector-indexed memory atoms scoped to each contact. Auto-injected into the runtime context-pack on every turn.

Scope: end_user · session · tenant

Intelligence events

Structured business signal

Every chat is parsed into typed events (orders, enquiries, complaints, topics). Query them with natural language or SQL.

Tenant-scoped · time-series ready

Graph relations

Connected context

Atoms, entities, and events linked via embeddings + LLM-classified relations. Drill from any node back to source chat.

pgvector + relation classifier

Full schema and runtime hooks documented in /docs.

Channel integration

Connect messaging channels from the dashboard — no code changes needed.

Telegram

Live

Deploy as a Telegram bot and handle customer conversations directly in Telegram. Set up your bot token from the dashboard in minutes.

Get started

WhatsApp Business

Live

WhatsApp Business API integration is live. Connect your WhatsApp Business account directly from the dashboard and start handling conversations with customers.

Get started
Coming soon

Want full control? Self-host the runtime.

The self-hosting deployment guide (Docker-ready) is coming soon. Contact us if you're interested in self-hosting KlicForge for your organisation.

Free plan available — no credit card needed

Your AI assistant is ready.
Are you?

Join businesses already saving hours every week with an AI that handles customer conversations around the clock.

Get started for freeSee how it works

Setup takes 10 minutes. Works on WordPress, Shopify, and any website.