Bridge Builder Pro – AI Agent Training Guide

Knowledge Base for Customer Support AI Agent – v1.6.7

🤖 How to Use This Guide

This document provides:

Structured Q&A for common questions
Decision trees for troubleshooting
Step-by-step workflows
Product boundaries (what it does/doesn’t do)
When to escalate to human support

Format: Each section is structured for AI parsing and quick responses.

📋 PRODUCT OVERVIEW

What Bridge Builder Pro Is

WordPress plugin for creating bridge pages (pre-sell pages)
3 professional templates (Story Sell, Problem-Solution, Review)
AI-powered content generation (Anthropic Claude or OpenAI)
GetResponse email capture integration (optional)
Static HTML page publishing
Unlimited page creation

What Bridge Builder Pro Is NOT

NOT a full website builder
NOT a landing page builder for complex funnels
NOT an email marketing service (integrates with GetResponse)
NOT a traffic generation tool
NOT a funnel builder like ClickFunnels
NOT a payment processor

Current Version

Version: 1.6.7
Release Date: November 2025
Status: Stable, production-ready

🎯 COMMON CUSTOMER QUESTIONS & ANSWERS

Installation & Setup

Q: How do I install the plugin? A: Three steps:

WordPress admin → Plugins → Add New → Upload Plugin
Upload bridge-builder-pro-v1.6.7.zip
Click Install Now, then Activate Look for “Bridge Builder” in sidebar to confirm.

Q: What are the system requirements? A:

WordPress 5.0 or higher
PHP 7.4 or higher
Any hosting (shared, VPS, dedicated)
No special server requirements

Q: Do I need an API key? A: YES for AI content generation. Choose ONE:

Anthropic Claude API (recommended) from console.anthropic.com
OpenAI API from platform.openai.com NO API key needed if you write content manually.

Q: How much does the AI cost? A: Very affordable:

Typical page: $0.01 to $0.05
100 pages: $1 to $5
You pay the API provider directly (Anthropic or OpenAI)
Not included in plugin price

Q: Do I need GetResponse? A: NO, it’s optional. Only needed if you want to:

Capture email addresses
Build your email list
Follow up with leads Otherwise, use CTA buttons to send directly to offers.

Creating Pages

Q: How long does it take to create a page? A: With AI content generation: 5-10 minutes total

2 min: Choose template
5-10 sec: AI generates content
3 min: Personalize and add media
1 min: Publish

Q: Can I create pages without AI? A: YES! You can:

Write all content manually
Copy/paste from other sources
Use AI as a starting point and edit AI is optional but recommended.

Q: How many pages can I create? A: UNLIMITED. No restrictions on:

Number of pages
Page views/traffic
How often you create them

Q: Which template should I use? A: Choose based on your content type:

Story Sell: Personal stories, testimonials, journeys
Problem-Solution: Pain point → solution, product promos
Review: Product reviews, comparisons, recommendations

Q: Can I switch templates after creating a page? A: NO. Template is locked after creation. Instead:

Duplicate the page
Choose different template
Content carries over
Publish new version

Q: Can I edit a published page? A: YES! Edit anytime:

Click Edit in library
Make changes
Click Save
Click Republish
Hard refresh browser (Ctrl+Shift+R)

AI Content Generation

Q: Which AI provider is better? A: Both work great:

Anthropic Claude: Recommended, natural tone, great storytelling
OpenAI GPT-4: Also excellent, slightly different style Try both and see which you prefer.

Q: How do I write a good AI prompt? A: Use this formula:

"I'm promoting [PRODUCT NAME] for [TARGET AUDIENCE].
It [WHAT IT DOES] and costs [PRICE].
Main benefits: [LIST 3 BENEFITS].
Use [TONE] tone."

BAD: “Weight loss program” GOOD: “I’m promoting a weight loss program for busy moms. It teaches meal planning and home workouts and costs $47. Main benefits: no gym needed, family-friendly meals, 30-day support. Use an encouraging tone.”

Q: Can I edit AI-generated content? A: YES! Always edit:

Personalize to your voice
Add specific details
Fix any inaccuracies
Test different versions AI is a starting point, not final copy.

