Public BetaJoin as a Founding User and lock in 50% off while the offer is active. Register and create AI agents

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.

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://unpkg.com/@bymos/[email protected]/agentkit-widget.iife.js"></script>
<script>
  window.AgentKit.init({
    agentId: 'your-agent-id',
    tenantId: 'your-tenant-id',
    apiBaseUrl: 'https://api.klicforge.ai',
  })
</script>
NPM

NPM package

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

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

bash
npm install @bymos/agentkit-sdk
javascript
import { init } from '@bymos/agentkit-sdk'

init({
  agentId: 'your-agent-id',
  tenantId: 'your-tenant-id',
  apiBaseUrl: 'https://api.klicforge.ai',
})
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.

Config options

The single config object passed to init() — identical for CDN and npm.

OptionTypeRequiredDescription
agentId
string
Required
Your agent ID or slug from the KlicForge dashboard.
apiBaseUrl
string
Required
Base URL of the KlicForge API — https://api.klicforge.ai, or your own host if self-hosting.
tenantId
string
Optional
Your tenant ID. Required for conversation tracking and widget validation.
user
{ externalId?, authId?, name?, email? }
Optional
Identity of the end user in your app. Omit entirely for anonymous sessions.
mode
'floating' | 'inline'
Optional
Widget display mode. Defaults to 'floating'.
title
string
Optional
Header title. Falls back to the agent's dashboard config.
streaming
boolean
Optional
Stream responses token by token. Defaults to true.
theme
{ mode?, accentColor?, fontFamily?, borderRadius? }
Optional
Visual overrides. mode is 'light' | 'dark' | 'system'.
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.

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