Skip to content
Documentation

Quick start: from sign-up to a live chat widget

Create an intoCHAT account, build your first AI agent from your website or a template, train it, test it and add the chat widget to your site in five steps.

This guide takes you from a new account to a chat bubble on your website. You need your website's address and access to its HTML, or to its WordPress or Shopify admin.

The Free plan includes 1 agent, 25 messages a month, 100K characters of training content and 1 website crawl a month, enough to try the whole flow. See pricing for the paid plans.

1. Create your account

Sign up with your email address and a password, or with Google. If you signed up with email, sign in afterwards. You start on the Dashboard.

2. Create an agent

  1. Click New agent in the sidebar.
  2. Pick a starting point, such as Customer Support Agent or Sales Agent, or choose Start from your website at the top to have the agent built for you; see below. The template fills in the agent's instructions, and you can edit every word later. Choose Start from scratch to write your own instructions (at least 100 characters).
  3. Keep or change the suggested Agent name. It also appears in the header of the chat window, so choose a name visitors understand.
  4. Click Create agent.

The new agent opens on its Knowledge tab.

Or start from your website

Start from your website builds a trained agent from your site in one go. It replaces the rest of this step and step 3.

  1. Click New agent, then Start from your website at the top of the dialog.
  2. Enter your address in Your website, for example example.com, and click Build my agent.
  3. Keep the dialog open while it works. intoCHAT finds your homepage and up to 4 key pages, reads your logo and colours, creates the agent, reads the pages, adds them to the agent's knowledge and trains it. Each step is ticked off as it finishes. Training runs on intoCHAT's servers: if it takes longer than five minutes, the agent opens anyway and training continues.
  4. The agent opens on the Playground, ready to test. Continue with step 4.

What it sets up:

  • Name: your business name from the site's title, followed by "Assistant", for example "Acme Assistant".
  • Instructions: the template that fits your site, E-commerce Specialist for a shop, Real Estate Agent for an estate agent and AI Chatbot otherwise, plus a short section that names your business and website.
  • Look: your logo as the avatar and colours from your site. If none are found, the default look is used.
  • Welcome message: "Hi! I'm the Acme assistant. Ask me anything about what we do."
  • Knowledge: the pages that could be read. On a multilingual site, pages in your browser's language are preferred.

It uses one website crawl from your monthly allowance, and the pages count toward your plan's character limit. You can change everything afterwards on the agent's tabs.

What you seeWhat it means
"That address points to a private or local network, so it can't be read."Only public websites can be read. No agent was created.
"… couldn't be reached. Check the address, or try again if the site is down."The site didn't answer. No agent was created.
"You've used all of this month's website crawls. …"No crawl is left this month. Start from a template and add knowledge later, or upgrade. No agent was created.
The upgrade dialog opensYour plan's agent limit is reached. Nothing was created.
"No pages on … could be read. …"The agent was created without knowledge. Click Open the agent and add knowledge on the Knowledge tab.
"Agent created; training isn't finished"Training is still running on the server, or it stopped. The Knowledge tab shows its progress. If sources are still waiting to be trained there, click Train agent.

3. Add knowledge and train

  1. Under Add knowledge, open Website and enter your address, for example https://example.com.
  2. Click Find pages and review the list. Untick pages that don't help visitors, such as legal notices or old news.
  3. Click Add … selected pages and wait until the pages show added.
  4. Optionally add files, text snippets or Q&A pairs in the other tabs.
  5. Click Train agent at the top of the tab. Training continues on the server if you leave the page. When it is done, the status reads that all sources are trained.

Adding pages uses one of your monthly crawls, so on the Free plan choose your pages carefully. Sources are saved as soon as you add them, but the agent only uses them after training. More in Website crawl, Files and Text and Q&A.

4. Test and adjust

  1. Click Save changes in the header if you edited anything. Your website only uses saved settings, while the Playground already answers with the instructions on screen, saved or not.
  2. Open Playground and ask the questions your visitors ask most often. Check that the answers are correct, and that the agent admits it when your content doesn't cover something.
  3. If an answer is wrong or vague, add a Q&A pair with the right answer on the Knowledge tab and train again.
  4. On Appearance, set the welcome message, suggested questions and colors, then save.

5. Add the widget to your site

  1. Open Share and click Copy Code in the Bubble Chat card. The code already contains your agent ID:

    <script src="https://www.intochat.ai/api/embed.js" data-chatbot-id="YOUR_AGENT_ID"></script>
    
  2. Paste it just before the closing </body> tag, ideally in a footer or layout file that every page uses.

  3. Reload your site. The chat bubble appears in the bottom corner, with the colors and position from Appearance.

On WordPress you can use the official plugin instead, and on Shopify you paste the code into your theme. See Script tag, WordPress and Shopify.

Duplicate an agent

To start a second agent from one you have already built, for example for another language or website, go to Agents in the sidebar, open the three-dot menu on the agent and choose Duplicate. The copy opens right away, named after the original with "(copy)" at the end.

  • Copied: all settings, including instructions, guardrails, appearance, lead collection, allowed domains, reply language, limits and blocked countries, the Slack alerts connection and the Help Page settings, plus the knowledge sources, actions, chat forms and procedures, whose action steps call the copy's actions.
  • Not copied: conversations (with the procedures they went through), leads, form submissions, webhooks, preview links and the settings history. The copy's monthly message cap starts its count at zero.
  • The copy's Help Page starts switched off, even if the original's is published. Switch it on in the copy's Share tab when you want it.
  • The knowledge comes over already trained, so the copy answers like the original from its first message. Duplicating doesn't retrain anything or use a website crawl. Sources that weren't trained yet stay pending in the copy.
  • The copy has its own agent ID, so it needs its own embed code from Share.

The copy counts as one of your plan's agents. Duplicating is refused when you have reached your plan's agent limit, or when the agent's knowledge is over your plan's characters per agent. See Plans and limits. The copy goes into the same folder as the original.

Organize agents in folders

With many agents, for example one per client or website, group them in folders on the Agents page.

  1. Click Folders above the list.
  2. Under New folder, type a name and click Create. Folder names are up to 60 characters, and two folders can't share a name.
  3. To file an agent, open the three-dot menu on its card or row, choose Move to folder and pick the folder. Choose No folder to take it out.
  • With All folders selected, the list is grouped: each folder with its agents, then No folder. Pick a folder, or No folder, in the folder filter to see only those agents.
  • To rename a folder, click Folders and use the pencil icon next to it. To delete one, use the bin icon. Its agents move back to No folder; no agent is deleted.
  • Folders belong to the account, so everyone in your team sees the same ones. Viewers can filter by folder but can't create, change or delete folders, or move agents.
  • An account can have up to 50 folders. Moving an agent doesn't change its "Recently updated" date.

Next steps

View as Markdown