(Getting Started) Setting Up AI Link Suggestions

[Core Features & Tools] Setting Up AI Link Suggestions

Setting Up AI Link Suggestions

AI-powered link suggestions use advanced semantic analysis to understand content meaning and context, providing smarter, more relevant internal link recommendations. This comprehensive guide covers everything from initial setup to optimization and troubleshooting.

What Are AI Link Suggestions?

AI Link Suggestions use advanced language models (like GPT-4) to analyze your content and suggest internal links based on meaning and context, not just keyword matching.

Traditional vs. AI Suggestions:

Traditional Keyword Matching:

  • Looks for exact word matches
  • Post about "dogs" only suggests links to posts containing "dogs"
  • Misses semantic relationships
  • Limited to surface-level connections

AI-Powered Suggestions:

  • Understands context and meaning
  • Post about "canine health" suggests links to "dog food guide" (semantic match)
  • Recognizes synonyms and related concepts
  • Finds connections that keyword matching misses

Example:

Your Post: "Training Your Puppy"

Content includes: "young dogs," "canines," "pups," "new pet"

Traditional Matching: Might miss connections because exact keyword "puppy" doesn't appear everywhere

AI Matching: Recognizes all these terms relate to puppies and suggests relevant links to:

  • "Best Puppy Food"
  • "Puppy Vaccination Schedule"
  • "House Training Guide"

Benefits of AI Suggestions:

✅ Higher Relevance: Better topical matching

✅ More Connections: Finds relationships traditional matching misses

✅ Semantic Understanding: Recognizes synonyms and related concepts

✅ Quality Metrics: Link Relation Score shows relevance percentage

✅ Context Awareness: Understands what content is actually about

Prerequisites

Before setting up AI features, ensure you have:

1. Link Whisper Premium License

AI features are available only in the Premium version.

Check Your License:

  • Go to Link Whisper → Settings → Licensing
  • Verify your license shows "Active" status

2. AI Credits or OpenAI API Key

You need one of:

Option A: Link Whisper AI Credits (Recommended)

  • One-time purchase packages
  • No subscription required
  • Managed directly in Link Whisper

Option B: Personal OpenAI API Key

  • Create API key
  • Pay OpenAI directly per usage
  • More control over model selection

Recommendation: Most users should use Link Whisper AI Credits for simplicity.

3. Sufficient Site Resources

AI processing requires:

  • Memory: At least 256MB PHP memory limit
  • Execution Time: At least 300 seconds for large sites
  • Stable Internet: For API communication

How to Check:

  1. Go to Tools → Site Health → Info in WordPress
  1. Check PHP memory limit and Max execution time

Enabling AI Features

Follow these steps to activate AI-powered link suggestions.

Step 1: Navigate to AI Settings

In WordPress, go to Link Whisper → Settings → AI Settings

Step 2: Select AI Provider

You'll see a "Provider" or "AI Provider" dropdown.

Choose between:

Option A: Link Whisper AI (Recommended)

When to Use:

  • You purchased AI credits from Link Whisper
  • You want simple, managed setup
  • You prefer one-time credit purchases over subscriptions

How to Select:

  1. From the Provider dropdown, select "Link Whisper AI"
  1. Click "Save Changes"

Important: If you previously added a custom OpenAI API key in the API Key field, you must delete it before connecting to Link Whisper AI.

Why: The system prioritizes the API key field. If anything is there, it uses that instead of Link Whisper AI.

To Clear:

  1. Find the "API Key" field
  1. Delete any text in it (make it completely empty)
  1. Click "Save Changes"
  1. Then select "Link Whisper AI" as provider

Option B: OpenAI (Custom API Key)

When to Use:

  • You already have an OpenAI account
  • You want direct control over OpenAI settings
  • Very high volume usage (thousands of posts monthly)

How to Set Up:

