IntegralChatbot
Sign inGet started
User Guide

Build a chatbot people
actually want to talk to.

From your first wizard run to embedding on your site, training the bot, and reading analytics — everything in one place.

Get started Read the guide

Getting started

Spin up your first chatbot in 10 minutes — no code required.

  1. 1
    Create your account
    Sign up with email or Google. The first signup of your workspace becomes the admin.
  2. 2
    Open the dashboard
    Land on /dashboard. Click 'New chatbot' to launch the onboarding wizard.
  3. 3
    Walk through the wizard
    Paste your website URL, pick a persona, let the AI auto-fill the rest.
  4. 4
    Embed the script
    Copy one <script> tag from your bot's settings page and drop it on your website.
You can have as many chatbots as you like — one per product line, one per language, one per landing page. Each has its own public key.

The 10-minute wizard

The wizard does the boring work for you so you can ship today, not next week.

When you click New chatbot, the wizard walks through five short steps:

1 · Study your website
Paste a URL. We crawl your homepage and key pages with Firecrawl, then summarize what your business does.
2 · Pick a persona
Choose from 6 templates (Sales, Support, Concierge, Recruiter, Founder, Tutor) — or start blank.
3 · AI auto-fill
Greeting, instructions, tone sliders, and starter questions are pre-filled from your site context.
4 · Tone sliders
Six sliders (formal/casual, concise/detailed, etc.) tune voice without rewriting prompts.
5 · Embed snippet
Copy your <script> tag. The bot is live the second you paste it on your site.
You can re-run any step later from the bot's editor. Nothing in the wizard is permanent.

Training your bot

Knowledge files + clear instructions = a bot that actually knows your business.

From the bot editor, you have three ways to train:

Upload knowledge files
PDFs, Markdown, plain text. We extract the content and use it as context for every reply.
Re-study a URL
Paste a new page (pricing, FAQ, changelog) and we'll fetch and summarize it on the spot.
Edit instructions
A free-form system prompt that overrides everything else. Use it for non-negotiables.
Don't paste secrets (API keys, passwords) into instructions or knowledge files. They become part of the prompt context the model sees.

Voice (TTS & mic)

Let visitors hear your bot — and talk back.

Text-to-speech
Powered by Deepgram Aura. Pick from a curated voice list per bot. Visitors get a mute toggle (saved in their browser).
Speech-to-text
A mic button records via the browser's MediaRecorder and transcribes with Deepgram Nova.

Toggle voice on or off per bot in the editor under Voice. Both work the same in the editor preview and in the embedded widget.

Guardrails & persona

Keep the bot on-brand and out of trouble.

Three built-in guardrails you can flip on per bot:

  • No prices. The bot will refuse to quote prices and direct visitors to a sales page or demo instead.
  • No competitors. Provide a list — the bot will steer away from naming or comparing them.
  • Always offer a demo. The bot proactively recommends booking a demo when intent is high.
The six tone sliders (formal/casual, sales/support, etc.) are merged into the system prompt automatically — no need to edit prompts by hand.

Lead capture & escalation

Turn conversations into a pipeline.

Smart lead capture watches the conversation and inserts a name/email form when:

Intent triggers
The visitor says 'pricing', 'demo', 'talk to sales', etc.
After N messages
If you'd rather capture by depth than intent — set the threshold per bot.

If escalation is on, capturing a lead also fires a notification to your escalation email. View captured leads anytime under Chatbots → [Bot] → Leads.

Embedding on your site

One script tag. Works on any HTML page.

Grab the snippet from your bot's editor → Embed tab. It looks like this:

<script
  src="https://integralchatbot.com/embed.js"
  data-key="YOUR_PUBLIC_KEY"
  defer></script>

The widget runs feature-parity with the in-app preview:

  • Streaming chat with session persistence.
  • Lead capture form rendered inline when triggered.
  • Voice playback + mic recording (when enabled).
  • Mute toggle remembered per visitor.
CORS is open by default — drop the snippet on any domain and it just works.

Reading analytics

Per-bot dashboards under Chatbots → [Bot] → Analytics.

Sessions & messages
Volume over the last 7 / 30 / 90 days.
Leads captured
Total + capture rate (leads / sessions).
Escalations
How often the bot handed off to a human.

Conversation transcripts live under Chatbots → [Bot] → Conversations — open any session to read the full thread.

Admin console

Platform-wide tools for the workspace owner.

If you have the admin role, an extra Admin link appears in the app header. The admin console has four sections:

Overview
Totals across users, chatbots, sessions, messages, and leads.
Users
Browse all signups. Click a user to drill into their chatbots, sessions, and leads.
Analytics
Global trends — signups, sessions, leads — plus a top-chatbots leaderboard.
Training
Review every conversation across the platform and curate canonical answers.
The very first user to sign up is auto-promoted to admin. Admin role is stored in a separate user_roles table — never on the profile.

Curating canonical answers

Teach the bot from real conversations.

  1. 1
    Open Admin → Training
    You'll see the 50 most recent sessions from every bot.
  2. 2
    Pick a session
    Read the transcript. When the bot nailed an answer, click 'Use as canonical' on that reply.
  3. 3
    Review & save
    The user's question and the bot's answer auto-fill. Add tags. Hit save.
  4. 4
    Build your library
    Saved answers are stored per bot and ready to be fed back into prompts as the next training step.

FAQ & troubleshooting

The questions everyone asks first.

Do I need to bring my own API key?+

No. Lovable AI Gateway and Deepgram are bundled — you don't pay or configure either.

Can I have multiple bots?+

Yes, unlimited. Each bot gets its own public key, its own settings, its own analytics.

Where is my data stored?+

In Lovable Cloud (Postgres + Storage). Every table is row-level secured so other workspaces can't see yours.

The widget doesn't show up on my site.+

Check the browser console for CSP errors. Make sure the <script> tag has defer and the data-key matches an active bot.

The mic doesn't work on my visitor's browser.+

Mic access requires HTTPS and a user gesture (click). Most browsers also need a permission prompt — visitors only have to grant it once.

How do I delete a chatbot?+

Dashboard → click the trash icon on the bot card. This removes the bot, its training files, and all conversation history. Cannot be undone.

How do I become an admin?+

The first signup in your workspace is auto-promoted. After that, an existing admin grants the role from the database (a UI for role management is on the roadmap).

Ready to ship your bot?

It really does take 10 minutes.

Get started