This guide walks you through setting up your first HyperHelp chatbot — from creating your account to embedding a live chat widget on your website. The whole process takes about 15 minutes.
Step 1: Create your account#
Sign up at HyperHelp. Verify your email address, and you'll land on your dashboard. This is your home base for managing chatbots, data sources, and conversations.
Step 2: Create your first chatbot#
From the dashboard, click Create chatbot. Give it a name that makes sense for your use case — something like "Acme Docs" or "Support Bot".
Each chatbot is a self-contained knowledge base and chat experience with its own data sources, conversations, and widget configuration. You can create multiple chatbots under one organization depending on your plan.
Step 3: Add a data source#
Navigate to Data Sources in the chatbot sidebar. You have two options for building your knowledge base:
Crawl your website#
Enter your site URL, configure crawl rules (depth, include/exclude paths, max pages), and let HyperHelp do the rest. It crawls your pages, extracts the text content, and builds a searchable knowledge base. You can watch the progress in real time.
Add Q&A entries#
Manually add question-and-answer pairs for topics your site doesn't cover well, common FAQs, or anything you want the chatbot to handle with a specific response.
You can use both options together — crawled content and Q&A entries feed into the same knowledge base.
Tip: Start with a small crawl (depth 2, narrow include paths) and expand from there. It's easier to verify a focused knowledge base than a broad one.
For full details on crawl configuration and Q&A entries, see Data sources.
Step 4: Test with the built-in chat#
Once your data source finishes indexing, go to Chat in the sidebar. Ask a few questions and verify the answers are accurate and well-sourced.
If something isn't right, you have a few options:
- Adjust your crawl rules to include or exclude specific pages
- Add Q&A entries for topics the crawled content doesn't cover
- Use "Additional instructions" in chatbot settings to shape the response style
For more on testing, see Chat.
Step 5: Embed the widget on your site#
Go to Chatbot Settings > Install. Copy the embed snippet and paste it into your website's HTML, just before the
closing </body> tag:
<script
src="https://app.hyperhelp.ai/widget/chat.js"
async
onload='window.HyperhelpWidget.init({ "chatbotKey": "YOUR_WIDGET_KEY" })'
></script>
Before the widget goes live, add your domain to the allowlist in the Install settings. This ensures the widget only loads on your authorized domains.
That's it — your visitors can now chat with your content.
For styling, lead capture, and advanced configuration, see Widget installation.
What's next?#
Now that your chatbot is live, explore these topics:
- Chatbots — Configure your chatbot's behavior, intro message, suggested questions, and notification preferences
- Data sources — Fine-tune your crawl settings and add Q&A entries
- Chat — Learn how to use the built-in chat for testing and refinement