Troubleshooting & FAQ

Troubleshooting & FAQ

Common issues, solutions, and frequently asked questions for FollowUp Pilot users.


Table of Contents

  1. Installation & Setup Issues
  2. Email Sending Problems
  3. Merge Fields Not Working
  4. Trigger & Automation Issues
  5. Bounce & Reply Detection
  6. Billing & Limits
  7. Performance & Speed
  8. Frequently Asked Questions

Installation & Setup Issues

Q: I installed FollowUp Pilot but don’t see the menu

Solutions:
1. Refresh the page — Close and reopen the spreadsheet
2. Check permissions — Make sure you granted all required permissions during install
3. Try a different browser — Use Google Chrome (recommended)
4. Clear cache — Clear browser cache and reload
5. Reinstall — Uninstall and reinstall the add-on

Still not working?
– Check if you’re using a Google Workspace account with restricted add-on permissions
– Contact your IT admin to whitelist FollowUp Pilot

Q: “Authorization required” error appears repeatedly

Cause: Script needs permissions to access Gmail, Sheets, Drive

Solution:
1. Click Action Plan Manager menu → any menu item
2. Click Review Permissions when prompted
3. Select your Google account
4. Click Allow
5. Grant all requested permissions

Important: FollowUp Pilot needs these permissions:
– Send email — To send campaign emails
– View and manage Gmail — For bounce/reply detection
– Manage spreadsheets — To read/write data
– Access Google Drive — For template import (optional)

Q: System won’t initialize

Error: “Failed to initialize system”

Solutions:
1. Check you have edit permissions on the spreadsheet
2. Make sure spreadsheet isn’t in view-only mode
3. Try: Action Plan Manager → 🔧 System → Re-initialize System
4. If that fails, create a fresh spreadsheet and initialize there


Email Sending Problems

Q: Emails not sending at all

Checklist:
1. ✅ Are triggers installed?
– Click Action Plan Manager → 🔧 Setup Triggers
– Verify you see confirmation message

  1. ✅ Is Agent Email configured?
  2. Open Settings sheet
  3. Check Agent Email field is filled in

  4. ✅ Is execution status Active?

  5. Open Plan Executions sheet
  6. Verify Status = “Active” (not Paused or Cancelled)

  7. ✅ Check Activity Log for errors

  8. Open Activity Log sheet
  9. Filter by Status = “Failed”
  10. Read Error Details column

  11. ✅ Wait 15 minutes

  12. Triggers run every 15 minutes
  13. Recent changes take up to 15 min to process

Q: Emails sending to spam folder

Solutions:

Immediate fixes:
1. Avoid spam trigger words — Remove: FREE, ACT NOW, URGENT, !!!
2. Personalize subject lines — Use merge fields: {{firstName}}, {{city}}
3. Don’t use ALL CAPS — Write naturally
4. Remove excessive links — Maximum 2-3 links per email
5. Include physical address — Add your business address in signature

Long-term fixes:
1. Warm up your sending — Start with 10-20 emails/day, increase gradually
2. Authenticate your domain:
– Set up SPF record
– Set up DKIM signature
– Set up DMARC policy
– (Ask your IT admin or domain provider for help)
3. Keep bounce rate under 5% — Remove bounced emails immediately
4. Don’t buy email lists — Only email people who opted in

Pro Tip: Plain text emails (not HTML) have better deliverability.

Q: “Service invoked too many times” error

Cause: Hit Gmail sending limits

Gmail limits:
– Regular Gmail: 500 emails/day, ~50/hour
– Google Workspace: 2000 emails/day, ~200/hour

Solutions:
1. Spread sends over multiple days
– Instead of 500 prospects in one day, do 50/day for 10 days
2. Upgrade to Google Workspace — Higher sending limits
3. Check Activity Log — See how many emails you sent today
4. Wait 24 hours — Limit resets after 24 hours

Q: Emails sending at wrong time

Example: Scheduled for 9 AM but sends at 2 PM

Causes & Solutions:

Cause 1: Time zone mismatch
– Open Settings sheet
– Check Time Zone setting matches your actual time zone
– Example: America/New_York, America/Los_Angeles, Europe/London

Cause 2: Trigger Hours setting
– Open Activities sheet
– Check Trigger Hours column (0-23, where 9 = 9 AM, 14 = 2 PM)
– Adjust to desired hour

Cause 3: Trigger delay
– Triggers run every 15 minutes
– Email scheduled for 9:00 AM might send at 9:00-9:15 AM


Merge Fields Not Working

Q: Email shows {{firstName}} instead of actual name

Causes & Solutions:

Cause 1: Wrong spelling
– ✅ Correct: {{firstName}} (camelCase, no spaces)
– ❌ Wrong: {{firstname}}, {{ firstName }}, {{FirstName}}

