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
Step-by-step guides for WordPress, Shopify, Webflow, Wix, Squarespace, and Next.js live at sitewhisper.online/integrations. Your API key always comes from the dashboard embed block for each site.
- WordPress (plugin): download the plugin zip, 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 the Shopify guide). 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.
The Q&A CSV takes an optional third topic column (question, answer, topic). Fill it in and your widget groups those questions into clickable topic tabs — visitors browse your FAQ instead of guessing what to type. Grab the template from Sources → Import, preview the tabs before uploading, and choose whether an import adds to or replaces the tabs you already have. Two-column files keep working unchanged.
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.