Summary
Embed the HolderChat widget on any website with one script tag from Get Widget Code. WordPress Connector sites can enable the widget automatically without manual embed.
Prerequisites
- Bot status Active
- API token (company token) from Get Widget Code
Step-by-step: Get embed code
- Open Dashboard → Get Code on your bot
Or go to /get-widget-code with bot selected
- Copy the script tag, format:
<script src="https://holderchat.com/dynamic/get.js?token=YOUR_TOKEN" async defer></script>
- Paste before the closing
</body>tag on every page where the chat should appear
WordPress Connector (automatic)
If you use HolderChat Connector:
- WP Admin → HolderChat → Settings
- Enable Show chat widget on frontend
- Save — plugin injects
get.jsautomatically
Manual embed is optional on Connector sites.
Verify installation
- Open your website in incognito
- Chat bubble should appear (usually bottom corner)
- Send a test message
- Check browser console for errors if missing
Cookies
The widget sets cookies for session continuity:
| Cookie | Purpose |
|---|---|
holderchat_user_id | Visitor identifier |
holderchat_talk_id | Conversation thread |
What triggers a rebuild
Embedding does not trigger rebuild. Token stays valid when bot is Active.
Limitations
- Token is tied to one bot — do not share across bots
- Site must allow third-party scripts
- CSP headers must allow holderchat.com scripts and WebSocket
- Some ad blockers hide chat widgets
Troubleshooting
Symptom: Widget not visible
Cause: Script missing, wrong token, or bot not Active.
Fix: Verify script placement; check Active status; disable ad blocker.
Symptom: CORS or CSP errors
Cause: Strict Content-Security-Policy on your site.
Fix: Allow holderchat.com scripts and wss:// WebSocket.
Symptom: Widget on wrong bot
Cause: Wrong token in script.
Fix: Regenerate from correct bot’s Get Code.