Setting up Grimm
Grimm answers your visitors from your content only — nothing indexed, nothing answered. Here's how to feed it, embed it, and keep it running.
How it answers, quickly
Grimm only uses the pages and documents you index. If the answer isn't in your content, it says so and points the visitor to you — it never makes things up. Each visitor message costs 1 credit from your GrinGhost budget.
Index your site
In the editor, open Knowledge and add your pages one by one — the ones that actually answer visitor questions: pricing, FAQ, opening hours, services. Each indexed page is billed once (see /pricing) and can be re-crawled anytime to refresh it.
If you've restricted Domains, you can only crawl pages from those domains.
Upload a document
No page to point at? Write your knowledge as a Markdown file (.md) and upload it in the same tab — a menu, an FAQ, internal notes. Minimum 100 characters, maximum 300 KB. Re-uploading a file with the same name replaces its previous version.
Embed the widget
Copy the script from the Integration tab and paste it right before the closing </body> tag — WordPress, Webflow, custom sites, no plugin:
<script src="https://grimmchat.com/widget.js" data-chatbot-id="YOUR_CHATBOT_ID"></script>
Options: data-bottom="24" raises the bubble, data-autoopen="true" opens the chat on load. Use the ▶ Test button in the editor to try it before publishing.
Budget and credits
Grimm spends from the budget you set on your GrinGhost dashboard — it can never go over. When the budget runs out, the widget tells your visitors the chat is temporarily unavailable; renew the budget and come back to your GrimmChat dashboard once (the payment token refreshes automatically), and the chat resumes.
Common errors
- "Insufficient budget" — set or renew your budget on GrinGhost, then return to the dashboard and retry.
- "Domain not allowed" — add the site's domain in the Domains tab (or leave the list empty to allow everywhere).
- "Too many requests" — indexing is limited to a few pages per minute; wait a minute and retry.
- The widget doesn't show up — check the script is before </body> and the chatbot id is correct.