Creating Your First Chatbot

HolderChat user guide

Documentation

Summary

Create a chatbot from the HolderChat dashboard by starting an empty bot, adding knowledge sources, and rebuilding. This replaces the old /create form flow. When status is Active, you can test and embed the widget.

Prerequisites

  • HolderChat account (logged in)
  • At least one knowledge source: website URL, document file, or extern JSON API

Step-by-step

1. Open Dashboard

  1. Log in at holderchat.com
  2. Go to Dashboard (/dashboard)

2. Create empty chatbot

  1. If you have no bots, click Create Your First Chatbot
  2. If you already have bots, use the create action on the dashboard
  3. The system creates an empty bot and opens Edit Chatbot (/edit-chat?id=...)

3. Add knowledge sources

  1. In the left sidebar, open Knowledge Sources
  2. Click Add WebsiteAdd Extern, or Upload File
  3. For websites: enter URL, review the menu preview, start parsing
  4. For files: upload PDF, DOCX, TXT, MD, XLSX, or PPTX
  5. Save your resource

See /documentation/knowledge-sources/ for details.

4. Rebuild the bot

  1. After adding or changing sources, a yellow Changes detected banner appears
  2. Click Rebuild Bot
  3. Wait until status shows Active (may take several minutes)

5. Customize (optional)

  1. Open Bot Behavior & Messages for name and welcome text
  2. Open Company Information for contact details
  3. Click Save Changes (no rebuild needed for message-only changes)

6. Test and deploy

  1. Click Test Chatbot or go to /test-chatbot?token=...
  2. Click Get Widget Code and embed on your site

Status during creation

StatusMeaningWhat to do
PendingWaiting to startWait
Processing / ParsedContent being analyzedWait on edit page
BuildingKnowledge base buildingWait (final step)
ActiveReady to useTest and embed
ErrorSomething failedSee troubleshooting doc

What triggers a rebuild

ActionRebuild needed?
Add/remove website or file sourceYes
Change Additional Context or Context SourcesYes
Change bot name or welcome messageNo
Change avatar or company infoNo

Limitations

  • Empty bots cannot answer questions until knowledge is added and rebuild completes
  • Website parsing during beta may cap page count
  • Connector-created bots start with WordPress content only (add dashboard sources separately if needed)

Troubleshooting

Symptom: Rebuild button is disabled

Cause: Bot status is not Active or Created yet.

Fix: Wait until initial processing finishes.

Symptom: Bot gives generic or empty answers

Cause: No knowledge sources or rebuild not completed.

Fix: Add sources, click Rebuild Bot, wait for Active.

Symptom: I expected a /create page

Cause: The standalone create form was replaced by dashboard flow.

Fix: Use Create Your First Chatbot on Dashboard.

Related topics