Common Connection Issues
Most connection problems with Operator AI are easy to fix once you know where to look — here’s a quick guide to solving them fast.
🛠️ Common Causes of Connection Problems
Channel not receiving messages
Incorrect API keys, authentication errors, or webhook misconfiguration.
Delayed conversation syncing
API rate limits, unstable internet, or server lag.
New leads not captured
Flow misconfiguration or missing field mappings.
Web Chat widget not loading
Incorrect embed code placement or JavaScript errors.
WhatsApp/Instagram not connecting
Missing permissions, expired API tokens, or Facebook Business verification incomplete.
✅ 90% of issues fall into these common patterns.
🛠️ How to Troubleshoot Quickly
1. Check Connection Settings
Reconfirm API keys, Webhook URLs, App permissions.
2. Review Channel Logs
Look for authentication errors or webhook failures.
3. Inspect Your Browser Console (for Web Chat)
Spot JavaScript or loading errors.
4. Test Authentication Credentials
Re-login or generate fresh API keys if needed.
5. Retry Connection Setup from Scratch
Sometimes starting fresh solves hidden misconfigurations.
✅ Systematically testing each step often solves issues in minutes.
🔥 Quick Tips for Specific Channels
Web Chat
Ensure the script is placed right before </body>.
Verify that the Twilio number is approved for WhatsApp use.
Confirm Instagram Business account is linked to a Facebook Page.
Slack
Reinstall app permissions if connection breaks.
Double-check IMAP/POP server credentials and ports.
✅ Each platform has slightly different nuances — check those first.
📋 Best Practices to Prevent Future Issues
Store API keys securely
Avoid expired or leaked tokens.
Document connection setups
Makes future troubleshooting much faster.
Monitor Webhook delivery logs monthly
Catch silent failures before users are impacted.
Set up simple test Flows
Regularly test with dummy data to verify connections.
Schedule quarterly Connection Health Audits
Proactively prevent surprise outages.
✅ A little prevention saves a lot of emergency fixes later.
🛟 Need Help?
Follow the troubleshooting checklists inside this documentation.
Your Success Manager can assist with a Connection Health Review for your account.
✅ We’re here to get you back online fast.
🎯 Next Step
Last updated