Troubleshooting

​

Common Issues

​

Authentication Failed

• Verify BOOSTGPT_PROJECT_ID and BOOSTGPT_API_KEY in .env
• Generate new API key from dashboard if needed
• Check that credentials are not expired
• Ensure no extra spaces in environment variables

// Check credentials are loaded
console.log('Project ID:', process.env.BOOSTGPT_PROJECT_ID);
console.log('API Key:', process.env.BOOSTGPT_API_KEY ? 'Set' : 'Missing');

​

Bot Not Found

• Verify bot ID is correct
• Check bot exists in your project
• Ensure bot status is active
• Confirm you have access to the bot

// List all bots to find correct ID
const bots = await client.listBots();
console.log('Available bots:', bots.response);

​

Rate Limit Exceeded

• Implement retry logic with exponential backoff
• Add delays between requests
• Use request queue for high volume
• Upgrade to higher plan for more requests

​

Model Not Available

• Check model name spelling (e.g., gpt-5-mini not gpt5-mini)
• Verify model is available in your region
• Check model pricing and credit balance
• See Model Comparison for available models

​

Insufficient Credits

• Check credit balance in dashboard
• Add more credits or upgrade plan
• Use cheaper models for testing (e.g., gemini-flash-lite)

​

Connection Timeout

• Check your internet connection
• Verify API endpoint is reachable
• Increase timeout in HTTP client
• Try again as it may be temporary

// Set custom timeout
import axios from 'axios';

const client = axios.create({
  timeout: 30000 // 30 seconds
});

​

Training Data Not Reflected

• Wait a few seconds for indexing (usually instant)
• Verify training was added successfully
• Check training content is relevant to query
• Ensure bot has access_to_memory: true in settings

// Verify training was added
const training = await client.addTraining({
  bot_id: 'bot-123',
  content: 'Your training content'
});

if (training.err) {
  console.error('Training failed:', training.err);
}

​

Router SDK Not Receiving Messages

• Verify adapter tokens are correct (Discord, Telegram, etc.)
• Check bot has correct permissions in platform
• Ensure router.start() was called
• Check console for connection errors

router.onMessage((message, context) => {
  console.log('Received message:', message.content);
  // Make sure this logs when you send messages
});

​

Webhook Not Firing

• Verify webhook URL is publicly accessible (HTTPS required)
• Check endpoint returns 200 status code
• Test with ngrok for local development
• View webhook logs in dashboard

​

Enable Debug Logging

import { BoostGPT } from 'boostgpt';

const client = new BoostGPT({
  project_id: process.env.BOOSTGPT_PROJECT_ID,
  key: process.env.BOOSTGPT_API_KEY,
  debug: true // Enable debug mode
});

​

Check API Status

curl https://status.boostgpt.co

​

Contact Support

• Check GitHub Issues
• Join Discord Community
• Email support@boostgpt.co
• Include error messages and request IDs

​

Next Steps