Documentation
Everything you need to build with PrimeWebKit
Practical guides for the dashboard, the embed script, and the API.
Quickstart
Create your first chatbot, add a knowledge source, and embed it — in under ten minutes.
- 1Register an account and verify your email.
- 2Create a chatbot and write a system prompt describing its role.
- 3Add a website URL to crawl, or upload documents / Q&A pairs.
- 4Copy the embed script from the Widget tab and paste it before </body> on your site.
Authentication
The dashboard uses short-lived JWT access tokens plus a revocable refresh token.
- 1POST /auth/login or /auth/register returns access_token, refresh_token, and expires_in.
- 2Send Authorization: Bearer <access_token> on every authenticated request.
- 3When a request 401s, POST /auth/refresh with your refresh_token to get a new pair.
- 4Server-to-server integrations should use an API key instead — see the API reference.
Embedding your chatbot
Two ways to put a trained chatbot in front of visitors.
- 1Script tag: paste the snippet from a bot's Widget tab for a floating chat bubble.
- 2Full-page chat: link directly to /chat?id={botId} for a standalone ChatGPT-style interface.
- 3Both respect any allowed-domains restriction you've set on the widget.
Webhooks
React to platform events in real time.
- 1Register an endpoint URL and choose events like lead.created or chat.completed.
- 2Save the signing secret shown once at creation — it's never shown again.
- 3Verify the X-Webhook-Signature header on incoming requests using that secret.
- 4Check delivery history any time from the Webhooks page's log view.
Looking for full endpoint details? View the API reference