Most people expect a website chatbot to be a project. In practice, getting ConvoRail set up is a short, ordered list of jobs: create an account, tell the bot what your business knows, paste one line of code and test it. The only part that takes real thought is the second one, because the quality of the bot depends on the quality of what you give it. This guide walks through the whole thing in the order you will actually do it.
1. Before You Start: What to Have Ready
You do not need a developer, a design brief or a long meeting. You need three things:
- Access to your website. Anywhere you can add a line of HTML, such as a theme setting, a footer or header field, a tag manager or the page template itself.
- The questions your customers really ask. Open your inbox, your contact-form submissions and your WhatsApp or phone notes, and list the ten questions you answer most often.
- The real answers. Prices, opening hours, delivery times, return rules, how to book. Pull them from your own policies so the bot says what your business actually does.
If you only have time to prepare one thing, prepare the second and third. A chatbot with ten accurate answers is more useful on day one than a chatbot with a hundred vague ones. For a deeper guide to that step, see how to write Q&A pairs that make a chatbot useful.
2. Create Your Account
Go to the ConvoRail app and choose Start free. The free plan needs no credit card, so you can finish the whole setup and test it before deciding anything about paying. At the time of writing, the Free plan covers up to 5 Q&A pairs, 200 messages a month and one team seat; the Pricing page always shows the current limits, so check it before you plan around a number.
Once you are in, you land on a dashboard with your knowledge base, inbox and usage counters. Everything that follows happens from there.
3. Teach the Bot Your Business
This is the step that matters. ConvoRail answers from the knowledge you give it and nothing else. That is the design, not a limitation: it is why the bot does not invent a refund policy you never wrote. Your knowledge comes from two places.
Q&A pairs
A Q&A pair is a question a customer might ask and the answer you want them to get. Add them one at a time from the knowledge base page, or upload a CSV with a question column, an answer column and an optional category column if you already have a list. Write the question the way a customer would type it, and keep each answer to the point.
Your website content
You can also bring in your website content, so the bot can draw on pages you have already written, such as your services, shipping information or about page. Think of this as a safety net behind your Q&A pairs, not a replacement for them. The pairs are where you control the wording of your most important answers.
Pro Tip: Start with the ten questions you answer most often, then add more each week from the questions the bot could not answer. That second list is the most valuable input you will ever get; it comes straight from real visitors.
4. Choose What Visitors See First
A chat widget that opens on a blank box asks the visitor to do all the work. ConvoRail lets you put your most common questions on the first screen as one-tap shortcuts, so a visitor can tap "What are your opening hours?" instead of typing. You can also set a different opening message for different pages, so someone on your pricing page is greeted differently from someone reading a blog post.
Pick three to five shortcuts that match your ten most common questions. They get an instant, consistent answer every time.
5. Paste the Script Tag
In your account settings you will find a single line of code that includes your account's API key. Copy it and paste it into your site, either in the `<head>` or just before the closing `</body>` tag. That is the same pattern as adding an analytics snippet. There is no framework to install and no build step.
- Website builders and CMS themes: look for a "custom code", "header scripts" or "footer scripts" field and paste it there.
- Tag managers: add it as a custom HTML tag that fires on all pages.
- Hand-built sites: paste it into the shared layout file so every page gets the widget.
Your API key is tied to your account. If you ever believe it has been exposed, you can regenerate it from the dashboard and replace the line on your site.
6. Test It Like a Visitor Would
Open your site in a private browser window, so you see what a stranger sees, and ask the bot things in three groups:
- 1Questions you wrote answers for. Ask them in your own words and in awkward ways. The answer should be correct and clear.
- 2Questions you did not write answers for. The bot should say it does not have confirmed information rather than guess, and then offer a short contact form.
- 3A request for a person. Make sure a real teammate can pick the conversation up from the inbox.
The second test is the one people skip, and it is the most important. A chatbot's honesty when it does not know is the feature that protects your reputation. For a longer list of checks, use the 30-minute pre-launch checklist.
7. Tell Your Team How the Inbox Works
When the bot cannot answer, the conversation lands in a shared inbox, flagged as urgent, with the visitor's name, email and phone number attached if they filled in the form. A teammate can reply, and the visitor sees the reply appear in the chat. While a person is in the conversation, the bot stays out of the way. Agree on who watches the inbox and how quickly you aim to reply, and keep that promise. If you want help deciding when a human should step in, read when a chatbot should hand over to a person.
8. Go Live and Improve Weekly
Once your tests pass, leave the widget on. Then set a small weekly habit: open the list of unanswered questions, add answers for the ones that repeat, and check your usage against your plan. Setup is an afternoon. Improving the bot is five minutes a week.
Common Setup Mistakes to Avoid
The most common setup mistakes are rushing the knowledge base, skipping the unknown-question test and forgetting to watch the inbox. All three are easy to avoid once you know about them.
- Adding too many answers too fast. A hundred rushed pairs are worse than ten careful ones, because every vague answer is something the bot will repeat.
- Testing only the happy path. If you only ask questions you wrote answers for, you never see how the bot behaves when it does not know.
- Pasting the script on one page only. Visitors arrive on any page, so put the line in the shared layout or header field.
- Not telling the team. A flagged conversation that nobody opens leaves a visitor waiting after being told someone would follow up.
What to Check in the First Week
In the first week, check what visitors asked, what the bot could not answer, and whether urgent conversations were picked up quickly. These three views tell you where to spend your next hour.
Look at the unanswered list on day three and again on day seven, and write pairs for anything that repeats. Open the inbox and read a few full conversations, not just the flags. If a visitor rated a conversation low, read it and fix the answer behind it. Most of the improvement in the first month comes from this loop rather than from any setting.
Conclusion
ConvoRail setup is: sign up, add your Q&A pairs and website content, choose your first-screen shortcuts, paste one script tag, test with real questions, and tell your team how the inbox works. None of it needs a developer. The part worth your time is the knowledge you give the bot, because that is the only thing it will answer from.
Key takeaways
- Setup needs access to your site, your ten most common questions and their real answers - no developer.
- The bot answers only from your Q&A pairs and website content, so quality of knowledge decides quality of answers.
- Put your most common questions on the first screen as one-tap shortcuts.
- Install is one script tag with your account's API key; regenerate the key if it is ever exposed.
- Test unanswered questions and a request for a human before going live, then review unanswered questions weekly.
Quick Summary
Setting up ConvoRail takes an afternoon and no developer. Create a free account, add your Q&A pairs and website content, choose the questions shown on the first screen, paste one script tag with your API key into your site, and test with real questions, including ones the bot cannot answer. Then agree who watches the shared inbox and review unanswered questions each week. The bot answers only from the knowledge you give it, so that is where your effort belongs.
Want to see grounded answers on your own site?
Start free, add your Q&A pairs and paste one script tag. No credit card required.

Founder & CEO
Writes about grounded AI chatbots for websites: how they work, how to measure them and what to check before you buy.
Topics
Get new posts by email
Guides on AI chatbots for websites, straight to your inbox.
