Skip to main content

BrainPredict Communications Troubleshooting

Common issues and solutions to help you resolve problems quickly. Can't find your issue? Contact our support team 24/7.

Authentication & API

API Key Not Working

Symptoms:
  • 401 Unauthorized error
  • Authentication failed message
Solutions:
  • Verify API key is correct and not expired
  • Check that key starts with "bp_communications_live_"
  • Ensure key is in Authorization header: "Bearer YOUR_KEY"
  • Regenerate key if compromised

Rate Limit Exceeded

Symptoms:
  • 429 Too Many Requests error
  • Rate limit exceeded message
Solutions:
  • Check your plan tier rate limits
  • Implement exponential backoff retry logic
  • Upgrade to higher tier for more requests
  • Cache responses to reduce API calls

Connectors

Connector Connection Failed

Symptoms:
  • Connection timeout
  • Invalid credentials error
Solutions:
  • Verify platform API credentials are correct
  • Check callback URLs are properly configured
  • Ensure IP address is whitelisted (if required)
  • Test credentials directly with platform API

Data Not Syncing

Symptoms:
  • No new mentions
  • Stale data
  • Missing updates
Solutions:
  • Check connector status in Settings → Connectors
  • Verify monitoring keywords are configured
  • Review sync logs for errors
  • Reconnect the platform connector

Truth Verification

Low Confidence Scores

Symptoms:
  • Confidence <70%
  • Inconclusive results
Solutions:
  • Provide more evidence sources (3+ recommended)
  • Use authoritative sources (official docs, benchmarks)
  • Add more context to the claim
  • Verify sources are accessible and not behind paywalls

Verification Taking Too Long

Symptoms:
  • Timeout errors
  • Slow response times
Solutions:
  • Reduce number of sources to analyze
  • Use smaller documents (<10MB)
  • Check API rate limits
  • Contact support for large-scale verification

Crisis Detection

False Positive Alerts

Symptoms:
  • Too many alerts
  • Non-critical alerts
Solutions:
  • Adjust sensitivity from "high" to "medium"
  • Increase alert threshold (e.g., 70% → 80%)
  • Refine monitoring keywords
  • Use negative keywords to filter noise

Missing Crisis Alerts

Symptoms:
  • Crisis not detected
  • Late detection
Solutions:
  • Increase sensitivity to "high"
  • Lower alert threshold (e.g., 70% → 60%)
  • Add more monitoring keywords
  • Connect more social media platforms

Message Optimization

Low Engagement Predictions

Symptoms:
  • Predicted engagement <2%
  • Low optimization scores
Solutions:
  • Follow AI recommendations (emojis, power words)
  • Post at recommended times
  • Target correct audience segment
  • Test multiple message variations

Still Need Help?

Our support team is available 24/7 to help you: