Open widget.amargicreative.com and click "New publication". Pick the source: an Agents agent, a Reach Webchat channel, or an Escalate form or KB.
Amargi Widget Builder.
The single-snippet embed surface for the Amargi suite. Each publication pairs a source (an Agents agent, a Reach Webchat channel, or an Escalate form or KB) with a UI theme and a public key. Paste one script tag on your site and a ready-made chat bubble appears.
The bundle is fully served from the Amargi domain, about 40 KB per theme (gzip), loaded from the Amargi CDN, CORS-open. The JWT is minted per-visitor at runtime, so no secrets live in the HTML.
Quickstart (3 steps)
The three steps mirror the in-app builder wizard, so docs and product stay in sync. You can ship a working bubble in under five minutes.
Pick a UI theme (Classic, a speech bubble; Modern, a rounded panel; Minimal, a slim pill). Live preview is inline in the editor.
Open the workflow that drives it in the Workflow Builder, click Embed, and copy the snippet. Paste it before the closing body tag on your site. The bubble appears in under five minutes.
The snippet
<script
src="https://agents-api.amargicreative.com/sdk/react/amargi-widget.umd.js"
data-key="wid_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
data-view="full"
defer
></script>Copy it from the Embed panel on your workflow: that is where publishing lives, and it fills in both attributes for you. data-key identifies the widget, and data-view the layout it renders. Design the layouts themselves in the Widget Builder.
Key concepts
Publication
The core configuration unit. Pairs one source, one theme, one public key, an allowed-origin list, and an active or paused flag. Change the theme, the origin list, or the active status without touching code on your site. Each publication has an editor page with tabs: General, Snippet, Origins, Analytics.
Source
Agents enables AI mode (the widget talks to an Agents agent with all the usual AI-safety rails: RAG, tool-calls, human handoff). Reach enables live chat (a Reach Webchat channel, so the visitor chats with a human in the Reach inbox). Escalate enables form plus KB-search modes (the form creates a ticket on submit; KB-search surfaces articles before the visitor types).
UI Theme
Classic (v1) is a friendly speech-bubble glyph with moderately rounded corners. Modern (v2) is a rounded panel with very soft corners, brand-forward, the default for new publications. Minimal (v3) is a slim pill with a "Chat with us" label next to the icon, premium and looks un-Amargi-branded.
Allowed origins
A list of HTTPS origins allowed to load the publication. An empty list means any origin (the default). A non-empty entry enforces a strict whitelist, supporting full origins (https://example.com), wildcard patterns (*.example.com), or bare host names (example.com). Off-list origins get a silent 204 instead of the config payload.
Funnel analytics
Every publication tracks three lifetime counters: loads_total, opens_total, and messages_total. The first bumps on every widget-config fetch (a page-load with the script tag). The second bumps on bubble-click. The third bumps on first message send. Conversion rates between each stage surface in the editor's Analytics tab.
Common tasks
Change the theme after publishing
- Open the editor, General tab.
- Switch the "UI theme" radio, the editor auto-saves.
- The Snippet tab will show the updated SDK path (v1 / v2 / v3). Copy it to your site once.
Restrict a publication to specific domains
- Origins tab, add each origin on its own line.
- Use *.example.com to match every subdomain.
- Changes take effect immediately, no re-publish needed.
Pause a publication
- General tab, change the status to "Paused".
- A paused publication 404s on the resolver. The widget fails silently on your site (no bubble), the visitor sees no error.
- Resume with "Active" anytime.
Delete a publication
- Delete is soft, it sets the deleted_at column in the database, so the resolver stops serving the config but the row is retained for audit.
- To restore a deleted publication, contact support.
Embed reference
SDK path
https://agents-api.amargicreative.com/sdk/react/amargi-widget.umd.jsThe bundle. One path for every layout: the look and the layout come from your widget, not from the URL./sdk/v1 … /sdk/v4Retired. These still answer for embeds pasted long ago, but they serve an older build. Do not use them in new snippets.Supported script attributes
data-keyRequired. The widget key (wid_...), or the workflow handle (wf_...) when one workflow drives a single widget.data-viewThe layout to render: the style id from the workflow's Embed panel, or a kind slug (full, basic, sidebar). Omit it and you get the widget's default.deferRecommended. Loads the bundle after HTML parsing.Integration with other products
Agents
AI mode invokes an Agents agent with all the usual AI-safety rails. If the agent emits a human_handoff action, the widget transitions to Live mode (if enabled) and hands the transcript across.
Reach
Live mode connects to a Reach Webchat channel. The conversation lands in the Reach inbox like any other thread: assignments, internal notes, replies.
Escalate
Form mode creates an Escalate ticket on submit. KB-search mode surfaces published articles. A create_ticket action from an Agents agent transitions the widget to Form mode (if enabled) with the transcript pre-filled in the first textarea.
Ready to embed your first widget?
Tell us which source and theme fit your site and we will point you to the exact snippet. Or request access and we will get you set up.