Step 1: Get OpenAI API Key

  1. Create an account (if you don't have one)
  1. Navigate to API Keys section
  1. Click "Create New Secret Key"
  1. Copy the key (it starts with "sk-")
  1. Save it securely - you won't see it again

Step 2: Add API Key to Link Whisper

  1. Return to Link Whisper → Settings → AI Settings
  1. Select "OpenAI" as the provider
  1. Paste your API key into the "API Key" field
  1. Click "Save Changes"

Step 3: Add Payment Method to OpenAI

  1. Go to Billing section
  1. Add a credit card for pay-as-you-go charges
  1. Set spending limits if desired

Note: OpenAI charges you directly based on usage. Monitor your OpenAI billing dashboard to track costs.

Step 3: Connect Your Account (Link Whisper AI Only)

If you selected "Link Whisper AI" as the provider:

Step 1: Click Connect Button

You'll see a "Connect to Link Whisper AI" or "Connect" button.

Click it.

Step 2: Log In

A popup or redirect will prompt you to log in.

Critical: Use the same email address you used to purchase AI credits.

Example:

Purchased credits with: john@example.com

Must connect with: john@example.com

Step 3: Authorize

Grant Link Whisper permission to access your AI credits.

Click "Authorize" or "Allow"

Step 4: Return to WordPress

You'll be redirected back to your WordPress AI Settings page.

You should see:

  • "Connected" status
  • Credit balance displayed (e.g., "10,000 credits remaining")

Step 4: Begin Processing Data (CRITICAL STEP)

Once connected (or API key added), you must click "Begin Processing Data" to activate AI features.

Why This Step Is Required:

This initiates the initial AI scan of your site:

  • Indexes all post content
  • Analyzes topics and themes
  • Builds semantic relationships
  • Enables AI suggestions

How to Start:

  1. Find the "Begin Processing Data" button
  1. Click it
  1. Wait for processing to complete

Processing Time:

Small Sites (< 100 posts): 5-10 minutes

Medium Sites (100-500 posts): 15-30 minutes

Large Sites (500-1,000 posts): 30-60 minutes

Very Large Sites (1,000-5,000 posts): 1-3 hours

Huge Sites (5,000+ posts): 3-6 hours or more

Important: Keep the browser tab open during processing. Closing it may interrupt the scan.

What Happens During Processing:

  1. Content Extraction: Reads all post content
  1. AI Analysis: Sends content to AI model for semantic analysis
  1. Topic Mapping: Identifies main topics in each post
  1. Relationship Building: Maps connections between related content
  1. Index Creation: Stores results for fast suggestion generation

Progress Indicators:

You'll see:

  • Progress bar showing percentage complete
  • Status messages (e.g., "Processing post 150 of 500")
  • Estimated time remaining

Background Processing:

For very large sites, processing may continue in the background even after you close the tab.

Check back later to see if it completed.

Step 5: Verify AI Is Active

After processing completes, verify AI features are working:

Check 1: Credit Balance Visible

Go to Link Whisper → Settings → AI Settings

You should see your credit balance (e.g., "9,500 credits remaining")

Check 2: AI Suggestions Appear

  1. Open any post in the WordPress editor
  1. Scroll to the Link Whisper meta box
  1. Look for "Link Relation Score" percentages next to suggestions
  1. AI-powered suggestions show relevance scores (0-100%)

Check 3: Reports Show AI Metrics

Go to Link Whisper → Reports

You should see AI-specific metrics like:

  • Link Relation Score
  • Semantic relevance data

Choosing an AI Model

If using Link Whisper AI or OpenAI, you can select which model to use.

Available Models:

GPT-4o (Full Model)

Performance:

  • Highest quality analysis
  • Best semantic understanding
  • Most accurate relevance scoring

Cost:

  • Very high credit consumption
  • 10-12x more expensive than Mini
  • Slower processing

When to Use:

  • You need absolute best quality
  • Working with highly technical or nuanced content
  • Budget is not a concern

GPT-4o Mini (Recommended)

Performance:

  • Excellent quality for most use cases
  • Fast processing
  • 90-95% as accurate as full GPT-4o

Cost:

  • Very low credit consumption
  • Credits last 10-12x longer
  • Much faster processing

When to Use:

  • Most users should use this
  • Standard blog content
  • Budget-conscious users
  • Large sites (to conserve credits)

Recommendation: Start with GPT-4o Mini. The quality difference is minimal for internal linking, but cost savings are massive.

How to Select Model:

  1. Go to Link Whisper → Settings → AI Settings
  1. Find "Model" or "AI Model" dropdown
  1. Select "GPT-4o Mini" (recommended) or "GPT-4o"
  1. Click "Save Changes"

Credit Usage Comparison:

1,000 credits with GPT-4o Mini = ~200 posts processed

1,000 credits with GPT-4o = ~15-20 posts processed

Understanding AI Settings Options

AI Settings offers several toggles to control which features are active.

Feature Toggles:

Semantic Link Suggestions

What It Does: Enables AI-powered link suggestions based on content meaning

Credit Cost: Moderate

Recommendation: Always enable - this is the core AI feature

Link Relation Score

What It Does: Shows relevance percentage (0-100%) for each suggested link

Credit Cost: Low (minimal additional cost)

Recommendation: Enable - helps you filter low-quality suggestions

Keyword Analysis

What It Does: AI identifies what keywords/topics your content is about

Credit Cost: Moderate

When to Enable:

  • You want to understand your content's topics
  • Helpful for SEO strategy
  • Not essential for link suggestions

When to Disable:

  • Conserving credits
  • Only care about link suggestions, not keyword analysis

Product Detection

What It Does: AI identifies products mentioned in your content (for affiliate marketers)

Credit Cost: Moderate

When to Enable:

  • Affiliate sites
  • E-commerce blogs
  • Product review sites

When to Disable:

  • Non-commercial sites
  • No product mentions
  • Conserving credits

Cost Control Strategy:

To conserve credits, disable features you don't need:

Minimal Setup (Longest Credit Life):

  • ✅ Semantic Link Suggestions: ON
  • ✅ Link Relation Score: ON
  • ❌ Keyword Analysis: OFF
  • ❌ Product Detection: OFF

Full Setup (Best Features):

  • ✅ All features: ON

How AI Suggestions Differ from Standard

Understanding the difference helps you leverage AI effectively.

Traditional Keyword Matching:

How It Works:

  1. Scans post for specific words
  1. Matches those exact words in other posts
  1. Suggests links based on matches

Limitations:

  • Misses synonyms ("car" won't match "automobile")
  • Doesn't understand context
  • Can suggest irrelevant links if keywords match but topics don't

Example:

Post about "Apple (company)" mentions "apple" multiple times.

Keyword matching suggests linking to a post about "Apple (fruit)" because the word matches.

AI Would Understand: These are different topics and not suggest the fruit post.

AI Semantic Understanding:

How It Works:

  1. Reads and understands the content
  1. Identifies topics and themes
  1. Recognizes synonyms and related concepts
  1. Suggests links based on meaning, not just words

Advantages:

  • Finds connections across different vocabulary
  • Understands context
  • Better topical relevance

Example:

Post about "Digital Marketing Strategies" includes:

  • "Online advertising"
  • "Social media campaigns"
  • "Email outreach"

AI recognizes these are all marketing tactics and suggests links to:

  • "PPC Advertising Guide" (even though "PPC" isn't mentioned)
  • "Instagram Marketing Tips" (semantic match to "social media")
  • "Email Automation Tools" (semantic match to "email outreach")

Link Relation Score:

AI enables a relevance metric that traditional matching can't provide.

What It Shows: Percentage (0-100%) indicating how topically related the suggested link is to your content.

Interpretation:

90-100%: Perfect topical match (e.g., "Dog Training" → "Puppy Training Tips")

70-89%: Highly relevant (e.g., "Dog Training" → "Dog Food Guide")

50-69%: Moderately relevant (e.g., "Dog Training" → "Pet Care Basics")

Below 50%: Questionable relevance (e.g., "Dog Training" → "Cat Toys")

How to Use:

Set a minimum threshold in settings:

  • 60% minimum: Balanced quality and quantity
  • 70% minimum: Higher quality, fewer suggestions
  • 80% minimum: Very strict, only best matches

Optimizing AI Performance

Get the most from your AI credits with these optimization strategies.

1. Process in Batches

Don't process your entire site at once if you have limited credits.

Strategy:

Month 1: Process high-value posts (top 100 by traffic)

Month 2: Process next 100 posts

Month 3: Process remaining posts

How to Select Posts:

Use Google Analytics to identify:

  • Highest traffic posts
  • Best converting posts
  • Cornerstone content

Prioritize AI processing for these.

2. Use GPT-4o Mini

As mentioned, GPT-4o Mini provides 90-95% of the quality at 10-12x lower cost.

Credit Savings:

5,000 credits with GPT-4o: ~75 posts

5,000 credits with GPT-4o Mini: ~750-900 posts

3. Disable Unnecessary Features

If you don't need Keyword Analysis or Product Detection, turn them off to save credits.

4. Set Relevance Threshold High

Setting a higher minimum relevance score reduces unnecessary processing.

Lower Threshold (50%): More suggestions, but some low-quality

Higher Threshold (70%): Fewer suggestions, all high-quality

Higher threshold = fewer API calls = credits last longer

5. Monitor Credit Usage

Regularly check your credit balance in AI Settings.

If usage is higher than expected:

  • Review which features are enabled
  • Consider switching to GPT-4o Mini
  • Disable non-essential features

Troubleshooting AI Setup

Problem: Credits Not Appearing After Purchase

Solution:

  1. Clear API Key field: Delete any custom OpenAI API key
  1. Select "Link Whisper AI" as provider
  1. Click Connect: Log in with purchase email
  1. Begin Processing Data: Critical step to sync credits

See "How to Purchase AI Credits" article for detailed troubleshooting.

Problem: Processing Stalls or Times Out

Cause: Server limitations (low memory, short execution time)

Solution:

Increase PHP Limits:

  1. Contact your hosting provider
  1. Request they increase:
    • PHP memory limit to 512MB
    • Max execution time to 600 seconds

Process in Smaller Batches:

If full site processing fails, process 100 posts at a time.

Problem: No AI Suggestions Appear

Check 1: Verify AI Is Connected

Go to AI Settings and confirm:

  • Connected status shows
  • Credit balance is visible

Check 2: Check Credit Balance

If 0 credits remaining, AI features stop working.

Solution: Purchase more credits.

Check 3: Verify Processing Completed

If initial processing didn't complete, suggestions won't appear.

Solution: Return to AI Settings and click "Begin Processing Data" again.

Problem: High Credit Consumption

Cause: Using GPT-4o instead of Mini, or all features enabled

Solution:

  1. Switch to GPT-4o Mini
  1. Disable Keyword Analysis and Product Detection if not needed
  1. Set higher relevance threshold (reduces API calls)

Frequently Asked Questions

Q: Do I need AI credits for basic Link Whisper features?

A: No! Keyword-based suggestions, reports, one-click insertion all work without AI. AI is an optional enhancement.

Q: Can I switch between Link Whisper AI and OpenAI?

A: Yes, you can switch providers in settings anytime. Just clear the API key field when switching to Link Whisper AI.

Q: How long do AI credits last?

A: Typically, credits do not expire. Use them at your own pace.

Q: Will AI replace manual link building?

A: No. AI provides suggestions - you still review and approve them. It's a tool to assist, not replace, your judgment.

Q: Can AI analyze images or videos?

A: No, AI only analyzes text content. Images and videos are ignored.

Q: Does AI work with all languages?

A: AI works best with English content. Other languages may have reduced accuracy.

Q: Can I pause AI features?

A: Yes, simply disconnect the provider in AI Settings. Your unused credits remain for future use.

Need Help?

For AI setup assistance:

Subject: "AI Setup Help"

Include:

  • Which provider you're using (Link Whisper AI or OpenAI)
  • Specific issue
  • Screenshots of AI Settings page

Response Time: Usually within 24 hours

Unlock the power of semantic link analysis with AI!

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us