Chat Widget

Embed an AI-powered chat widget on any website with a single <script> tag. Visitors chat directly with your agent without leaving your page.

Quick start

Enable the widget for your agent in the admin panel (Admin → Agents → Edit → Embeddable Chat Widget). Add the origin of every site that will embed the widget (e.g. https://yourshop.com).

Copy the snippet from the same section and paste it into your site's HTML, anywhere in <head> or <body>:

<script src="https://app.tirelesscrew.com/embed.js" data-agent="YOUR_EMBED_KEY" async></script>

A chat bubble appears in the bottom-right corner of your page. Visitors click it to open the chat panel and start talking to your agent.

No build step required. The loader script is plain JavaScript — paste it into any HTML page, CMS, or website builder.

Origins requirement

For security, the widget only loads on domains you explicitly allow. Add each allowed origin (scheme + host + optional port) in the admin panel. Wildcards and paths are not supported — use the exact origin string:

Correct	Incorrect
`https://yourshop.com`	`https://yourshop.com/` (trailing slash)
`https://shop.example.com`	`https://*.example.com` (wildcard)
`https://example.com:8080`	`https://example.com:8080/path` (has path)

Requests from unlisted origins receive a 403 response — the widget will not render on those pages.

Daily cost ceiling

You can set a per-day spend limit for the embedded widget. Once the cumulative cost of all widget-initiated runs reaches the ceiling, new messages return a friendly "temporarily unavailable" notice and no further agent runs are created until the next UTC day.

The ceiling is per-agent, not per-visitor. The default is set by the platform administrator. Leave it blank in the admin panel to use the platform default.

Wallet balance matters too. If the agent owner's credit wallet reaches zero, the widget also becomes unavailable regardless of the daily ceiling. Top up credits from the dashboard.

Regenerating the embed key

Each agent has a unique embed key embedded in the snippet URL. You can regenerate it at any time from the admin panel. Regenerating immediately invalidates the old key — any site still serving the old snippet will show a broken widget until the snippet is updated.

Privacy & data

Visitor messages are processed by your agent just like any other run — subject to your system prompt and tools.
No authentication is required from visitors. Sessions are anonymous and identified by a hashed browser fingerprint (IP + User-Agent).
The session token is held only in the browser's JavaScript memory — not in localStorage, cookies, or any persistent store. It is gone when the page is closed.
Session transcripts are stored on the platform and subject to your retention settings.
The widget iframe is served from the platform's domain and communicates only with the platform API. It does not make requests to third-party services.

Customising the widget

The widget respects a settings.greeting field on your agent: set it in the agent's advanced settings to display a welcome message before the visitor sends their first message.

The floating bubble and panel use the platform's indigo brand colour. For deeper visual customisation, contact the platform administrator.