Cause 2: Prospect data missing
– Open Prospects sheet
– Check First Name column is filled in
– If only Full Name is filled, split it into First Name and Last Name

Cause 3: Wrong merge field
– Check available merge fields in Getting Started Guide
– Example: There’s no {{name}} field — use {{prospectName}} instead

Q: Address fields showing “undefined” or blank

Cause: Prospect doesn’t have address data

Solution:
1. Open Prospects sheet
2. Fill in: Address, City, State, ZIP
3. Or use conditional phrasing:
– ❌ Bad: “Your home at {{propertyAddress}} in {{city}}”
– ✅ Good: “I’d love to help you with your {{city}} real estate needs”

Q: All merge fields working except one specific field

Solution:
1. Check column spelling in Prospects sheet
2. Verify column headers haven’t been renamed
3. Standard field names:
– First Name, Last Name, Full Name (or “Name”)
– Email, Phone
– Address, City, State, ZIP
– Category, Source, Status, Tags, Notes


Trigger & Automation Issues

Q: How do I know if triggers are installed?

Check:
1. Click Action Plan Manager → 🔧 System → System Status
2. Look for “Triggers Installed: Yes”

Or manually check:
1. Open Extensions menu → Apps Script
2. Click Triggers (clock icon on left sidebar)
3. You should see 3 triggers:
– executeScheduledActivities — Every 15 minutes
– checkForBounces — Every 15 minutes
– checkForReplies — Every 15 minutes

Q: Triggers suddenly stopped working

Causes:
1. Exceeded daily quota — Wait 24 hours
2. Script error — Check Executions log in Apps Script
3. Permission revoked — Re-authorize the add-on
4. Google outage — Check https://www.google.com/appsstatus

Solution:
1. Delete existing triggers (Extensions → Apps Script → Triggers → Delete all)
2. Reinstall: Action Plan Manager → 🔧 Setup Triggers

Q: Can I adjust trigger frequency?

Current: Every 15 minutes

No, not through the UI — 15 minutes is the minimum allowed by Google Apps Script.

Workaround for faster sends:
– Manually trigger execution: Extensions → Apps Script → Click Run on executeScheduledActivities


Bounce & Reply Detection

Q: Hard bounces not being detected

Common cause: Not enough time has passed

Solution:
– Bounce detection runs every 15 minutes
– Gmail can take 5-30 minutes to send bounce notifications
– Wait 30-60 minutes after send before expecting bounce detection

Still not detecting?
1. Open Email Tracking sheet
2. Check Bounce Status column
3. Manually check Gmail inbox for bounce messages from mailer-daemon@googlemail.com

Q: Reply detection marking wrong emails

Cause: False positive due to Message-ID matching

Solution:
This is rare but can happen if:
– Prospect forwarded your email and someone else replied
– Email client is corrupting headers

Workaround:
– Open Plan Executions sheet
– Find the execution
– Change Auto Paused by Reply from TRUE to FALSE
– Change Status from “Paused” to “Active”

Q: How do I disable auto-pause on reply?

Current system: Auto-pause is automatic and cannot be disabled through UI

Workaround:
– Manually resume each campaign after reply detection
– Or edit ReplyDetectionManager.gs code (advanced users only)


Billing & Limits

Q: How do I check my current usage?

  1. Click Action Plan Manager → 💳 Billing → View Plan & Usage
  2. You’ll see:
  3. Current plan (Free / Pro Monthly / Pro Lifetime)
  4. Action Plans: X / 10 (or Unlimited)
  5. Prospects: X / 25 (or Unlimited)
  6. Emails This Month: X / 50 (or Unlimited)

Q: Hit my free plan limits — what happens?

When you reach limits:
– Action Plans: Can’t create new plans (error message appears)
– Prospects: Can’t add new prospects (error message appears)
– Emails: Can’t send more emails until next month

Solutions:
1. Wait until next month — Email limit resets monthly
2. Upgrade to Pro — Unlimited everything
3. Delete unused items — Free up space (not recommended)

Q: How do I upgrade to Pro?

  1. Click Action Plan Manager → 💳 Billing → Upgrade to Pro
  2. Choose plan:
  3. Pro Monthly: $29/month (cancel anytime)
  4. Pro Lifetime: $249 one-time (never pay again)
  5. Complete payment via Stripe
  6. Limits removed instantly (within 60 seconds)

Q: Can I downgrade from Pro to Free?

Pro Monthly: Yes, cancel subscription
– Limits re-apply at end of billing period
– Existing data stays (but you can’t add new items beyond free limits)

Pro Lifetime: No refunds or downgrades
– Lifetime means lifetime

Q: What happens to my data if I cancel Pro?

All data stays intact:
– Action Plans (but can’t create new ones beyond 10)
– Prospects (but can’t add new ones beyond 25)
– Activity Log (historical data preserved)
– Executions (active campaigns continue)

Email sending: Drops to 50/month after current billing period ends


