Back to Documentation
Troubleshooting Guide
Solutions to common issues and frequently asked questions about TalkBuildr.
Knowledge Base Issues
PDF upload fails with 'File too large' error
Solution: Reduce file size to under 10MB. For large documents, split them into smaller sections or use the website scraping feature instead.
Prevention: Check file size before uploading. Use PDF compression tools if needed.
Chatbot responses are inaccurate or irrelevant
Solution: Ensure your documents are well-structured with clear headings. Upload comprehensive content rather than just keywords. Consider re-uploading with better organization.
Prevention: Review and organize documents before upload. Use descriptive file names.
Knowledge base processing takes too long
Solution: Processing time depends on document length and complexity. Large documents (100+ pages) can take 10-15 minutes. Check processing status in your chatbot settings.
Prevention: Upload smaller, focused documents. Use website URLs for frequently updated content.
Chatbot Configuration
Chatbot not responding to user messages
Solution: Check if your chatbot is published and public. Verify that the embed code is correctly installed on your website. Ensure your plan allows chatbot usage.
Prevention: Test chatbot functionality after making changes. Use the preview feature before publishing.
Chatbot gives generic or off-topic responses
Solution: Improve your knowledge base with more specific content. Add clear instructions in the chatbot welcome message. Consider adjusting the chatbot's personality settings.
Prevention: Start with a clear welcome message that sets user expectations. Upload comprehensive knowledge base content.
Chatbot styling doesn't match website theme
Solution: Update the theme color in chatbot settings. For advanced customization, consider upgrading to Pro plan for custom CSS support.
Prevention: Choose theme colors that complement your website during initial setup.
API Integration Problems
Webhook notifications not being received
Solution: Verify webhook URL is accessible from the internet. Check that your endpoint returns a 200 status code within 10 seconds. Review webhook payload format in API documentation.
Prevention: Test webhook endpoint with sample payloads before connecting to production chatbot.
API key authentication fails
Solution: Ensure you're using the correct API key format. Check that your plan supports API access (Business+ plans). Verify the X-TB-API-Key header is properly set.
Prevention: Store API keys securely and test authentication before implementing in production.
Rate limit exceeded errors
Solution: Implement proper rate limiting in your application. Consider upgrading to a higher plan for increased limits. Space out API requests appropriately.
Prevention: Monitor API usage and implement exponential backoff for rate-limited requests.
Account & Billing
Unable to upgrade or change subscription
Solution: Check that your payment method is valid and has sufficient funds. Contact support if the issue persists after updating payment information.
Prevention: Keep payment methods up to date. Monitor subscription status regularly.
Feature not available on current plan
Solution: Review plan comparison in pricing section. Upgrade to access premium features like API access, advanced analytics, or team collaboration.
Prevention: Choose the right plan based on your feature requirements from the start.
Usage limits exceeded unexpectedly
Solution: Check your usage dashboard for detailed metrics. Consider upgrading if you consistently hit limits. Optimize chatbot usage patterns.
Prevention: Monitor usage patterns and set up alerts for approaching limits.
Performance Issues
Slow chatbot response times
Solution: Optimize knowledge base size and quality. Consider using website URLs instead of large PDFs. Check your internet connection and browser performance.
Prevention: Regularly maintain and optimize your knowledge base. Monitor response time metrics.
Chatbot not loading on website
Solution: Verify embed code is correctly placed in website HTML. Check browser console for JavaScript errors. Ensure website allows external scripts and iframes.
Prevention: Test embed code on different pages and browsers before going live.
High error rates in analytics
Solution: Review error messages for patterns. Check API key validity and permissions. Ensure webhook endpoints are responding correctly.
Prevention: Implement proper error handling in your integrations. Monitor error rates regularly.
Frequently Asked Questions
How do I reset my chatbot's knowledge base?
Go to your chatbot settings, navigate to the Knowledge Base section, and use the 'Clear All' option. Note that this action cannot be undone.
Can I change my chatbot's personality after creation?
Yes, you can update the welcome message, tone, and other personality settings in the chatbot configuration at any time.
How do I migrate from one plan to another?
Plan changes take effect immediately. Higher-tier plans unlock additional features, while downgrades maintain current functionality until the next billing cycle.
What happens if I exceed my plan limits?
You'll receive warnings before hitting limits. Once exceeded, certain features may be temporarily disabled until the next billing cycle or plan upgrade.
How do I backup my chatbot configuration?
While we don't offer direct export, your chatbot configuration is safely stored and can be recreated if needed. Consider documenting your setup for easy restoration.
Still Need Help?
Can't find a solution to your problem? Our support team is here to help you succeed with TalkBuildr.