Help & documentation

Quick answers for setup, crawling, billing, and the API. The hosted product and homepage demo live at https://sitewhisper.online/. For account issues, contact support@sitewhisper.online.

Widget install

After you add a site in the dashboard, copy the embed snippet. It is a single <script> tag that loads widget.js from your SiteWhisper host (for the hosted service, scripts are served from https://sitewhisper.online) with your public API key.

Try it first: the homepage has a live demo you can use without creating an account. Your own sites use the embed code from the dashboard and your site's API key.

  • Plain HTML / static sites: paste the snippet before </body>.
  • Webflow / Framer / custom SPAs: add the same snippet to the site-wide footer or layout so it loads on every page.
  • Optional: use data-color, data-position, and other attributes documented in the dashboard "Customize" panel.

WordPress & Shopify

Full step-by-step files (WordPress plugin source, Shopify Liquid snippet, Webflow, Wix, and more) live in the public GitHub repo under integrations/. Your API key always comes from the dashboard embed block for each site.

  • WordPress (plugin): download or clone the repo, zip the folder integrations/wordpress/sitewhisper, then in WP admin use Plugins → Add New → Upload Plugin. Activate it and open Settings → SiteWhisper to paste your key. Alternatively, paste the dashboard script into a footer injection plugin or your child theme’s wp_footer.
  • Shopify: Online Store → Themes → Edit code → theme.liquid → place the same snippet before </body> (see integrations/shopify/README.md). There is no Shopify App Store install yet; this is a theme embed.

How crawling works

When you submit a URL, SiteWhisper discovers pages on the same host (using your sitemap when available, plus link following). HTML is cleaned (nav, footers, boilerplate reduced), split into chunks, and embedded for retrieval. You can supplement with PDFs, manual Q&A (including CSV import), and text snippets under Sources.

Re-crawl and optional scheduled re-crawl keep the index fresh when you change pricing, policies, or docs.

Plan limits

Limits apply per billing account: number of sites, monthly chat messages, pages per crawl, and analytics depth. Exact numbers are shown on the pricing section and in the dashboard. Free plans include basic analytics; Starter and Pro unlock full analytics (e.g. extended question lists and per-site breakdowns).

HTTP API

Paid plans include access to the versioned API for server-side or custom integrations. Create or rotate keys from the dashboard (Account). Send Authorization: Bearer <api_key> on requests to /api/v1/... routes. The public widget key is not the same as your account API key.

Billing

Upgrades and invoices are processed through Stripe. You can open the customer portal from the Account tab to update payment method or cancel. See also the Terms of service and Privacy policy.