Skip to content

Getting started

From a new account to a working chat on your site in five steps: connect your AI provider, create a bot, add knowledge, test it and install it.

Updated

On this page

Create your account

#
  1. 01

    Sign up

    Enter your name (optional), work email, a password of at least 12 characters and your workspace name, usually your company. The workspace is created straight away and you are its owner.

  2. 02

    Verify your email

    Open the link in the email Verify your email for Kothadesk. It works once and expires in 24 hours. Until you verify, you cannot add provider keys, invite teammates or put a bot live. Use Resend link in the banner if it did not arrive.

  3. 03

    Follow the Setup guide

    The Setup guide in the sidebar walks you through the next five steps.

Forgot your password? Use Forgot password on the sign-in page; the reset link works once, expires in 30 minutes and signs you out everywhere. Invited by a teammate? The invitation link is valid for 7 days.

Your first bot in five steps

#
  1. 01

    Connect your AI provider

    Kothadesk runs on your own AI key, so your provider bills you directly at their price. You need a chat model and an embedding model: an OpenAI or Google Gemini key covers both; Anthropic and xAI keys are chat only and need a second key for embeddings. See the Model providers guide.

  2. 02

    Create the bot

    Give it a name (shown in the widget header), a purpose (Customer support, Sales assistant, Documentation helper or Custom, which seeds its instructions and welcome message) and a language: Automatic answers each visitor in their own language. Your first valid keys are connected automatically.

  3. 03

    Add knowledge

    Enter your website or help centre address and press Start crawling, or upload files. The assistant answers only from what you add here. See the Knowledge guide.

  4. 04

    Test it

    The test chat opens as soon as the first document is ready. Ask the questions your customers ask and check the sources under each answer.

  5. 05

    Install it

    Allow your site's address, then paste one script tag before </body>. See the Install guide.

Tip: Until a chat key and an embedding key are connected, the widget shows temporarily unavailable and knowledge is not indexed. The yellow banner at the top of the bot pages tells you what is missing.

The Get it live checklist

#

Each bot's Overview shows four steps until they are done:

Get it live steps
StepDone when
Add knowledgeAt least one knowledge source is ready
Test in the playgroundYou have had at least one test conversation
Customize the appearanceYou changed the colour or set a title
Install on your siteAt least one allowed origin is saved

Plans and limits

#
Plan limits
LimitFreeProBusiness
Bots11050
Members31050
Knowledge sources550500
Documents50010,000100,000
Storage100 MB2 GB20 GB
Enabled tools320100
Visitor messages per month1,00020,000200,000
Pages ingested per month1,00020,000200,000
Evaluation runs per month102002,000
Remove "Powered by Kothadesk"NoNoYes
Voice calls in live supportNoNoNo

Tip: Voice calls are set per plan and no standard plan includes them; your platform administrator can enable them for your plan.

Prices are on the pricing page. Your AI usage is billed by your provider, not by Kothadesk. See your plan, what you have used and when monthly limits reset (UTC) under Settings, Usage.

Worked examples

#

Online shop

A clothing store's first afternoon

Answer size, delivery and returns questions on the store by the end of the day.

  • One Gemini key for chat and embeddings.
  • Bot purpose: Customer support. Knowledge: crawl the help pages and the size guide.
  • Test with "Do you deliver to Shillong?" and "Can I exchange for a bigger size?", then paste the snippet into the store theme.

Clinic or bookings

A clinic with a PDF brochure

Answer timings, doctors and fees from the clinic's brochure.

  • Upload the brochure and the fee list as files instead of crawling.
  • Share the hosted chat page link on WhatsApp if the clinic has no website.

Software company

A software company's help centre

Deflect common how-to questions from the support queue.

  • An Anthropic key for chat plus an OpenAI key for embeddings.
  • Bot purpose: Documentation helper. Knowledge: crawl the docs site's sitemap.
  • Build an evaluation set from the top 30 support questions before going live.

Coaching institute

A coaching institute

Answer course, batch and fee questions for students and parents.

  • Knowledge: the course pages plus an FAQ table of fees and batch timings.
  • Language: Automatic, so Hindi and Assamese questions are answered in the same language.