🛠️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

Issue	Likely Cause
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

Step	Action
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

Channel	Tip
Web Chat	Ensure the script is placed right before </body>.
WhatsApp	Verify that the Twilio number is approved for WhatsApp use.
Instagram	Confirm Instagram Business account is linked to a Facebook Page.
Slack	Reinstall app permissions if connection breaks.
Email	Double-check IMAP/POP server credentials and ports.

✅ Each platform has slightly different nuances — check those first.

---

📋 Best Practices to Prevent Future Issues

Tip	Why It Matters
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.

• Contact [e-mail] if you're stuck.

• Your Success Manager can assist with a Connection Health Review for your account.

✅ We’re here to get you back online fast.

---

🎯 Next Step

👉 Continue to Conversation Handling Errors →