Verifying Installation & Troubleshooting

Confirm your chatbot is working correctly and resolve common installation issues.

In short: If your Hyperleap AI chatbot doesn't appear on your website, check that your domain is on the whitelist and that the embed code is placed correctly; for console errors, verify the chatbotId and privateKey in the snippet.

Verifying Installation

After adding the code to your website:

  1. Visit your website in a new browser tab
  2. Look for the chat button (usually bottom-right)
  3. Click it to open the chat widget
  4. Test a conversation to ensure everything works

Troubleshooting

Chatbot not appearing?

Check domain whitelist and code placement

Console errors?

Verify chatbotId and privateKey are correct

Styling issues?

Check for CSS conflicts with your site

Publish or channel connect refused?

Your Behaviour must describe a business. Studio shows the reason; add what your business does and who the chatbot serves, then publish again

Chatbot says it can't reply right now?

Your organization is out of credits. The chatbot stops replying on every channel and the owner gets an email; add a credit pack or wait for your monthly credits

Why a Publish Can Be Refused

When you publish a chatbot, or connect it to WhatsApp, Instagram, or Messenger, Studio checks that its Behaviour describes a real business. An empty Behaviour, the stock "You are a helpful assistant", or a general-purpose assistant or character with no business behind it is refused, and Studio shows the reason. Meta's WhatsApp Business terms and our own terms only allow business agents. Add what your business does and who the chatbot serves, or use Generate Behaviour, then publish again. If you think the check got it wrong, email support@hyperleap.ai.

When Credits Run Out

Every AI reply uses credits. When your organization runs out, the chatbot stops replying on every channel. Website visitors see a polite "This assistant can't reply right now" message instead of an error, and the organization owner gets an email (at most once a week) with a link to add credits. Replies resume as soon as credits are available again.

Next Steps

Want to deploy your chatbot to messaging platforms? See Channels to connect WhatsApp, Instagram, and Facebook.

Explore Hyperleap AI

An AI front desk that answers customer questions, collects contact details, and books appointments on your website and messaging channels.