Q: AI generated content with backslashes (you’ve, can’t) A: This was fixed in v1.6.4. Solution:

Update to v1.6.7 (includes automatic cleanup)
For existing pages: Edit, remove backslashes manually, save
New pages won’t have this issue

Q: AI content is too generic A: Make your prompt more specific:

Include exact product name
Mention specific features/benefits
Define target audience clearly
Specify desired tone
Add unique selling points

Media & Images

Q: What image sizes should I use? A: Recommended sizes:

Banner: 1920×600 pixels, under 500KB
Featured: 800×600 pixels, under 300KB Always compress before uploading (TinyPNG.com)

Q: Can I upload videos? A: NO direct upload. Use YouTube:

Upload video to YouTube
Set to “Public”
Copy YouTube URL
Paste in Bridge Builder Video embeds automatically.

Q: Supported image formats? A: YES: JPG, PNG, WebP NO: BMP, TIFF, PSD, GIF (animated)

Q: Why aren’t my images showing? A: Common causes:

Not a full URL (must be: https://site.com/image.jpg)
Image not publicly accessible
File too large (over 2MB)
Wrong format Solution: Upload to WordPress Media Library, copy “File URL”

Q: YouTube video won’t embed A: Check these:

Video must be “Public” (not Unlisted or Private)
Video not deleted
Use full URL: https://www.youtube.com/watch?v=VIDEO_ID
Embedding allowed in video settings

GetResponse Integration

Q: How do I set up GetResponse? A: Four steps:

Get API key: GetResponse → Menu → Integrations & API → API
Bridge Builder → Account → Paste API key → Save
Your lists load automatically
Enable opt-in on each page + select list

Q: What happens when someone opts in? A: Three-step process:

Visitor enters name and email
Contact added to selected GetResponse list
Visitor automatically redirected to your CTA URL All happens in 1-2 seconds.

Q: Why show opt-in form instead of CTA button? A: Strategic reasons:

Build email list while promoting
Follow up with non-buyers
Multiple touchpoints increase sales
Own the relationship
Long-term asset

Q: Can I use other email services? A: NO. Currently only GetResponse supported. Coming later: AWeber, MailChimp, ConvertKit Use GetResponse for now.

Q: Opt-in form not showing A: Checklist:

[ ] Opt-in enabled (checkbox checked)
[ ] GetResponse list selected (not just enabled)
[ ] Page published (not draft)
[ ] Hard refresh browser (Ctrl+Shift+R) If all checked and still not showing, click Republish.

Q: Emails not going to GetResponse A: Troubleshooting:

Verify API key valid
Check list selected in page settings
Look in GetResponse “Pending” contacts
Test with different email
Confirm list hasn’t reached limit

Publishing & URLs

Q: Where are pages hosted? A: On your WordPress server at: yoursite.com/wp-content/uploads/bridge-pages/username/page-slug.html They’re static HTML files (fast, secure).

Q: Can I use a custom URL? A: YES! Set custom slug:

Before: amazing-weight-loss-program-a8f9.html
Custom: weight-loss.html Enter in “Custom URL Slug” field before publishing.

Q: What if my custom slug is taken? A: Error: “Slug already exists” Solution: Choose different slug:

Add year: weight-loss-2025
Add month: weight-loss-jan
Add variation: weight-loss-v2

Q: Can I change URL after publishing? A: YES but be careful:

Edit page
Change slug
Republish WARNING: Old URL breaks. Update anywhere you shared it.

Q: Page shows 404 error A: Causes:

Page not actually published (check status)
Wrong URL (verify path)
File permissions issue
File deleted manually Solution: Click Republish button in library.

Q: How do I unpublish a page? A: Can’t unpublish, only delete:

My Pages → Find page
Click Delete button
Confirm HTML file removed from server.

Display & Layout Issues

Q: Both CTA button and opt-in form showing A: This was fixed in v1.6.6. Solution:

Update to v1.6.7
Click “Republish” button in library
Hard refresh browser (Ctrl+Shift+R) Should show ONLY opt-in form (if enabled) OR CTA button.

Q: Preview doesn’t match published page A: Two causes:

Page not republished after edits
Browser cache Solution:
Click Republish in library
Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)

