Skip to content

OfficialBoomi/embedkit-cdn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 

Repository files navigation

@boomi/embedkit-cdn

CDN distribution package for Boomi EmbedKit — the pre-built JavaScript bundle that lets you embed Boomi AI Agents into any website with a few lines of HTML. No React, no npm, no build pipeline required.


What Is EmbedKit?

Boomi EmbedKit is a React component library that surfaces Boomi AI Agents inside any web application. It handles authentication, session management, real-time streaming, and rendering of the full agent chat UI — all inside a Shadow DOM so it never conflicts with your existing styles.

EmbedKit comes in two forms:

Package Use case
@boomi/embedkit React apps — import components and hooks directly
@boomi/embedkit-cdnthis package Any website — drop in a <script> tag, no build step needed

What Is This Package?

This package contains the pre-built CDN distribution files for EmbedKit:

File Description
embedkit-cdn.umd.cjs UMD bundle — works in all browsers via a <script> tag
embedkit-cdn.css Required stylesheet

React and ReactDOM are bundled in — nothing else is required on the host page.

The files are served via public CDN providers:

  • jsDelivr: https://cdn.jsdelivr.net/npm/@boomi/embedkit-cdn/
  • unpkg: https://unpkg.com/@boomi/embedkit-cdn/

Quick Start

Add the following to any HTML page, just before </body>:

<!-- 1. EmbedKit Stylesheet -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@boomi/embedkit-cdn/embedkit-cdn.css" />

<!-- 2. Configure the embed -->
<script>
  window.BoomiEmbed = {
    publicToken: "pk_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    agentId:     "project_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    mountId:     "boomi-agent",
    serverBase:  "https://api.boomi.space/api/v1"
  };
</script>

<!-- 3. Load the bundle -->
<script src="https://cdn.jsdelivr.net/npm/@boomi/embedkit-cdn/embedkit-cdn.umd.cjs" async></script>

<!-- 4. Mount target -->
<div id="boomi-agent"></div>

The agent UI will automatically initialize and render inside the boomi-agent div.


Configuration

Property Type Required Description
publicToken string Yes The pk_... public token from your project in Admin Console
agentId string Yes The project ID from Admin Console
serverBase string Yes EmbedKit API base URL: https://api.boomi.space/api/v1
mountId string No ID of the <div> to mount into. Defaults to "boomi-agent"
userId string No Identifier for the current user (for session tracking / analytics)
autoInit boolean No Set to false to disable automatic initialization. Default: true

Getting a Public Token

Tokens and projects are managed through the EmbedKit Admin Console at admin.boomi.space. See the full setup guide in the EmbedKit documentation.


Documentation

Full documentation for EmbedKit — including the CDN configuration guide, project setup, embed types, theming, and API reference — is available in the main repository:

github.com/OfficialBoomi/embedkit


Content Security Policy

If your site uses a CSP, add the following directives:

script-src  'self' https://cdn.jsdelivr.net;
style-src   'self' https://cdn.jsdelivr.net;
connect-src 'self' https://api.boomi.space;

About

CDN packages for embedkit.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

No contributors