Troubleshooting

Common issues and their solutions

API Issues

API Key Not Working

If your API key isn't working:

  1. Verify the key is correctly copied
  2. Check if the key is active in Studio dashboard
  3. Ensure the key has required permissions
  4. Confirm the key is added in header: x-hl-api-key
Streaming Response Issues

If streaming isn't working:

  1. Verify your client supports streaming
  2. Check network connectivity
  3. Ensure correct endpoint usage
  4. Implement proper error handling

Content & Response Issues

Content Moderation Blocks

If content is being blocked:

  1. Review content guidelines
  2. Check for prohibited content
  3. Modify input to comply with policies
  4. Contact support for clarification
Unexpected AI Responses

To improve response quality:

  1. Adjust temperature settings
  2. Check attached knowledge sources
  3. Update model parameters
Token Limit Errors

When hitting token limits:

  1. Reduce input length
  2. Split into smaller requests
  3. Optimize prompt structure
  4. Check plan limitations

Integration Issues

Chatbot Not Appearing

If your chatbot isn't showing:

  1. Verify script placement in HTML
  2. Check domain whitelist settings
  3. Confirm chatbot is published
  4. Review browser console for errors

Account & Billing

Access Denied

If you can't access features:

  1. Verify account status
  2. Check permission settings
  3. Review plan limitations
  4. Contact support if needed
Payment Issues

For billing problems:

  1. Verify payment method
  2. Check billing information
  3. Review transaction history
  4. Contact billing support

Still Need Help?

If you're still experiencing issues:

  1. Check our FAQ
  2. Review API Documentation
  3. Email us at support@hyperleapai.com
  4. Include error messages and relevant details

Explore Hyperleap AI

AI customer service agents that answer FAQs, capture leads, and book appointments across Website, WhatsApp, Instagram, and Facebook Messenger.