Skip to main content

Frequently Asked Questions

Common questions and answers about using Hunch.

Getting Started​

How do I get started with Hunch?​

  1. Sign up for an account at hunchbank.com
  2. Add your first website in the dashboard
  3. Copy the embed code
  4. Add it to your website
  5. Configure your settings

How much does Hunch cost?​

Hunch offers three plans:

  • Free: Free forever, 500 lifetime credits, 1 website
  • Starter: $79/month or $750/year, 3,000 credits/month, 1 website
  • Professional: $199/month or $1890/year, 12,000 credits/month, 3 websites

See our pricing page for details.

What websites can I use Hunch on?​

Hunch works on any website that supports JavaScript, including:

  • WordPress
  • Shopify
  • Custom websites
  • Webflow
  • Squarespace
  • Wix

Installation​

Why isn't the widget appearing on my website?​

Check these things:

  1. Verify the embed code is properly installed
  2. Clear your browser cache
  3. Make sure your website uses HTTPS
  4. Check browser console for errors
  5. Verify the website is marked as "Verified" in the dashboard

How do I verify my installation?​

  1. Add the embed code to your website
  2. Go to your website settings in the Hunch dashboard
  3. Click "Verify Installation"
  4. The status will change to "Verified" if successful

Can I use Hunch on localhost?​

Yes, you can test on localhost during development. Add http://localhost:3000 (or your local port) as a website in the dashboard.

Configuration​

How do I change when the chat appears?​

Go to your website settings and configure the Trigger Rules:

  • Immediate (page load)
  • After delay (specify seconds)
  • On scroll (specify percentage)
  • On exit intent
  • Manual only

Can I customize the appearance?​

Yes! In website settings, you can customize:

  • Position (left/right)
  • Theme (light/dark/auto)
  • Greeting message
  • Logo
  • Avatar
  • Colors
  • Button style

Which AI model should I choose?​

Start with GPT-4o Mini for the best balance of cost and quality. Upgrade to GPT-4o or Claude for more complex queries.

Billing​

How does billing work?​

Hunch uses a credit-based billing model:

  • The free plan includes 500 lifetime credits
  • Paid plans add credits every month, even on yearly billing
  • Unused paid credits roll over while your paid subscription stays active
  • Paid plans can buy top-up packs if they run out mid-cycle

Can I change my plan?​

Yes. Go to Billing in your dashboard to upgrade, downgrade, or buy a top-up pack.

How do I cancel?​

You can cancel anytime from the Billing page. Your access continues until the end of your billing period.

What uses credits?​

Credits are consumed by costful actions:

  • 1 credit for each successful AI response
  • 1 credit for each standard page ingest or refresh
  • 2 credits for each rendered or advanced ingest
  • Cached responses and failed jobs do not consume credits

How can I verify billing emails are working?​

If you are an admin, you can trigger a controlled billing test email through the admin API:

  • POST /admin/test/billing-email
  • supported test types: low_credit, topup_confirmation

There is also a helper script in the repo:

node scripts/send-billing-test-email.js [email protected] low_credit
node scripts/send-billing-test-email.js [email protected] topup_confirmation

Troubleshooting​

The chat widget is slow to load​

This could be due to:

  • Slow internet connection
  • Large page with many scripts
  • Your server location

Try using a faster AI model or contact support.

Messages aren't being answered correctly​

Make sure your system prompt is clear and provides enough context about your business. You can customize this in Settings.

I'm getting errors in the console​

Check for:

  • Invalid API key
  • CORS issues
  • Network errors

Contact support if issues persist.

Privacy & Security​

Is my data secure?​

Yes, we use industry-standard security measures:

  • HTTPS encryption
  • Secure data storage
  • No third-party data sharing

Where is data stored?​

Data is stored on secure servers. See our Privacy Policy for details.

Who can access chat conversations?​

Only you (the account owner) can access your chat sessions through the dashboard.

Need More Help?​

If you can't find the answer here, contact us at [email protected]