> For the complete documentation index, see [llms.txt](https://docs.scopecatch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scopecatch.com/trouble-shooting/troubleshooting-guide.md). # Troubleshooting Guide Common issues and how to fix them. *** ### Bot Not Responding #### **Symptom:** You run `/scopecatch setup` but nothing happens. #### **Causes & Fixes:** **1. Bot not installed** * Go to Slack App Directory → Search "ScopeCatch" → Add to Slack **2. Permissions revoked** * Go to Slack Settings → Apps → ScopeCatch → Check permissions * If any are disabled, re-enable them * May need to re-install **3. Slack is slow** * Wait 10-15 seconds * Try command again * Check [Slack Status](https://status.slack.com) **4. Bot removed from workspace** * Re-install from Slack App Directory **Still not working?**\ Email with: * Your workspace name * Screenshot of error (if any) * What command you ran *** ### Alerts Not Firing #### **Symptom:** Client sends messages but you don't get alerts. #### **Causes & Fixes:** **1. Bot not in the channel** ``` /invite @ScopeCatch ``` Run this in the channel where clients send messages. **2. Hit detection limit (Free tier)** Check if you've used 50/50 detections this month: ``` /scopecatch stats ``` If at limit: * Wait until next month (resets on 1st) * OR upgrade to Pro for unlimited **3. Message doesn't match scope** The message might actually be within scope (not scope creep). Test by asking client a question you know is out of scope. **4. Confidence threshold too high** Lower threshold to catch more: ``` /scopecatch threshold 0.70 ``` **5. Learning Mode (Days 1-7)** During first week, some scope creep may be missed. Be patient and give feedback on alerts you DO get. **Still not detecting?**\ Email with: * Example message that should have triggered alert * Your current threshold (`/scopecatch stats`) * How long you've been using ScopeCatch *** ### Feedback Buttons Not Working #### **Symptom:** You click a feedback button but nothing happens. #### **Causes & Fixes:** **1. Already clicked** Buttons disable after first click (prevents double-clicking). Refresh Slack to see confirmation message. **2. Slack is slow** Wait 5-10 seconds, button should update. **3. Network issue** Check internet connection, try again. **4. Outdated Slack client** Update Slack to latest version: * Desktop: Help → Check for Updates * Mobile: Update from App Store/Play Store **Still broken?**\ Email with: * Which button you clicked * Screenshot of alert * Slack version (Help → About Slack) *** ### Upgrade Issues #### **Symptom:** Can't upgrade to Pro / payment fails. #### **Causes & Fixes:** **1. Payment method declined** * Check card details are correct * Ensure card has funds * Contact your bank (may be flagging as fraud) * Try different card **2. Stripe Checkout not loading** * Disable browser extensions (especially ad blockers) * Try different browser * Clear cache/cookies * Try incognito mode **3. Already subscribed** Check billing portal: If already Pro, limits are already removed. **4. Workspace owner only** Only workspace owner can upgrade. Ask them to: 1. Click "Upgrade to Pro" in any alert 2. Complete payment **Still can't upgrade?**\ Email with: * Error message (screenshot) * Workspace name * Payment method type (Visa, Mastercard, etc.) We can process upgrade manually if needed. *** ### Detection Accuracy Issues #### **Symptom:** Too many false positives OR missing real scope creep. #### **Fixes:** **Too many false positives (>30%):** 1. **Raise threshold** ``` /scopecatch threshold 0.85 ``` 2. **Clarify scope definition** ``` /scopecatch edit-scope ``` Make exclusions more explicit. 3. **Give consistent feedback** Mark false positives as ❌ "No, In Scope" — ScopeCatch will learn. 4. **Wait for calibration** Takes 20-30 feedback events to calibrate well. Be patient during Days 1-14. **Missing scope creep (<70% caught):** 1. **Lower threshold** ``` /scopecatch threshold 0.70 ``` 2. **Update scope definition** Scope may have changed. Update it: ``` /scopecatch edit-scope ``` 3. **Check bot is in channel** ``` /invite @ScopeCatch ``` 4. **Verify messages are being monitored** Send test message: "Can we add 10 more pages?" (obvious scope creep) If still not detecting, email *** ### Dashboard Not Loading #### **Symptom:** `/scopecatch dashboard` command doesn't show stats. #### **Causes & Fixes:** **1. No data yet** Dashboard requires at least 1 detection. Trigger a detection first. **2. Slack is slow** Wait 10-15 seconds, try command again. **3. Database issue** Rare, but possible. Email **4. Pro features (Pro only)** Advanced analytics are Pro only. [Upgrade here](https://app.scopecatch.com/upgrade) *** ### CRF Generation Failing #### **Symptom:** Click "Generate CRF" but PDF doesn't appear. #### **Causes & Fixes:** **1. Missing project details** CRF requires: * Project name * Hourly rate * Scope definition Set these during `/scopecatch setup` **2. Server overload** Wait 30 seconds, try again. **3. Browser blocking popups** CRF link opens in new tab. Allow popups for scopecatch.com **Still failing?**\ Email with: * Project name * Scope request ID (in alert) We'll generate manually and send you the PDF. *** ### Other Issues **Scope definition too long:** Max 4,000 characters. If longer, break into bullet points or use document URL. **Multiple team members receiving alerts:** Alerts go to the channel you specified during setup. To change: ``` /scopecatch edit-project ``` **Client seeing alerts:** Ensure alert channel is internal-only (not client-facing channel). To change alert channel: ``` /scopecatch edit-project ``` **Accidental project deletion:** Cannot recover deleted projects. Set up new project: ``` /scopecatch setup ``` *** ### Contact Support **If you can't find a solution:** 📧 **Email:** **Include:** * Description of issue * Steps you've tried * Screenshots (if applicable) * Workspace name * Your email address **Response time:** * Free tier: Within 24-48 hours * Pro tier: Within 12-24 hours (priority support)