Summary
HolderChat chatbots move through processing statuses from creation to Active. WordPress Connector sites also show sync status. This guide explains each state and common fixes.
Prerequisites
- Access to Dashboard or WP Admin → HolderChat
Company status values
| Status | Meaning | User action |
|---|---|---|
| Pending | Queued to start | Wait |
| Processing / Initialized / Queued | Content pipeline running | Wait on edit page |
| Parsed | Content analyzed | Wait — building may follow |
| Building | Knowledge index building | Wait (final step, several minutes) |
| Active / Created | Ready for chat | Test and embed |
| Error | Pipeline failed | See fixes below |
| (empty) | Still preparing | Refresh later |
WordPress Connector sync status
| Status | Meaning |
|---|---|
| ok | Last sync succeeded |
| rebuilding | Knowledge rebuild in progress |
| error | Last sync failed — retries may run |
Rebuild flow
- Knowledge or context changes set changes detected
- User clicks Rebuild Bot OR Connector debounce triggers rebuild
- Status → Building → Active
- If rebuild runs while another rebuild active, job queues (
changes_detectedflag)
Common issues
Bot stuck in Building
Cause: Large site, AI chunking queue, or server load.
Fix: Wait 15–20 minutes. Avoid starting duplicate rebuilds. Use Sync all content now only if content is wrong.
Error status after rebuild
Cause: Invalid source, API failure, or disk error.
Fix: Check Knowledge Sources for failed website/file. Remove bad source. Rebuild again. Contact support with bot ID.
Changes not in answers
Cause: Rebuild not run or debounce pending.
Fix: Click Rebuild Bot. WP users: wait 90s after edit or force Sync all content now.
Widget works but wrong content
Cause: Wrong bot token or old index.
Fix: Verify embed token. Rebuild. Clear browser cache.
Connector sync errors
Cause: Hub unreachable, timeout, auth failure.
Fix: Retries at 60s × 3. Check site can reach holderchat.com. Re-save settings.
Dashboard iframe blank (WP)
Cause: Embed token expired, login required, CSP.
Fix: WP Admin → HolderChat → Dashboard tab → Refresh dashboard. Log into holderchat.com in the same browser.
AI chunking slow
Cause: Many long pages with AI chunking on.
Fix: Expected. Turn off AI chunking for faster whole-page indexing if quality acceptable.
Status notices on edit page
The edit UI shows contextual banners per status (e.g. “Chatbot is being built”). Stay on page or refresh to update.
What triggers a rebuild
See /documentation/wordpress-sync-and-rebuild/ for Connector timing.
When to contact support
Contact service@holderchat.com with:
- Bot ID / Company ID
- Domain (for Connector)
- Screenshot of status
- Time when error started