Performance & Speed

Q: Spreadsheet is slow or freezing

Causes:
1. Too many rows — 10,000+ rows in Activity Log
2. Complex formulas — Heavy VLOOKUP or ARRAYFORMULA
3. Large attachments — Images or files embedded in sheet

Solutions:
1. Archive old data:
– Copy Activity Log rows older than 90 days to archive sheet
– Delete them from main Activity Log

  1. Remove unused sheets:
  2. Delete any empty or test sheets

  3. Optimize formulas:

  4. Replace VLOOKUP with INDEX-MATCH
  5. Limit use of volatile functions (NOW, TODAY, RAND)

  6. Split spreadsheets:

  7. Create separate spreadsheets for different campaigns
  8. One for Q1 2026, another for Q2 2026

Q: Campaigns taking too long to process

Example: Started execution 2 hours ago but first email hasn’t sent

Solutions:
1. Check trigger log:
– Extensions → Apps Script → Executions
– Look for errors

  1. Verify triggers are running:
  2. Should see new executions every 15 minutes

  3. Check quota limits:

  4. Scripts have daily execution limits
  5. View in Apps Script → Quotas

  6. Simplify action plan:

  7. Reduce number of activities
  8. Remove complex logic

Frequently Asked Questions

General

Q: Is my data visible to anyone else?
A: No. All data stays in your Google Sheet. FollowUp Pilot doesn’t store any data on external servers. Only you (and collaborators you share the sheet with) can access it.

Q: Can I use FollowUp Pilot with multiple spreadsheets?
A: Yes! Initialize the system in each spreadsheet. Each operates independently with its own prospects, plans, and executions.

Q: Can multiple team members use the same spreadsheet?
A: Yes. Share the spreadsheet with team members. They can all add prospects, start executions, etc. Emails send from whoever is configured in the Settings sheet.

Q: Does FollowUp Pilot work on mobile?
A: Limited. You can view data on mobile Google Sheets, but the add-on menu and dialogs work best on desktop Chrome.

Q: Can I export my data?
A: Yes. Your data is in Google Sheets = easy export. File → Download → CSV or Excel.

Email Sending

Q: Do emails send from my Gmail account or a third-party server?
A: Your Gmail account. Recipients see your email address as the sender.

Q: Can I schedule sends for specific dates?
A: Yes, indirectly. Change Start Date in Plan Executions to a future date. Campaign won’t start until that date.

Q: Can I send test emails before launching?
A: Yes. Add yourself as a prospect, assign the action plan, test the full sequence.

Q: What happens if I turn off my computer?
A: Campaigns continue. FollowUp Pilot runs on Google’s servers (via Apps Script), not your computer. No need to keep anything open.

Q: Can I use HTML in emails?
A: Yes. Email body supports HTML. However, plain text often performs better (higher deliverability, looks more personal).

Compliance & Privacy

Q: Is FollowUp Pilot CAN-SPAM compliant?
A: FollowUp Pilot provides the tools, but compliance is your responsibility:
– ✅ Include your physical address in email signature
– ✅ Provide unsubscribe option
– ✅ Honor unsubscribe requests within 10 days
– ✅ Don’t use deceptive subject lines

Q: Does FollowUp Pilot support GDPR?
A: Your data stays in your Google account (which can be GDPR compliant). You’re responsible for:
– Getting consent before emailing EU residents
– Providing data access/deletion upon request
– Including privacy policy link

Q: Where are API keys stored?
A: AI API keys are stored in Document Properties (not visible in sheets, not in logs). Only accessible to scripts you authorize.

Features

Q: Can I schedule phone calls and tasks, not just emails?
A: Yes! Use Activity Type = “Activity To Do” to create manual reminders for calls, texts, meetings, etc.

Q: Can I A/B test subject lines?
A: Not automatically. Workaround: Create two action plans with different subject lines, split prospects 50/50, compare results.

Q: Can I track email opens and clicks?
A: Not built-in currently. You could manually add UTM parameters to links and track in Google Analytics.

Q: Can I send attachments?
A: Not currently supported. Workaround: Include links to Google Drive files instead.

Q: Does it integrate with CRM systems?
A: Not directly. But you can export data to CSV and import to your CRM, or use Zapier/Make.com to create integrations.


Still Need Help?

Contact Support:
– Email: support@hunterfisherllc.com
– Website: https://software.hunterfisherllc.com/apps/followup-pilot/support/
– Response Time: Pro users: 24 hours | Free users: 48-72 hours

Before contacting support, please provide:
1. Description of the problem
2. Screenshot of error message (if any)
3. Screenshot of relevant sheet (Activity Log, Plan Executions)
4. Steps to reproduce the issue
5. Your plan type (Free / Pro)


Most issues have quick fixes — check this guide first! 🔧

← Back to Execution Guide | View Quick Reference →