✦ Troubleshooting Guide ✦
Common Issues & Resolutions
Quick diagnostic steps for sync delays, search precision, and integration connectivity.
1. Sync Delays & Webhooks
Issue: New messages take several minutes to appear in search.
Cause: Nexus AI batches incoming messages across high-volume channels into semantic chunks before generating vector embeddings.
Resolution: For immediate indexing of a critical thread, add a :memo: or :pushpin: emoji reaction to the message, which triggers an instantaneous high-priority webhook.
2. Re-Authorizing Expired Tokens
Issue: "Integration Disconnected" banner in dashboard.
Cause: OAuth tokens from Google Workspace or Slack expire or are revoked during enterprise password rotations.
Resolution: Visit Settings → Integrations and click Reconnect next to the affected service.
