Kulka Docs

Kulka documentation

Instructions for coding agents

Deterministic instructions for AI coding agents adding Kulka to a website.

Preferred integration

  • Use the versioned plain HTML loader unless the user explicitly requests the npm SDK and the package is verifiably published.
  • Ask the user for organizationId and, when applicable, agentId. Never invent either value.
  • Treat organizationId and agentId as public configuration, not secrets.
  • Insert the loader once. Preserve existing Content Security Policy rules and document required allowlist changes.
  • Do not recreate the chat UI locally; Kulka hosts and updates the iframe application.
htmlCopy-ready
<script
  src="https://kulka-support-app-widget.vercel.app/v1/widget.js"
  data-kulka-widget
  data-organization-id="YOUR_ORGANIZATION_ID"
  data-agent-id="YOUR_AGENT_ID"
  async>
</script>

Acceptance checks

  • The script appears exactly once in the rendered page.
  • The launcher is visible on public pages.
  • Opening the launcher loads the conversation interface without console errors.
  • SPA navigation does not duplicate the loader.
  • No private API key was added to client code.