Quickstart
Create an account, connect your site, install one script tag, and activate when you are ready for visitors.
1. Create your account and workspace
Sign up at chat.doorwick.com/signup with an email and password, or with Google, GitHub, or LinkedIn. You land in the dashboard first. The first-workspace dialog asks for the product name and its public website, then creates the workspace, its secured site key, and your owner membership together.
A workspace is one product or site: its own widget, inbox, knowledge, AI settings, and bill. If you support two unrelated products, make two workspaces. You can add more later from /workspaces/new.
2. Install and analyze before paying
Workspace creation opens the getting-started checklist rather than checkout. Copy the generated snippet, install it on the website you registered, and Doorwick verifies the site key from that allowed origin. Once verified, you can run bounded public-site analysis and review the pages Doorwick recommends.
The visitor widget remains offline until payment is active. Other paid writes remain locked, while the installation origin and site-analysis actions needed to evaluate Doorwick are available before checkout.
3. Work the checklist
Each workspace has a getting-started checklist at /workspaces/:id/getting_started that ticks itself off as you go. Five steps:
- Workspace created — already done.
- Install the widget — copy the snippet, which arrives with your real site key already in it. Ticks when Doorwick receives a valid site-key request from the allowed origin, even before payment.
- Analyze your site — unlocked after installation; review useful public pages before indexing.
- Connect an AI provider — optional; skip it and every conversation goes straight to you.
- Activate Doorwick — complete payment when the configured widget is ready for visitors.
4. Paste the snippet
One script tag, just before the closing </body> tag of your site:
<script async src="https://chat.doorwick.com/widget.js?v=3"
data-site-key="ck_your_site_key"></script>Copy the real one from the checklist or from Site keys — the placeholder above won't work. Add the chat widget to your site has the exact spot for Rails, Next.js, WordPress, and Shopify.
5. Allow your domain
Add every origin that embeds the widget — https://example.com and https://www.example.com are two different origins, so list both if you serve both. Until an origin is on the list the widget refuses to boot on it.
6. Say hello to yourself
Load your site. The launcher bubble appears bottom-right; open it and send a message. It lands in your Doorwick inbox live, without a refresh, and you can reply from the thread. That round trip is the whole product working.
No bubble? Open your browser console:
- 403 on /widget/session
- The origin isn't allowlisted.
- 402
- The workspace isn't subscribed.
Both are covered in Troubleshooting.
7. Optional: let the AI answer first
Doorwick doesn't resell tokens — you bring your own provider key, and the model bills you directly. Add a key under AI agent, turn the agent on, and add at least one knowledge source. From then on new conversations open with the AI handling them; it answers from your knowledge with citations, says it doesn't know rather than guessing, and hands off to you the moment a visitor asks for a person.
8. Bring the rest of your team
Everyone who answers customers should have their own login — there's no per-seat charge, so there's no reason to share one. Invite them from Team, as agents unless they need to touch billing or credentials.
Full detail in Team and roles.
Where everything lives
Once you're set up, the rest of the documentation maps onto the sidebar:
- Conversations
- Working the inbox — replying, canned replies, handoff, resolving, CSAT.
- Analytics
- Analytics and exports — what each number counts, and taking your data with you.
- AI settings & Knowledge
- Set up the AI agent and Knowledge and citations.
- Widget & Site keys
- Appearance and office hours, allowed origins, verified visitors, and Connect Shopify.
- Team & Billing
- Team and roles, accounts and workspaces, and billing.