SimpleBot support

Build it clearly.
Test it honestly.

Use these guides to create, train, test, and install your bot. Each direction matches the controls in the current SimpleBot dashboard.

SimpleBotOnline

Hi! I’m SimpleBot. I can explain how the platform works, help you choose a plan, or walk you through setup.

⚡ Powered by SimpleBot
Quick start

Your shortest path to a useful bot.

Start with one job, a small set of trustworthy documents, and the questions real visitors already ask.

  1. 01
    Create

    Open the dashboard, select New bot, add a name and description, then select Create bot.

  2. 02
    Train

    Open the bot, select Knowledge, choose Add files, and wait for every source to show ready.

  3. 03
    Shape

    Select Instructions, set the system prompt, welcome message, and reply buttons, then select Save instructions.

  4. 04
    Test

    Select Test Bot and try common, unsupported, and sensitive questions before launch.

  5. 05
    Publish

    Select Embed, copy the one-time code created for the primary website, and add it to the site.

Step-by-step guides

Go straight to the setting you need.

Knowledge

Add material your bot can trust

  1. Open Your bots and select Configure bot.
  2. Select Knowledge near the top of the editor.
  3. Select Add files, or select the upload area.
  4. Choose PDF, DOCX, TXT, Markdown, or HTML files up to 50 MB each.
  5. Wait for queued and processing sources to become ready.
  6. Open Test Bot and ask questions the new knowledge should answer.

A failed source is not available to the bot. Read the displayed error and try a smaller, clean copy.

Behavior

Set the role, tone, and welcome

  1. Open the bot and select Instructions.
  2. Update the bot name, description, and brand color under Name and purpose.
  3. Under How it should respond, describe the role, tone, audience, and boundaries.
  4. Edit the welcome message, then add each Reply button CTA in its own field.
  5. Select Save instructions and wait for confirmation.
  6. Use Test Bot to review the result.

Keep changing business facts in uploaded sources. Reply buttons should offer clear, relevant next questions and never imply an action the bot cannot complete.

Reply buttons

Give visitors clear next steps

  1. Open the bot and select Instructions.
  2. Find Reply button CTAs under How it should respond.
  3. Type one short suggested question, then press Enter or select Add CTA. Add up to six.
  4. Put the most useful and broadly safe questions first.
  5. Select Save instructions and wait for confirmation.
  6. Open Test Bot and confirm each button sends the text shown on it.

SimpleBot can show up to three server-approved reply buttons after an answer. Booking and human-support buttons stay separate because they open validated workflows.

Bookings

Collect intake before Calendly

  1. Open the bot and select Bookings near the top of the editor.
  2. Turn on the booking-intent option.
  3. Add the full HTTPS Calendly event link.
  4. Edit the button label, intake title, and introduction.
  5. Select Add for each question, choose its type, and mark Required when needed.
  6. For choice questions, enter options separated by commas.
  7. Select Save booking setup, wait for confirmation, then open Preview and ask “Can I book a demo?”

The Calendly link appears only after the visitor completes the required intake and consents to share it.

Embed

Put SimpleBot on your website

  1. Open the bot and select Embed.
  2. Confirm the primary website is already listed under Step 1. Use Add another only for an additional website.
  3. Under Step 2, select Copy code.
  4. Save the code immediately because the new raw key is shown once.
  5. Paste the script into the website template or global code area.
  6. Publish the website change and test the live page.

If the code is lost, rotate the domain key and replace the old script with the newly generated one.

WordPress

Install SimpleBot on WordPress

  1. Finish the bot setup and test it inside SimpleBot.
  2. Open Embed, confirm the live WordPress origin is listed, and copy the one-time script.
  3. In WordPress, open an approved site-wide custom-code area or trusted header and footer script manager.
  4. Paste the script once and publish the change.
  5. Clear WordPress, host, and CDN caches if the widget does not appear.
  6. Test the public page in a private browser window on desktop and mobile.

A native WordPress plugin is planned but is not required. Some managed WordPress plans restrict custom scripts or reserve them for administrators.

Tools

Connect approved MCP capabilities

  1. Open the bot and select Tools.
  2. Select Connect server.
  3. Enter the server name and HTTPS Streamable HTTP URL.
  4. Enter authorization only in the protected dashboard field.
  5. Select Save and discover.
  6. Approve only the capabilities the bot should use.
  7. Choose Public data or Verified email required for each approved tool.

Never paste credentials into chat. New server capabilities remain disabled until you refresh and approve them.

Human support

Configure human escalation

  1. Open the bot and select Human Support.
  2. Turn on Enable human escalation for this bot.
  3. Under Send escalated conversations to, enter the inbox monitored by the person or team responsible for follow-up.
  4. Adjust the visitor button label and select Publish changes.
  5. Test from the embedded website after sending at least one message.
  6. Complete the contact form, consent, and confirm the inbox receives the transcript.

The visitor must consent. SimpleBot reports success only after the email provider accepts the message.

Troubleshooting

Check the simple things first.

My document is stuck+

Confirm the file is supported and under 50 MB. Wait several minutes. If it becomes failed, read the visible error and try a smaller, clean copy.

The answer is missing+

Confirm the source is ready and the answer exists as selectable text. Remove obsolete or conflicting sources, then test the question again.

The widget does not appear+

Confirm the site change is published, the script is present once, and the exact site origin is active under Embed. Check whether the site blocks the script or iframe.

The website is not approved+

Compare the browser origin with the active Embed domain. Add the correct scheme and subdomain, then install the code generated for that domain.

A private question was refused+

The visitor must sign in through the host website and receive a session bound to the exact verified email. Typing an email into chat is not authentication.

Booking intake does not open+

Confirm Bookings is enabled, the HTTPS Calendly link is valid, at least one answerable question exists, and the bot was saved. Test with a clear new-booking request.

MCP tools are missing+

Open Tools, select Refresh, review the current catalog, approve the tool, and choose the correct identity policy. New tools are never approved automatically.

Changes will not save+

Check for a missing support inbox, incomplete identity settings, an invalid Calendly link, no intake questions, or choice questions without options.

A reply button is not useful+

Open Instructions and revise that Reply button CTA in its separate field, or remove it with the trash button. Save and test again. Buttons are suggestions; they do not bypass authentication, consent, or tool policy.

The WordPress widget is missing+

Confirm the live WordPress origin is approved, the script was published once, and your role or host permits custom JavaScript. Clear page, host, and CDN caches, then test in a private browser window.

Platform admin is missing+

Platform administration is restricted to explicitly allowlisted SimpleBot operators. Confirm your Clerk user ID is in the server-side platform admin list, then sign out and back in. Never send a session token or secret in a support request.

Privacy boundary

Personal answers require the right person.

SimpleBot will not answer order, account, payment, subscription, or profile questions unless the website supplies an authenticated session for that exact verified email.

Current baseline

Some controls are still being built.

Paid checkout, finalized plans, owner-facing analytics, webpage ingestion, conversation export, native calendar booking, and confirmed write-capable MCP actions are not available in the current customer dashboard. Restricted platform observability is available through Langfuse.

Need more help?

Contact the SimpleBot team.

Email support@entheo.ai or use this form for account help, privacy requests, or security concerns. Include the affected bot name or ID and a short description, but never send passwords, API keys, MCP credentials, identity tokens, or private documents.