Q: How do I test mobile appearance? A: Three methods:

Real device (best)
Chrome DevTools (F12 → Device Toolbar)
Browser resize (least accurate) All pages automatically responsive.

Q: Can I customize colors/fonts? A: NO. Templates use fixed professional designs. Why: Tested for conversions, consistent branding. Alternative: Request custom development (contact support).

Q: Can I remove elements I don’t want? A: Partially:

Leave fields blank = element hidden
Bullets blank = no bullet section
Video blank = no video
Banner blank = no banner But can’t remove headline, body, CTA (required).

Page Management

Q: How do I duplicate a page? A: Quick A/B testing:

My Pages → Find page
Click “Duplicate” button
New page created (draft status)
Title has “(Copy)” appended
Edit and customize
Publish when ready

Q: What’s the Republish button for? A: Forces regeneration of live HTML. Use when:

After plugin updates
Live page doesn’t match preview
Display issues
Template fixes applied Doesn’t change content, just refreshes HTML file.

Q: Can I organize pages into folders? A: NO. All pages in one library view. Workaround: Use descriptive page titles:

“Facebook-WeightLoss-Jan2025”
“Google-MakeMoney-Offer1”
“YouTube-Affiliate-Product”

Q: How do I find a specific page? A: Currently: Scroll through library Tip: Use descriptive page titles Coming later: Search and filter features

Q: Can I export pages? A: YES:

Draft pages: Click “Export” → Downloads HTML
Published pages: Right-click live URL → Save As Use to host elsewhere or archive.

🚨 TROUBLESHOOTING DECISION TREES

Issue: “API Key Invalid”

Is API key entered?
├─ NO → Enter API key in Account settings
└─ YES
    └─ Is correct provider selected?
        ├─ NO → Select correct provider (Anthropic/OpenAI)
        └─ YES
            └─ Did you copy entire key?
                ├─ NO → Copy entire key, no spaces
                └─ YES
                    └─ Generate new key
                        └─ Still invalid? → Contact API provider

Issue: “Page Won’t Save”

Are all required fields filled?
├─ NO → Fill: Title, Headline, Body, CTA Text, CTA URL
└─ YES
    └─ Any JavaScript errors in console (F12)?
        ├─ YES → Disable other plugins, try again
        └─ NO
            └─ Try different browser
                └─ Still failing? → Contact support

Issue: “Images Not Displaying”

Is URL full and complete?
├─ NO → Use: https://site.com/image.jpg
└─ YES
    └─ Open image URL in browser tab
        ├─ Shows image → Check file size (<2MB)
        ├─ 404 error → Re-upload image
        └─ Permission denied → Make publicly accessible

Issue: “GetResponse Not Capturing Emails”

Is opt-in enabled?
├─ NO → Enable in page settings
└─ YES
    └─ Is list selected?
        ├─ NO → Select list from dropdown
        └─ YES
            └─ Check GetResponse
                ├─ In "Pending" → Needs confirmation
                ├─ Not there → Test with different email
                └─ Still not working → Re-enter API key

⚠️ PRODUCT LIMITATIONS (What It Can’t Do)

Technical Limitations

❌ Cannot create multi-page funnels
❌ Cannot process payments
❌ Cannot send emails directly (needs GetResponse)
❌ Cannot track conversions (need external tools)
❌ Cannot A/B test automatically
❌ Cannot customize colors/fonts
❌ Cannot edit template layouts
❌ Cannot create custom templates
❌ Cannot import pages from other tools
❌ Cannot schedule publishing
❌ Cannot set passwords on pages
❌ Cannot integrate with AWeber/MailChimp yet

By Design

✅ Intentionally simple (not overwhelming)
✅ Fixed templates (tested for conversions)
✅ Static HTML (fast, secure)
✅ Single-page focus (not funnel builder)

Workarounds

Need funnels? → Use with ClickFunnels/Leadpages Need payments? → Link to Stripe/PayPal checkout Need tracking? → Add UTM parameters to URLs Need other email service? → Manually export contacts Need custom design? → Request custom development

