Quick Start
Deploy Chatmancer and embed your first chatbot in under 10 minutes.
Quick Start
From zero to a live chatbot on your website in four steps.
Prerequisites
Before you begin, make sure you have:
- An AWS account (free-tier works for most deployments — create one here)
- An OpenAI API key (platform.openai.com)
- A website you can add a
<script>tag to
Step 1 — Deploy to AWS
Click the Deploy button on the Chatmancer homepage or your account dashboard. You will be redirected to the AWS CloudFormation console with the template pre-loaded.
- Sign in to AWS if prompted
- Review the stack parameters (defaults are fine for your first deploy)
- Tick the IAM acknowledgement checkbox
- Click Create stack
The stack takes around 4 minutes to provision. When the status changes to CREATE_COMPLETE, your dashboard URL appears in the Outputs tab.
Step 2 — Open your dashboard and enter your OpenAI key
Open the CloudFront URL from the Outputs tab. The first-run wizard will prompt you to enter your OpenAI API key. The key is stored encrypted in AWS Secrets Manager inside your account — Chatmancer never sees it.
Step 3 — Create your first chatbot
In the setup wizard (or via Chatbots → New):
- Give your chatbot a name (visible only to you in the dashboard)
- Set a welcome message — the first thing visitors see
- Pick a tone preset (Friendly Support, Professional Sales, or Concise FAQ) — or write a custom system prompt
- Optionally add a data source so the bot can answer questions from your content
See Chatbot Configuration and Knowledge Base for more detail on each option.
Step 4 — Embed the widget
Once your chatbot is created, go to Settings → Embed and copy the snippet:
<script
src="https://your-cloudfront-url/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>Paste it inside the <head> tag of every page where you want the chatbot to appear. The widget loads asynchronously and will not affect page performance.
That's it — your chatbot is live.
What's next
- Chatbot Configuration — fine-tune your bot's behaviour and model
- Knowledge Base — train your bot on your website, docs, or PDFs
- Embedding the Widget — position, colour, and custom domain options