Create Your First Chatbot | SoundMinds.ai Guides

1 Sign up for SoundMinds.ai

Create your SoundMinds.ai account at console.soundminds.ai/register. See our Signup Guide for detailed instructions.

Tip: Use your business email for easier team collaboration later.

2 Create a new chatbot

Go to Chatbot Management and click the "Create Chatbot" button. The setup takes about 30 seconds:

Chatbot Name: Auto-generated based on your business (you can edit it)
Description: Optional - briefly describe what your chatbot will help with
QA Template: Skip this for now (you'll add Q&A pairs manually)

Click "Create Chatbot" to continue.

3 Add your first Q&A pair

Click "Add Q&A Pairs" or navigate to Knowledge Base. Create at least one question-answer pair:

Question: What your customers might ask
Answer: The response your chatbot should give

Click Save when done.

Tip: You can also import Q&A pairs from your existing FAQ pages using our AI-validated import feature.

4 Generate embeddings

After saving your Q&A pair, click "Generate Embeddings". This creates the AI vector representation needed for semantic matching.

Important: Without embeddings, the chatbot can only do exact keyword matching. Always generate embeddings after adding or updating Q&A pairs.

5 Test your Q&A pair

Go to Knowledge Base > Test tab. Enter your question to see how the chatbot matches it.

You'll see:

Matched Q&A pairs with confidence scores
Semantic score: How well the meaning matches
BM25 score: How well the keywords match
Combined score: Weighted blend (70% semantic + 30% BM25)

A higher score means better matching.

6 Get your embed code

Go to Settings > Integrations. You'll see a Web Integration already configured for you.

Click "Copy Embed Code" to copy the code you'll paste into the webpage where you want the chatbot to appear.

Tip: Keep this page open - you'll need the embed code in the next step.

7 Embed on your website

Copy the embed code from Settings > Integrations and paste it into your website's HTML, just before the closing </body> tag:

<!-- SoundMinds AI Chatbot Widget -->
<script>
  window.soundmindsConfig = {
    chatbotId: "your-chatbot-id", // Replace with your actual chatbot ID
    position: "bottom-right",
    apiUrl: "https://api.soundminds.ai",
    embedUrl: "https://console.soundminds.ai"
  };
</script>
<script src="https://console.soundminds.ai/embed/widget.js" async></script>

Note: The embed code from your dashboard will have your actual chatbot ID pre-filled.

8 Customize the widget (optional)

Go to Settings > Appearance to adjust:

Colors
Header text
Welcome message
Widget position

9 Whitelist your domain (optional)

By default, domain whitelisting is disabled, meaning your chatbot can be embedded on any website. This is an optional but recommended security feature.

Why enable domain restrictions?

Domain whitelisting prevents unauthorized websites from embedding your chatbot widget. When enabled, only domains you specifically allow can load your chatbot.

How to enable domain restrictions:

Go to Settings > Integrations > Domain Restrictions
Toggle "Restrict to Specific Domains"
Enter your domain (e.g., example.com or *.example.com for all subdomains)
Click Save

Recently Blocked Domains: This feature shows domains that tried to load your chatbot but were blocked. You can click the "Allow" button to quickly whitelist them.

10 Test on your website

Go back to your website and refresh the page. Ask the same question you added to your Q&A pair.

You should now get back the exact answer from your knowledge base!

Congratulations! Your chatbot is now live and answering questions using your custom knowledge base.