🎯 COMMON USE CASES & WORKFLOWS

Use Case 1: Affiliate Marketing

Goal: Promote affiliate offer, capture leads

Workflow:

Create page with Story Sell template
Generate AI content about product experience
Enable GetResponse opt-in
CTA URL = affiliate link
Traffic → Page → Opt-in → Redirect to offer
Follow up via email for multiple touchpoints

Best For: ClickBank, JVZoo, Warrior Plus offers

Use Case 2: Product Review

Goal: Review product, earn affiliate commission

Workflow:

Create page with Review template
AI generates pros/cons, features
Add YouTube review video (optional)
CTA URL = affiliate link
Traffic → Page → CTA button → Offer

Best For: Amazon Associates, product comparisons

Use Case 3: Lead Generation

Goal: Capture leads for high-ticket service

Workflow:

Create page with Problem-Solution template
Focus on pain points
Enable GetResponse opt-in
CTA URL = booking calendar/application
Traffic → Page → Opt-in → Calendar

Best For: Coaches, consultants, B2B services

Use Case 4: Pre-Sell for Launch

Goal: Build list before product launch

Workflow:

Create page 2 weeks before launch
Problem-Solution template
Enable opt-in (build list)
CTA URL = waitlist/early bird
Send traffic, build anticipation
Update CTA to sales page on launch

Best For: Course launches, product releases

🔄 STEP-BY-STEP WORKFLOWS

Workflow: Create First Page (Complete)

1. Install Plugin
   └─ Plugins → Add New → Upload → Activate

2. Add API Key
   ├─ Get key from console.anthropic.com
   └─ Bridge Builder → Account → Paste → Save

3. Start New Page
   └─ Bridge Builder → Create New

4. Choose Template
   ├─ Story Sell (personal stories)
   ├─ Problem-Solution (pain points)
   └─ Review (product reviews)

5. Generate AI Content
   ├─ Describe offer in prompt box
   ├─ Click "Generate with AI"
   └─ Wait 5-10 seconds

6. Personalize Content
   ├─ Edit headline for impact
   ├─ Adjust body copy to your voice
   ├─ Modify bullets
   └─ Check preview (right side)

7. Add Call-to-Action
   ├─ CTA Text: Action-oriented ("Get Started Now")
   └─ CTA URL: Your affiliate link/offer page

8. Optional: Add Media
   ├─ Banner image (1920×600px)
   ├─ Featured image (800×600px)
   └─ YouTube video URL

9. Optional: Enable Opt-in
   ├─ Check "Enable opt-in form"
   └─ Select GetResponse list

10. Save and Publish
    ├─ Click "Save Page"
    ├─ Set custom slug (optional)
    ├─ Click "Publish Page"
    └─ Copy live URL

11. Test Everything
    ├─ Open live URL
    ├─ Click CTA button (verify link works)
    ├─ Test on mobile device
    └─ Submit test opt-in (if enabled)

12. Drive Traffic
    └─ Share URL in ads, emails, social media

Workflow: Set Up GetResponse

1. Get API Key
   ├─ Log into GetResponse
   ├─ Menu → Integrations & API → API
   ├─ Click "Generate API Key"
   └─ Copy key

2. Add to Bridge Builder
   ├─ Bridge Builder → Account
   ├─ GetResponse Integration section
   ├─ Paste API key
   └─ Click "Save Settings"

3. Verify Connection
   ├─ Green checkmark appears
   ├─ "Connected successfully" message
   └─ Lists available in dropdown

4. Enable on Page
   ├─ Edit page
   ├─ GetResponse Opt-In section
   ├─ Check "Enable opt-in form"
   ├─ Select list from dropdown
   └─ Save page

5. Test Opt-In
   ├─ Publish page
   ├─ Visit live URL
   ├─ Submit test opt-in
   ├─ Check GetResponse for contact
   └─ Verify redirect to CTA URL

Workflow: A/B Test Pages

1. Create Baseline
   └─ Create and publish first version

2. Duplicate Page
   ├─ My Pages → Find page
   └─ Click "Duplicate" button

3. Change ONE Element
   Choose one to test:
   ├─ Headline only
   ├─ CTA button text only
   ├─ Template only (keep content same)
   └─ Opening paragraph only

