Quickstart: Script Tag
The fastest way to add a BitPalm agent. One line of HTML, no build step. Works on any static site, Webflow, WordPress, Shopify, plain HTML, or any CMS that lets you inject a <script>.
Add the snippet
Paste this just before </body> (or in the global head if your CMS doesn't allow body injection):
<script
async
src="https://unpkg.com/@bitpalm/ai-agents"
data-slug="your-agent-slug"
data-token="your-embed-token"
></script>Replace your-agent-slug and your-embed-token with the values from your dashboard → Settings → Embed.
Public agent? You can omit
data-token. Restricted (token-protected) agents always need it.
What happens after
The widget loads asynchronously and adds a chat button in the bottom corner of every page. From the dashboard you control:
- Brand colors, position, opening hours
- Welcome message, quick reply buttons
- Trigger bubbles (auto-open after X seconds, on exit intent, after Y page views, etc.)
- Knowledge base, tools, integrations
No re-deploy needed when you change those.
Optional attributes
| Attribute | Description |
|---|---|
data-slug | Required. Your agent slug. |
data-token | Embed token for restricted agents. |
data-locale | Force a language (en, de, ar). Auto-detected from <html lang> if absent. |
data-base-url | Override the platform URL (only for self-hosted setups). |
Verify it works
After saving, open your page and look at the bottom-right corner. You should see a chat bubble. Open it and send a message — you should get a reply within a few seconds based on your agent's knowledge base.
If nothing shows up, see Common Errors.
Next steps
- Configuration — z-index, locale, auto-identify
- Identify logged-in users — even on script-tag setups, via browser events
- Custom Context — pass cart, listings, account data to the AI