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.
A note on data:conversations are stored per visitor session so the chatbot can keep context, and every debit is visible in the GrinGhost ledger. Only index content you're comfortable making public — everything you index can be surfaced in an answer.