4. Publish Variant
   └─ Edit duplicate → Save → Publish

5. Split Traffic
   ├─ Version A URL: 50% of traffic
   └─ Version B URL: 50% of traffic

6. Track Results
   ├─ Use UTM parameters: ?source=versionA
   ├─ Track conversions in affiliate dashboard
   └─ Run for at least 100 visitors each

7. Pick Winner
   ├─ Calculate conversion rate
   ├─ Use winner for all traffic
   └─ Test next element

Workflow: Update Published Page

1. Edit Page
   └─ My Pages → Click "Edit"

2. Make Changes
   ├─ Update content
   ├─ Change images
   ├─ Modify CTA
   └─ Check preview

3. Save Changes
   └─ Click "Save Page" button

4. Republish
   └─ My Pages → Click "Republish" button

5. Verify Updates
   ├─ Hard refresh browser (Ctrl+Shift+R)
   ├─ Check live page
   └─ Test all links

🎓 BEST PRACTICES & RECOMMENDATIONS

Content Best Practices

Headlines:

Keep under 10 words
Make a specific promise
Create curiosity
Use numbers when possible
Test multiple versions

Body Copy:

3-5 paragraphs ideal
Focus on benefits, not features
Create emotional connection
Build curiosity (don’t give it all away)
End with transition to CTA

Bullets:

3-5 bullets maximum
Start with benefit
Be specific
Use power words
Avoid generic statements

CTA Buttons:

Action verbs (“Get”, “Discover”, “Claim”)
Create urgency when appropriate
Promise clear benefit
2-4 words ideal
Test different variations

Media Best Practices

Images:

Always compress before uploading
Use relevant, high-quality images
Avoid stock photos that look stock
Test with and without images
Optimize for mobile

Videos:

2-5 minutes ideal
Hook in first 10 seconds
Show, don’t just tell
End with clear next step
Test video vs no video

Conversion Optimization

Page Design:

One clear call-to-action
Remove distractions
Use white space
Mobile-first thinking
Fast loading (compress images)

Testing Strategy:

Test one element at a time
Need 100+ visitors per variant
Track conversions, not just clicks
Be patient (don’t change too fast)
Document what you learn

Traffic Quality:

Target specific audience
Use relevant keywords/interests
Pre-qualify in ad copy
Set expectations correctly
Track source performance

🆘 WHEN TO ESCALATE TO HUMAN SUPPORT

Escalate When:

Technical Issues:

[ ] Plugin won’t activate
[ ] Database errors
[ ] Server errors (500, 503)
[ ] Files won’t upload at all
[ ] Pages won’t save after all troubleshooting

Account Issues:

[ ] Licensing questions
[ ] Billing disputes
[ ] Refund requests
[ ] Multiple site installation questions

Feature Requests:

[ ] “Can you add X feature?”
[ ] Custom development needs
[ ] Integration with other tools not supported

Bug Reports:

[ ] Consistent, reproducible errors
[ ] Content disappearing
[ ] Corrupted pages
[ ] Security concerns

Beyond Scope:

[ ] WordPress hosting issues
[ ] Domain/DNS problems
[ ] GetResponse account issues
[ ] API provider billing
[ ] General WordPress questions

DO NOT Escalate When:

[ ] User hasn’t tried basic troubleshooting
[ ] Question answered in documentation
[ ] Simple how-to questions
[ ] Requesting features product doesn’t have
[ ] General “how to make money” advice

📞 SUPPORT CONTACT INFORMATION

Email: support@mcreasoft.com

Response Time: Within 24 hours (usually faster)

Required Information:

Plugin version (v1.6.7)
WordPress version
Browser being used
Detailed issue description
Steps already tried
Screenshots if applicable

🔑 KEY FACTS FOR AI AGENT

Quick Reference Data

Current Version: 1.6.7
Release Date: November 2025
Plugin Type: WordPress
Price Model: One-time or subscription (check with customer)
Support Email: support@mcreasoft.com

Page Limits:

Pages: Unlimited
Templates: 3 available
File Size: 57KB plugin

API Costs:

Per page: $0.01-0.05
Provider: User pays directly
Not included in plugin price

Integrations:

Email: GetResponse only (current)
AI: Anthropic Claude or OpenAI
Video: YouTube only
Images: Standard formats (JPG, PNG, WebP)

System Requirements:

WordPress: 5.0+
PHP: 7.4+
MySQL: 5.6+
Memory: 128MB+

💬 SAMPLE RESPONSE TEMPLATES

Template: Installation Help

I'll help you install Bridge Builder Pro. Here's what to do:

1. Log into your WordPress admin dashboard
2. Go to Plugins → Add New → Upload Plugin
3. Choose the bridge-builder-pro-v1.6.7.zip file
4. Click "Install Now"
5. Click "Activate Plugin"

You should now see "Bridge Builder" in your WordPress sidebar.

Next steps:
- Go to Bridge Builder → Account
- Add your API key (Anthropic or OpenAI)
- Click "Create New" to start your first page!

Let me know if you run into any issues during installation.

Template: API Key Issue

If your API key isn't working, let's troubleshoot:

1. Make sure you copied the ENTIRE key (no spaces before/after)
2. Verify you selected the correct provider:
   - Anthropic Claude? Select "Anthropic Claude"
   - OpenAI? Select "OpenAI"
3. Try generating a new key from your API provider
4. Paste the new key and save

API keys are available from:
- Anthropic: console.anthropic.com
- OpenAI: platform.openai.com

The key should work immediately after saving. Try generating content on a page to test it.

Still having issues? Let me know which provider you're using and any error messages you see.

Template: GetResponse Setup

Setting up GetResponse is quick! Follow these steps:

1. Get your API key:
   - Log into GetResponse
   - Go to Menu → Integrations & API → API
   - Click "Generate API Key"
   - Copy the key

2. Add to Bridge Builder:
   - Go to Bridge Builder → Account
   - Scroll to "GetResponse Integration"
   - Paste your API key
   - Click "Save Settings"

3. You'll see a green checkmark when connected

4. Enable on each page:
   - Edit your page
   - Find "GetResponse Opt-In" section
   - Check "Enable opt-in form"
   - Select your email list
   - Save and publish

Now visitors can opt-in before being redirected to your offer!

Questions about this process?

Template: Both CTA and Opt-in Showing

This issue was fixed in v1.6.7. Here's how to resolve it:

1. First, verify you have the latest version:
   - Go to Plugins in WordPress
   - Check that Bridge Builder Pro shows v1.6.7

2. If not updated, update to v1.6.7 first

3. Then republish your page:
   - Go to Bridge Builder → My Pages
   - Find the problematic page
   - Click the yellow "Republish" button
   - Confirm the action

4. Finally, clear your browser cache:
   - Windows: Press Ctrl + Shift + R
   - Mac: Press Cmd + Shift + R

Your page should now show ONLY:
- The opt-in form (if opt-in enabled), OR
- The CTA button (if opt-in disabled)

Never both at the same time.

Check your page and let me know if it's fixed!

🎯 AGENT BEHAVIOR GUIDELINES

Tone & Style

Friendly and helpful
Clear and concise
Patient with beginners
Professional but approachable
Solution-focused

Response Structure

Acknowledge the question
Provide clear answer
Give step-by-step if needed
Offer to help further
Ask if they have questions

What to Avoid

Don’t overwhelm with information
Don’t use technical jargon unnecessarily
Don’t make assumptions about skill level
Don’t promise features that don’t exist
Don’t guess – say “I don’t know” if uncertain

When Uncertain

Refer to documentation
Suggest checking specific guide
Escalate to human support if needed
Never make up answers

📊 METRICS TO TRACK

Common Issues (Track Frequency)

API key problems
GetResponse setup
Image upload issues
Publishing errors
Template confusion
CTA/opt-in display

Response Effectiveness

First response resolution rate
Escalation rate
Customer satisfaction
Average response time

Knowledge Gaps

Questions not in training data
Feature requests
Confusion points
Documentation improvements needed

This training guide should be regularly updated as:

New versions release
Common issues identified
Customer feedback received
Features added/changed