HoopAI AI Documentation — Comprehensive Implementation Plan

Generated from competitive research across GoHighLevel (~90 AI articles), OpenAI (59+ guides, system cards, cookbooks), Anthropic (system cards, prompt engineering, use case guides), Intercom (Fin AI docs), HubSpot (Breeze AI docs), plus industry standards (EU AI Act, NIST AI RMF, CISA guidelines).

Current State & Gap Analysis
Proposed New Navigation Structure
Phase 1: Prompt Engineering & Best Practices (HIGH PRIORITY)
Phase 2: Voice AI Deep Guides
Phase 3: Conversation AI Deep Guides
Phase 4: Workflow AI & Content AI Guides
Phase 5: Trust, Safety & Compliance
Phase 6: AI Model Information & Transparency
Phase 7: Prompt Library & Templates
Phase 8: Use Case Guides (Cookbook-Style)
Phase 9: Advanced & Developer Docs
Phase 10: SEO, Backlinks & LLM Discoverability
Backlink Strategy (Cross-Cutting)
Screenshot Strategy (No GHL Logos)
Full Page Inventory (All New Pages)
Implementation Timeline

1. Current State & Gap Analysis

What We Have (Existing AI Documentation)

Section	Pages	Coverage
AI Agents (overview, conversation AI, voice AI, etc.)	11	Core setup & config
Chat Widget (including AI chat)	5	Widget installation & AI features
Conversations (including bot status)	28	Inbox management
Automation/Workflows	25	Workflow actions
Academy (Content AI tutorial)	1	Social planner AI
Media Storage (AI images)	1	Image generation
Marketing (Social AI Writer)	1	Social content AI
Total AI-related pages	~72	Setup-focused, lacks depth

Critical Gaps (What’s Missing)

Gap	GoHighLevel Has	OpenAI Has	Anthropic Has	We Have
Prompt engineering guide	✅ AI Prompting 101	✅ Full guide + model-specific	✅ 7+ sub-pages	❌
Prompt library/templates	✅ Templates in-app	✅ Separate tab, dozens	✅ Separate tab, dozens	❌
Model cards / AI transparency	❌	✅ System cards per model	✅ System cards per model	❌
Safety & guardrails guide	❌	✅ Safety best practices + checks	✅ Reduce hallucinations, jailbreaks	❌
Trust center / compliance	❌	✅ trust.openai.com	✅ trust.anthropic.com	❌
Responsible AI page	❌	✅ Safety evaluations hub	✅ RSP + agent safety framework	❌
Voice AI deep guides	✅ 31 articles	✅ Voice agents guide	⚠️ Limited	⚠️ 1 page
Conversation design guide	⚠️ Prompting 101	✅ Prompt engineering	✅ Prompt engineering	❌
Knowledge base best practices	✅ 5 articles	N/A	N/A	⚠️ 1 page
Troubleshooting guides	✅ Per-feature	✅ Per-feature	✅ Guardrails section	❌
Use case guides (cookbook)	⚠️ Marketplace templates	✅ 241 cookbook recipes	✅ 4 deep-dive guides	❌
AI pricing/billing docs	✅ Dedicated articles	✅ Pricing page	✅ Pricing page	❌
API docs for AI features	✅ Public APIs	✅ Full API reference	✅ Full API reference	❌
Multi-language AI setup	⚠️ Implied	✅ Multilingual support	✅ Multilingual support	❌
Performance optimization	⚠️ Limited	✅ Latency + cost optimization	✅ Prompt caching, compaction	❌
Comparison guides	⚠️ Basic	✅ Model comparison tables	✅ Models overview	❌
llms.txt / GEO optimization	❌	❌	❌	❌
Backlinks / internal linking	⚠️	✅ Extensive	✅ Extensive	❌ Weak

Gap Summary

35+ new pages needed to reach competitive parity
Zero dedicated prompt engineering content
Zero safety/compliance/trust documentation
Zero AI model transparency documentation
Zero prompt templates/library
Weak internal linking between AI pages
No troubleshooting or optimization guides
No use case / cookbook-style deep dives

Modules → Automation & AI → AI Agents (11 pages)

AI & Automation (NEW TAB)
│
├── 📖 AI Overview
│   ├── What is HoopAI's AI?              ← NEW (pillar page)
│   ├── AI Features at a Glance            ← NEW (features matrix)
│   ├── AI Models & Capabilities           ← NEW (model card)
│   ├── AI Pricing & Usage                 ← NEW
│   └── AI Glossary                        ← NEW
│
├── 🚀 Getting Started with AI
│   ├── Quick Start: Your First AI Agent   ← NEW
│   ├── Choosing the Right AI Feature      ← NEW (comparison guide)
│   └── AI Setup Checklist                 ← NEW
│
├── 💬 Conversation AI
│   ├── Overview                           ← EXISTS (enhanced)
│   ├── Setting Up Conversation AI         ← EXISTS (enhanced)
│   ├── Prompt-Based Bot Setup             ← NEW (split from overview)
│   ├── Flow-Based Builder Guide           ← EXISTS (enhanced)
│   ├── Bot Actions & Automation           ← EXISTS (enhanced)
│   ├── Bot Settings & Configuration       ← EXISTS (enhanced)
│   ├── Dashboard & Analytics              ← EXISTS (enhanced)
│   ├── Multi-Channel Deployment           ← NEW
│   ├── Advanced: Multi-Bot Orchestration  ← NEW
│   └── Troubleshooting Conversation AI    ← NEW
│
├── 🎙️ Voice AI
│   ├── Overview                           ← EXISTS (enhanced)
│   ├── Creating Voice AI Agents           ← NEW (step-by-step)
│   ├── Voice AI Phone Setup               ← NEW
│   ├── Inbound vs Outbound Calls          ← NEW
│   ├── Appointment Booking via Voice       ← NEW
│   ├── Call Escalation & Transfer          ← NEW
│   ├── Voice AI Widget for Websites        ← NEW
│   ├── Testing & Debugging Voice AI        ← NEW
│   └── Troubleshooting Voice AI            ← NEW
│
├── ✍️ Content AI
│   ├── Overview                            ← EXISTS (enhanced)
│   ├── Content AI in Email Builder         ← NEW
│   ├── Content AI in Social Planner        ← NEW
│   ├── Content AI in Page Builder          ← NEW
│   ├── AI Image Generation                 ← EXISTS (enhanced)
│   └── Content AI Best Practices           ← NEW
│
├── ⭐ Reviews AI
│   ├── Overview                            ← EXISTS (enhanced)
│   ├── Auto-Pilot vs Suggestive Mode       ← NEW
│   └── Reviews AI Best Practices           ← NEW
│
├── 🧠 Knowledge Base
│   ├── Overview                            ← EXISTS (enhanced)
│   ├── Web Crawler Setup & Best Practices  ← NEW
│   ├── Training with Documents & FAQs      ← NEW (split)
│   ├── Knowledge Base Optimization         ← NEW
│   └── Troubleshooting Knowledge Base      ← NEW
│
├── 📝 Prompt Engineering (NEW SECTION)
│   ├── Prompt Engineering 101              ← NEW (pillar page)
│   ├── Writing Effective Bot Prompts       ← NEW
│   ├── Voice AI Prompting Guide            ← NEW
│   ├── Conversation AI Prompting Guide     ← NEW
│   ├── Advanced Prompt Techniques          ← NEW
│   ├── Common Prompt Mistakes              ← NEW
│   └── Prompt Optimization & Testing       ← NEW
│
├── 📚 Prompt Library (NEW SECTION)
│   ├── Overview                            ← NEW
│   ├── Customer Support Prompts            ← NEW
│   ├── Sales & Lead Qualification          ← NEW
│   ├── Appointment Booking Prompts         ← NEW
│   ├── Real Estate Prompts                 ← NEW
│   ├── Healthcare / Wellness Prompts       ← NEW
│   ├── E-Commerce Prompts                  ← NEW
│   ├── Agency & SaaS Prompts              ← NEW
│   └── Voice AI Prompt Templates           ← NEW
│
├── 🔧 Workflow AI
│   ├── Overview                            ← EXISTS (enhanced)
│   ├── GPT / AI Actions in Workflows       ← NEW
│   ├── AI Decision Maker                   ← NEW
│   ├── Connecting AI Agents to Workflows   ← NEW
│   └── Workflow AI Examples                ← NEW
│
├── 📘 Use Case Guides (NEW SECTION - Cookbook Style)
│   ├── Overview                            ← NEW
│   ├── AI Receptionist for Service Business ← NEW
│   ├── Lead Qualification Bot              ← NEW
│   ├── Appointment Scheduling Agent         ← NEW
│   ├── After-Hours Support Bot             ← NEW
│   ├── Real Estate Showing Scheduler        ← NEW
│   ├── E-Commerce Order Support Bot         ← NEW
│   ├── Multi-Location Business Bot          ← NEW
│   └── Review Response Automation           ← NEW
│
├── 🛡️ Trust & Safety (NEW SECTION)
│   ├── AI Safety & Responsible Use          ← NEW (pillar page)
│   ├── Data Privacy & AI                    ← NEW
│   ├── AI Guardrails & Content Safety       ← NEW
│   ├── Compliance (GDPR, HIPAA, SOC 2)     ← NEW
│   ├── AI Limitations & Transparency        ← NEW
│   └── Security Best Practices              ← NEW
│
└── 🔍 Advanced AI
    ├── Performance Optimization             ← NEW
    ├── Cost Optimization                    ← NEW
    ├── Multi-Language AI Setup              ← NEW
    ├── AI API Reference                     ← NEW
    └── Migration & Updates                  ← NEW

3. Phase 1: Prompt Engineering & Best Practices

Priority: HIGHEST — This is the single biggest gap. GoHighLevel has “AI Prompting 101”, OpenAI has a full prompt engineering guide, Anthropic has 7+ sub-pages. We have zero.

Page 1: `ai/prompt-engineering/overview.mdx`

Title: Prompt Engineering 101 Type: Pillar page (2,000–3,000 words) Content:

What is prompt engineering and why it matters for HoopAI bots
The 4-part framework (adapted from GHL’s Role → Task → Guidelines → Repetition model)
1. Role — Define who the AI is (business name, persona, tone)
2. Task — What the AI should do (answer questions, book appointments, qualify leads)
3. Guidelines — Guardrails (what NOT to do, off-topic handling, escalation rules)
4. Examples — Show the AI ideal interactions
How context length affects quality (keep prompts focused, not overloaded)
Quick-start: a basic prompt structure users can copy and customize
Links to every other prompt engineering sub-page (hub-and-spoke backlinks)

Backlinks TO this page from: Conversation AI setup, Voice AI setup, Bot Settings, Knowledge Base, all prompt library pages

Page 2: `ai/prompt-engineering/conversation-ai-prompts.mdx`

Title: Writing prompts for Conversation AI Content:

Step-by-step guide for crafting a Conversation AI prompt
Structure: identity → instructions → knowledge boundaries → escalation rules
Good prompt vs bad prompt examples (side-by-side comparison)
Channel-specific considerations (SMS brevity vs web chat detail)
How to handle: greetings, FAQs, appointment requests, out-of-scope questions
Testing and iterating on prompts

Page 3: `ai/prompt-engineering/voice-ai-prompts.mdx`

Title: Writing prompts for Voice AI Content:

Voice-specific prompt considerations (conversational tone, pacing, silence handling)
Structuring voice prompts: greeting → identification → task handling → closing
Handling interruptions (barge-in)
Transfer and escalation prompt patterns
Appointment booking prompt structure
Phone-specific guardrails (don’t say URLs, handle “hold on” gracefully)
Testing voice prompts effectively

Page 4: `ai/prompt-engineering/advanced-techniques.mdx`

Title: Advanced prompt techniques Content:

Multi-step prompting (chain complex tasks)
Using knowledge base references in prompts
Conditional prompt logic (“If the user mentions X, do Y”)
Tone calibration (professional, friendly, casual, formal)
Handling objections and pushback
Prompt versioning and A/B testing concepts

Page 5: `ai/prompt-engineering/common-mistakes.mdx`

Title: Common prompt mistakes and how to fix them Content:

Top 10 mistakes with before/after examples:
1. Prompt too vague → be specific
2. Prompt too long → trim to essentials
3. No escalation rules → add human handoff
4. No personality defined → set tone and voice
5. Contradictory instructions → resolve conflicts
6. Missing edge case handling → add fallback responses
7. Not using knowledge base → leverage training data
8. Overly rigid responses → allow natural variation
9. No testing → use test/trial mode
10. Ignoring channel differences → tailor per channel
Troubleshooting checklist

Page 6: `ai/prompt-engineering/optimization.mdx`

Title: Prompt optimization and testing Content:

How to use HoopAI’s bot trial/testing mode effectively
Systematic testing methodology (scripts of test conversations)
Measuring prompt quality: resolution rate, handoff rate, user satisfaction
Iterative improvement cycle
When to use Conversation AI Dashboard metrics to refine prompts
A/B testing prompts (workflow-based approach)

4. Phase 2: Voice AI Deep Guides

Priority: HIGH — GHL has 31 Voice AI articles. We have 1 page. Voice AI is complex and users need hand-holding.

Page 7: `ai/voice-ai/creating-agents.mdx`

Title: Creating Voice AI agents step by step Content:

Complete walkthrough from scratch
Choosing inbound vs outbound
Agent name, voice selection, language
Assigning phone numbers
Basic vs advanced prompt modes
First test call walkthrough
Screenshots: use HoopAI UI only (no GHL branding)

Page 8: `ai/voice-ai/phone-setup.mdx`

Title: Voice AI phone number setup Content:

Purchasing/assigning phone numbers
Forwarding existing numbers
Working hours configuration
After-hours behavior
Failover and backup numbers

Page 9: `ai/voice-ai/inbound-outbound.mdx`

Title: Inbound vs outbound Voice AI calls Content:

When to use inbound (receptionist, support line)
When to use outbound (follow-ups, reminders, re-engagement)
Configuration differences
Compliance considerations for outbound calls (TCPA, consent)
Best practices for each type

Page 10: `ai/voice-ai/appointment-booking.mdx`

Title: Voice AI appointment booking Content:

Connecting calendars to Voice AI
How the AI checks availability
Booking confirmation flow
Rescheduling and cancellation via voice
CRM contact creation during calls
Custom field capture during calls

Page 11: `ai/voice-ai/call-escalation.mdx`

Title: Call escalation and transfer Content:

Setting up human handoff rules
Transfer conditions (keywords, sentiment, explicit request)
Warm transfer vs cold transfer
Escalation to specific team members
Failover when no human is available

Title: Voice AI chat widget for websites Content:

Installing the voice widget on your site
Widget customization (colors, position, greeting)
How web-based voice calls work
Integration with existing chat widgets
Analytics and call tracking

Page 13: `ai/voice-ai/testing-debugging.mdx`

Title: Testing and debugging Voice AI Content:

Web call testing mode
Phone call testing mode
Reading call logs and transcripts
Identifying prompt issues from transcripts
Common issues and fixes (latency, misunderstandings, dropped calls)
Using the prompt evaluator (if available)

Page 14: `ai/voice-ai/troubleshooting.mdx`

Title: Troubleshooting Voice AI Content:

FAQ format: problem → cause → solution
“AI doesn’t answer calls” → phone number not assigned
“AI misunderstands questions” → prompt too vague, knowledge base incomplete
“Calls drop unexpectedly” → timeout settings
“AI can’t book appointments” → calendar not connected
“Wrong timezone for bookings” → timezone configuration
“AI won’t transfer to human” → escalation rules not set
Contact support section

5. Phase 3: Conversation AI Deep Guides

Priority: HIGH — GHL has 20 articles. We have good foundation but need deeper guides.

Page 15: `ai/conversation-ai/multi-channel.mdx`

Title: Multi-channel deployment for Conversation AI Content:

SMS configuration and best practices
Instagram DM setup
Facebook Messenger setup
WhatsApp integration
Website live chat setup
Channel-specific prompt considerations (SMS = short, chat = detailed)
Unified inbox management across channels
Backlinks to each channel’s main setup page

Page 16: `ai/conversation-ai/multi-bot.mdx`

Title: Multi-bot orchestration Content:

Primary vs non-primary bots explained
When to use multiple bots (different departments, languages, campaigns)
Bot transfer workflows
Workflow-triggered secondary bots
Managing bot status per contact
Architecture diagrams for multi-bot setups

Page 17: `ai/conversation-ai/troubleshooting.mdx`

Title: Troubleshooting Conversation AI Content:

“Bot doesn’t respond” → check bot status, channel assignment
“Bot gives wrong answers” → knowledge base issues, prompt refinement
“Bot won’t stop messaging” → max messages setting, stop bot action
“Bot can’t book appointments” → calendar connection, time zone
“Bot responds too slowly” → knowledge base size, concurrent load
“Bot escalates too often / not enough” → adjust escalation triggers
Dashboard metrics for identifying issues
When to contact support

6. Phase 4: Workflow AI & Content AI Guides

Page 18: `ai/workflow-ai/gpt-actions.mdx`

Title: Using GPT / AI actions in workflows Content:

The GPT/AI workflow action explained
Setting up AI-powered responses in workflow steps
Passing contact data to AI prompts (merge fields)
Using AI output in subsequent workflow steps
Examples: AI-generated follow-up emails, AI lead scoring, AI content personalization
Backlinks to Workflow overview, Automation triggers

Page 19: `ai/workflow-ai/ai-decision-maker.mdx`

Title: AI Decision Maker in workflows Content:

What the AI Decision Maker does
Setting up natural-language conditions
Routing contacts based on AI analysis
Examples: sentiment-based routing, intent classification, lead quality scoring
Combining with traditional workflow conditions
Testing decision branches

Page 20: `ai/workflow-ai/connecting-bots.mdx`

Title: Connecting AI agents to workflows Content:

Triggering workflows from bot interactions
Bot → Workflow → Bot chains
Passing conversation context to workflows
Using workflow results in bot responses
Auto-follow-up workflows after bot conversations
Contact tagging and scoring from bot interactions
Backlinks to Conversation AI actions, Workflow triggers

Page 21: `ai/workflow-ai/examples.mdx`

Title: Workflow AI examples and recipes Content:

6-8 complete workflow recipes:
1. Lead qualification → AI score → route to sales rep
2. After-hours inquiry → bot response → morning follow-up
3. Appointment no-show → AI re-engagement sequence
4. Review received → AI response draft → approval → publish
5. New contact → AI welcome message → drip sequence
6. Support ticket → AI classification → route to team
Each recipe: goal, trigger, steps, AI configuration, expected outcome

Page 22: `ai/content-ai/email-builder.mdx`

Title: Content AI in the email builder Content:

Accessing Content AI within email campaigns
Generating subject lines, body copy, CTAs
Personalizing with merge fields + AI
A/B testing AI-generated variants
Brand voice consistency
Cost tracking and usage

Title: Content AI in the social planner Content:

Generating social posts by platform (Facebook, Instagram, LinkedIn)
Using guided content questions
Hashtag and caption generation
Image AI for social posts
Scheduling AI-generated content
Maintaining brand voice

Page 24: `ai/content-ai/page-builder.mdx`

Title: Content AI in the page builder Content:

AI-powered headline and copy generation
SEO-optimized content generation
Landing page copy best practices with AI
Blog content generation
Funnel page copy optimization

Page 25: `ai/content-ai/best-practices.mdx`

Title: Content AI best practices Content:

When to use AI vs human-written content
Editing and refining AI outputs
Brand voice configuration
Cost management (word/image credits)
Quality control workflows
Legal considerations (disclosure of AI-generated content)

7. Phase 5: Trust, Safety & Compliance

Priority: HIGH — OpenAI has a full trust portal. Anthropic has system cards + RSP. GHL has nothing. This is a differentiator AND increasingly a regulatory requirement (EU AI Act).

Page 26: `ai/trust-safety/overview.mdx`

Title: AI safety and responsible use Type: Pillar page (2,000+ words) Content:

HoopAI’s commitment to responsible AI
Core principles: transparency, safety, privacy, fairness, human oversight
How AI features are designed with safety in mind
User responsibilities when deploying AI agents
Links to all sub-pages in this section
Backlinks FROM: all AI agent pages, getting started, overview

Page 27: `ai/trust-safety/data-privacy.mdx`

Title: Data privacy and AI Content:

What data AI agents access and process
Data retention policies for AI conversations
How training data (knowledge base) is stored and used
AI data is NOT used to train third-party models (confirm this)
User consent considerations for AI interactions
GDPR compliance: data subject rights, DPA availability
Data residency options
Backlinks FROM: Knowledge Base, Conversation AI, Voice AI

Page 28: `ai/trust-safety/guardrails.mdx`

Title: AI guardrails and content safety Content:

Built-in safety features (content filtering, topic boundaries)
How to set up guardrails in your prompts
Preventing AI from sharing sensitive information
Handling inappropriate user messages
Image/content moderation in AI chat
Reducing hallucinations (grounding in knowledge base)
Monitoring and auditing AI responses
Human review workflows for sensitive industries

Page 29: `ai/trust-safety/compliance.mdx`

Title: Compliance for AI features Content:

GDPR: how HoopAI AI complies, DPA, data subject rights
HIPAA: BAA availability, PHI handling in AI conversations
SOC 2: security controls for AI infrastructure
TCPA: compliance for AI-powered outbound calls and SMS
Industry-specific guidance (healthcare, finance, legal)
Record-keeping and audit trail
Disclosure requirements (telling users they’re talking to AI)

Page 30: `ai/trust-safety/limitations.mdx`

Title: AI limitations and transparency Content:

What HoopAI AI can and cannot do
Known limitations (complex reasoning, real-time data, hallucination risk)
When AI should NOT be the sole decision-maker
Importance of human oversight for critical decisions
How we continuously improve AI capabilities
Reporting AI issues and feedback

Page 31: `ai/trust-safety/security.mdx`

Title: Security best practices for AI Content:

Securing API keys and integrations
Access control for AI features (user roles)
Preventing prompt injection in customer-facing bots
Secure knowledge base management
Monitoring for AI misuse
Incident response for AI-related issues
Third-party AI provider security (which LLM providers, their certifications)

8. Phase 6: AI Model Information & Transparency

OpenAI publishes system cards for every model. Anthropic publishes system cards for every release. This builds trust and is increasingly expected.

Page 32: `ai/overview/models.mdx`

Title: AI models and capabilities Content:

What AI models power HoopAI features (disclose provider: OpenAI, Anthropic, etc.)
Capabilities matrix: which model powers which feature
Model update schedule and versioning
Performance characteristics (response time, accuracy benchmarks)
Limitations per model type
How HoopAI selects and evaluates AI models
This is our version of a “model card” — adapted for a SaaS platform

Page 33: `ai/overview/features-matrix.mdx`

Title: AI features at a glance Content:

Master table of ALL AI features across HoopAI
For each feature: what it does, where to find it, which plan includes it, setup link
Feature comparison: Conversation AI vs Voice AI vs Content AI vs Reviews AI vs Workflow AI
Quick-reference for users choosing which AI feature to use
Backlinks TO every individual feature page

Page 34: `ai/overview/pricing.mdx`

Title: AI pricing and usage Content:

AI feature pricing breakdown
Per-feature costs (text generation, image generation, voice minutes, etc.)
Plan-level AI inclusions
Usage tracking and dashboards
Cost optimization tips
Billing FAQ for AI features
Backlinks FROM: all AI feature pages

Page 35: `ai/overview/glossary.mdx`

Title: AI glossary Content:

40+ AI terms defined in HoopAI context:
- Agent, Bot, Prompt, Knowledge Base, Training, NLU, Intent, Entity
- Auto-Pilot, Suggestive Mode, Flow Builder, Prompt-Based Bot
- Hallucination, Escalation, Handoff, Barge-in, Token, Context Window
- LLM, GPT, RAG, Fine-tuning, Embeddings, Sentiment Analysis
Each term links to the relevant feature page (backlinks)

9. Phase 7: Prompt Library & Templates

OpenAI has a full Prompt Library tab. Anthropic has a Prompt Library tab with dozens of templates. GHL has marketplace templates. We have zero.

Page 36: `ai/prompt-library/overview.mdx`

Title: Prompt library overview Content:

What is the prompt library and how to use it
How templates are structured
Customizing templates for your business
Contributing and sharing templates
Links to all category pages

Pages 37-44: Industry-Specific Prompt Templates

Each page follows a consistent template format:

Template Name:
Industry:
Use Case:
AI Feature: [Conversation AI / Voice AI / Workflow AI]
Difficulty: [Beginner / Intermediate / Advanced]

Prompt Template:
  [Full copy-paste prompt with {variables} marked]

Configuration:
  Mode: [Auto-pilot / Suggestive]
  Channels: [SMS, Web Chat, etc.]
  Knowledge Base: [Required / Optional]

Example Conversation:
  [3-4 turn sample dialogue]

Customization Tips:
  [How to adapt for specific businesses]

Related Templates:
  [Links to related prompts — backlinks]

Page 37: ai/prompt-library/customer-support.mdx — Customer support prompts (general FAQ bot, product support, billing inquiries, complaint handling) Page 38: ai/prompt-library/sales-qualification.mdx — Sales & lead qualification prompts (qualifying questions, pricing discussions, demo booking, follow-up) Page 39: ai/prompt-library/appointment-booking.mdx — Appointment booking prompts (scheduling, rescheduling, reminders, no-show follow-up) Page 40: ai/prompt-library/real-estate.mdx — Real estate prompts (property inquiry, showing scheduler, buyer qualification, listing follow-up) Page 41: ai/prompt-library/healthcare.mdx — Healthcare / wellness prompts (appointment scheduling, intake forms, follow-up care, FAQ) Page 42: ai/prompt-library/ecommerce.mdx — E-commerce prompts (order status, returns, product recommendations, abandoned cart recovery) Page 43: ai/prompt-library/agency-saas.mdx — Agency & SaaS prompts (onboarding bot, support ticket routing, feature request intake, upsell) Page 44: ai/prompt-library/voice-ai-templates.mdx — Voice AI prompt templates (receptionist, after-hours, outbound follow-up, appointment confirmation)

10. Phase 8: Use Case Guides (Cookbook-Style)

Modeled after Anthropic’s use case guides (full production walkthrough) and OpenAI’s cookbook (241 recipes). These are deep-dive, end-to-end implementation guides.

Each guide follows this structure (borrowed from Anthropic):

Goal — What you’re building and who it’s for
Prerequisites — What you need before starting
Architecture — How the pieces fit together (diagram)
Step-by-step build — Every click, every setting, every prompt
Testing — How to verify it works
Optimization — How to improve performance
Measuring success — KPIs and metrics to track

Page 45: `ai/use-cases/overview.mdx`

Title: Use case guides overview

Page 46: `ai/use-cases/ai-receptionist.mdx`

Title: Build an AI receptionist for your service business Content: Complete guide to set up a Voice AI + Conversation AI receptionist that handles calls, answers FAQs, books appointments, and escalates to humans. Covers phone setup, prompts, knowledge base, calendar integration, workflow triggers.

Page 47: `ai/use-cases/lead-qualification-bot.mdx`

Title: Build a lead qualification bot Content: Conversation AI bot that qualifies inbound leads through a series of questions, scores them, tags them in CRM, and routes hot leads to sales reps via workflow.

Page 48: `ai/use-cases/appointment-scheduler.mdx`

Title: Build an AI appointment scheduling agent Content: Multi-channel bot (SMS + web chat + voice) that handles the full appointment lifecycle: booking, confirmation, reminders, rescheduling, no-show follow-up.

Page 49: `ai/use-cases/after-hours-support.mdx`

Title: Build an after-hours support bot Content: Bot that activates outside business hours, handles common questions, captures urgent issues for morning follow-up, and books next-day appointments.

Page 50: `ai/use-cases/real-estate-agent.mdx`

Title: Build a real estate AI assistant Content: Voice AI + Conversation AI setup for real estate: property inquiries, showing scheduling, buyer/seller qualification, market question handling.

Page 51: `ai/use-cases/ecommerce-support.mdx`

Title: Build an e-commerce support bot Content: Bot for order status, return processing, product recommendations, and cart recovery. Integrates with Shopify via workflows.

Page 52: `ai/use-cases/multi-location.mdx`

Title: Build a multi-location business bot Content: Managing AI agents across multiple business locations with location-based routing, separate knowledge bases, and unified reporting.

Page 53: `ai/use-cases/review-automation.mdx`

Title: Automate review responses with Reviews AI Content: End-to-end setup of Reviews AI for Google Business Profile, configuring tone, handling negative reviews, approval workflows.

11. Phase 9: Advanced & Developer Docs

Page 54: `ai/advanced/performance.mdx`

Title: AI performance optimization Content:

Reducing bot response latency
Knowledge base optimization (size, structure, relevance)
Prompt length vs performance trade-offs
Handling high message volume
Caching and performance best practices

Page 55: `ai/advanced/cost-optimization.mdx`

Title: AI cost optimization Content:

Understanding AI usage costs
Strategies to reduce costs without sacrificing quality
Knowledge base efficiency (fewer tokens = lower cost)
Prompt efficiency techniques
Usage monitoring and alerts
Cost comparison: different AI features

Page 56: `ai/advanced/multi-language.mdx`

Title: Multi-language AI setup Content:

Configuring AI agents for multiple languages
Language detection and automatic switching
Multi-language knowledge bases
Translation workflows
Best practices for non-English AI deployment

Page 57: `ai/advanced/api-reference.mdx`

Title: AI API reference Content:

API endpoints for AI agent management
Webhook events for AI interactions
Programmatic bot configuration
Conversation data retrieval
Voice AI call data API
Rate limits and authentication

Page 58: `ai/advanced/migration.mdx`

Title: AI migration and updates Content:

Migrating from other AI chat platforms to HoopAI
Updating bots when AI models are upgraded
Exporting and importing bot configurations
Version history and rollback
Handling breaking changes

12. Phase 10: SEO, Backlinks & LLM Discoverability

Page 59: Enable `llms.txt` generation

Mintlify natively supports llms.txt — add "llms-txt": true to docs.json
This generates a machine-readable summary of all docs for LLM consumption
Critical for AI search engines (Perplexity, ChatGPT Search, Claude) to discover and cite HoopAI docs

Page 60: `ai/getting-started/overview.mdx`

Title: What is HoopAI’s AI? (Pillar page) Type: SEO pillar page (2,500–3,000 words) Content:

Comprehensive overview of ALL AI capabilities
Internal links to every AI feature page (hub-and-spoke)
Comparison table
“Start here” orientation for new users
Links to getting started guide, prompt engineering, use cases

Page 61: `ai/getting-started/choosing-ai.mdx`

Title: Choosing the right AI feature Content:

Decision tree / flowchart:
- “I need to handle phone calls” → Voice AI
- “I need to handle chat messages” → Conversation AI
- “I need to generate content” → Content AI
- “I need to respond to reviews” → Reviews AI
- “I need AI in my workflows” → Workflow AI
Feature comparison matrix
Industry-specific recommendations
Backlinks to every feature overview page

Page 62: `ai/getting-started/quick-start.mdx`

Title: Quick start: your first AI agent Content:

10-minute setup guide for a basic Conversation AI bot
Minimal viable prompt
Connect to one channel
Test the bot
Links to deeper guides for customization

Page 63: `ai/getting-started/checklist.mdx`

Title: AI setup checklist Content:

Interactive checklist format (using Mintlify Steps component)
Pre-launch checklist for AI agents:
- Define bot purpose and persona
- Write and test prompt
- Set up knowledge base
- Configure channels
- Set escalation rules
- Test with sample conversations
- Set up monitoring/analytics
- Go live

13. Backlink Strategy (Cross-Cutting)

Internal Linking Architecture

Every AI page should follow a hub-and-spoke model:

                    AI Overview (Hub/Pillar)
                         │
    ┌────────────────────┼────────────────────┐
    │                    │                    │
Conversation AI    Voice AI           Content AI
    │                    │                    │
    ├── Setup            ├── Setup            ├── Email
    ├── Prompting ◄──────┤── Prompting ◄──────┤── Social
    ├── Troubleshoot     ├── Troubleshoot     └── Page Builder
    └── Use Cases ◄──────┴── Use Cases
              │                    │
              └────────┬───────────┘
                       │
              Prompt Engineering (Hub)
                       │
              ┌────────┼────────┐
              │        │        │
         Prompt    Templates  Use Case
         Library              Guides

Backlink Rules (Enforce in Every Page)

Every AI page links back to the AI Overview pillar page
Every feature page links to Prompt Engineering 101
Every prompt library page links to the relevant feature page AND prompt engineering guide
Every use case guide links to all features it uses + prompt library + troubleshooting
Every troubleshooting page links to the setup guide + knowledge base + prompt engineering
Every trust/safety page links to the relevant feature pages + compliance page
Setup pages link to: getting started, use cases, prompt library, troubleshooting
New pages added to existing pages as “Related articles” or “Next steps” sections

Backlink Implementation Checklist

For each new page, add links in these existing pages:

New Page	Add Backlinks In These Existing Pages
Prompt Engineering 101	ai-agents/overview, conversation-ai, voice-ai, bot-settings, knowledge-base
Voice AI guides	ai-agents/voice-ai, chat-widget/ai-chat, conversations/overview
Conversation AI guides	ai-agents/conversation-ai, ai-agents/flow-based-builder, conversations/bot-status
Trust & Safety	ai-agents/overview, getting-started/overview, ALL AI feature pages
Prompt Library	ai-agents/conversation-ai, voice-ai, prompt-engineering/*
Use Case Guides	ai-agents/overview, getting-started/overview, prompt-library/*
AI Overview (pillar)	introduction.mdx, getting-started/overview, sites/overview

Every AI page ends with a standardized section:

## Next steps

<CardGroup cols={2}>
  <Card title="Prompt Engineering 101" icon="wand-magic-sparkles" href="/ai/prompt-engineering/overview">
    Learn to write effective prompts
  </Card>
  <Card title="Prompt Library" icon="book" href="/ai/prompt-library/overview">
    Copy-paste prompt templates
  </Card>
  <Card title="Use Case Guides" icon="lightbulb" href="/ai/use-cases/overview">
    End-to-end implementation guides
  </Card>
  <Card title="Troubleshooting" icon="wrench" href="/ai/[feature]/troubleshooting">
    Fix common issues
  </Card>
</CardGroup>

14. Screenshot Strategy (No GHL Logos)

The Challenge

Screenshots need to show realistic UI without GoHighLevel branding
GHL logo (green/blue/yellow arrows) must NOT appear in any screenshots

Strategy

Use HoopAI’s own UI — All screenshots taken from HoopAI’s actual sub-account interface (which is white-labeled)
If HoopAI UI is identical to GHL — Take screenshots from a white-labeled sub-account where:
- Custom logo is set to HoopAI logo
- Custom favicon is HoopAI
- Custom domain is used
- Agency branding is HoopAI throughout
For diagrams and flowcharts — Use Mermaid diagrams in Mintlify (no screenshots needed)
For architecture diagrams — Use custom illustrations or Mermaid
For step-by-step guides — Use Mintlify’s <Steps> component with annotated screenshots
Screenshot checklist before publishing:
- No GHL logo visible anywhere in the screenshot
- No “GoHighLevel” or “HighLevel” text visible
- Custom HoopAI branding is shown
- URL bar (if visible) shows HoopAI domain
- Browser tab shows HoopAI name

Tools for Annotation

Use Mintlify’s <Frame> component for image framing
Add caption props for context
Use numbered callouts overlaid on screenshots
Consider Excalidraw or similar for custom diagrams

15. Full Page Inventory (All New Pages)

Summary: 63 New or Enhanced Pages

#	Path	Title	Type	Phase
1	`ai/prompt-engineering/overview.mdx`	Prompt Engineering 101	New (Pillar)	1
2	`ai/prompt-engineering/conversation-ai-prompts.mdx`	Writing prompts for Conversation AI	New	1
3	`ai/prompt-engineering/voice-ai-prompts.mdx`	Writing prompts for Voice AI	New	1
4	`ai/prompt-engineering/advanced-techniques.mdx`	Advanced prompt techniques	New	1
5	`ai/prompt-engineering/common-mistakes.mdx`	Common prompt mistakes	New	1
6	`ai/prompt-engineering/optimization.mdx`	Prompt optimization & testing	New	1
7	`ai/voice-ai/creating-agents.mdx`	Creating Voice AI agents	New	2
8	`ai/voice-ai/phone-setup.mdx`	Voice AI phone setup	New	2
9	`ai/voice-ai/inbound-outbound.mdx`	Inbound vs outbound calls	New	2
10	`ai/voice-ai/appointment-booking.mdx`	Voice AI appointment booking	New	2
11	`ai/voice-ai/call-escalation.mdx`	Call escalation & transfer	New	2
12	`ai/voice-ai/website-widget.mdx`	Voice AI website widget	New	2
13	`ai/voice-ai/testing-debugging.mdx`	Testing & debugging Voice AI	New	2
14	`ai/voice-ai/troubleshooting.mdx`	Troubleshooting Voice AI	New	2
15	`ai/conversation-ai/multi-channel.mdx`	Multi-channel deployment	New	3
16	`ai/conversation-ai/multi-bot.mdx`	Multi-bot orchestration	New	3
17	`ai/conversation-ai/troubleshooting.mdx`	Troubleshooting Conversation AI	New	3
18	`ai/workflow-ai/gpt-actions.mdx`	GPT / AI actions in workflows	New	4
19	`ai/workflow-ai/ai-decision-maker.mdx`	AI Decision Maker	New	4
20	`ai/workflow-ai/connecting-bots.mdx`	Connecting AI agents to workflows	New	4
21	`ai/workflow-ai/examples.mdx`	Workflow AI examples	New	4
22	`ai/content-ai/email-builder.mdx`	Content AI in email builder	New	4
23	`ai/content-ai/social-planner.mdx`	Content AI in social planner	New	4
24	`ai/content-ai/page-builder.mdx`	Content AI in page builder	New	4
25	`ai/content-ai/best-practices.mdx`	Content AI best practices	New	4
26	`ai/trust-safety/overview.mdx`	AI safety & responsible use	New (Pillar)	5
27	`ai/trust-safety/data-privacy.mdx`	Data privacy & AI	New	5
28	`ai/trust-safety/guardrails.mdx`	AI guardrails & content safety	New	5
29	`ai/trust-safety/compliance.mdx`	Compliance (GDPR, HIPAA, etc.)	New	5
30	`ai/trust-safety/limitations.mdx`	AI limitations & transparency	New	5
31	`ai/trust-safety/security.mdx`	Security best practices	New	5
32	`ai/overview/models.mdx`	AI models & capabilities	New	6
33	`ai/overview/features-matrix.mdx`	AI features at a glance	New	6
34	`ai/overview/pricing.mdx`	AI pricing & usage	New	6
35	`ai/overview/glossary.mdx`	AI glossary	New	6
36	`ai/prompt-library/overview.mdx`	Prompt library overview	New	7
37	`ai/prompt-library/customer-support.mdx`	Customer support prompts	New	7
38	`ai/prompt-library/sales-qualification.mdx`	Sales & lead qualification	New	7
39	`ai/prompt-library/appointment-booking.mdx`	Appointment booking prompts	New	7
40	`ai/prompt-library/real-estate.mdx`	Real estate prompts	New	7
41	`ai/prompt-library/healthcare.mdx`	Healthcare prompts	New	7
42	`ai/prompt-library/ecommerce.mdx`	E-commerce prompts	New	7
43	`ai/prompt-library/agency-saas.mdx`	Agency & SaaS prompts	New	7
44	`ai/prompt-library/voice-ai-templates.mdx`	Voice AI prompt templates	New	7
45	`ai/use-cases/overview.mdx`	Use case guides overview	New	8
46	`ai/use-cases/ai-receptionist.mdx`	AI receptionist guide	New	8
47	`ai/use-cases/lead-qualification-bot.mdx`	Lead qualification bot	New	8
48	`ai/use-cases/appointment-scheduler.mdx`	Appointment scheduling agent	New	8
49	`ai/use-cases/after-hours-support.mdx`	After-hours support bot	New	8
50	`ai/use-cases/real-estate-agent.mdx`	Real estate AI assistant	New	8
51	`ai/use-cases/ecommerce-support.mdx`	E-commerce support bot	New	8
52	`ai/use-cases/multi-location.mdx`	Multi-location business bot	New	8
53	`ai/use-cases/review-automation.mdx`	Review response automation	New	8
54	`ai/advanced/performance.mdx`	Performance optimization	New	9
55	`ai/advanced/cost-optimization.mdx`	Cost optimization	New	9
56	`ai/advanced/multi-language.mdx`	Multi-language AI setup	New	9
57	`ai/advanced/api-reference.mdx`	AI API reference	New	9
58	`ai/advanced/migration.mdx`	Migration & updates	New	9
59	docs.json	Enable llms.txt	Config change	10
60	`ai/getting-started/overview.mdx`	What is HoopAI’s AI?	New (Pillar)	10
61	`ai/getting-started/choosing-ai.mdx`	Choosing the right AI feature	New	10
62	`ai/getting-started/quick-start.mdx`	Quick start: first AI agent	New	10
63	`ai/getting-started/checklist.mdx`	AI setup checklist	New	10

Plus: Enhancement of 11 existing AI agent pages with backlinks and “Next steps” sections.

16. Implementation Timeline

Phase 1: Prompt Engineering (6 pages) — WEEK 1-2

Highest impact, zero existing content
Creates the foundation that all other AI docs link back to
Directly comparable to OpenAI’s prompt engineering guide and GHL’s Prompting 101

Phase 2: Voice AI Deep Guides (8 pages) — WEEK 2-3

Largest gap vs GHL (they have 31, we have 1)
Voice AI is complex and high-value
Users need step-by-step hand-holding

Phase 3: Conversation AI Deep Guides (3 pages) — WEEK 3-4

Good foundation exists, needs expansion
Multi-channel and multi-bot are common support questions

Phase 4: Workflow AI & Content AI (8 pages) — WEEK 4-5

Connects AI to the broader platform
Creates valuable cross-linking opportunities

Phase 5: Trust & Safety (6 pages) — WEEK 5-6

Increasingly required (EU AI Act, customer demand)
Major differentiator vs GHL (they have zero)
Builds enterprise credibility

Phase 6: AI Model Info (4 pages) — WEEK 6-7

Model transparency following OpenAI/Anthropic patterns
Features matrix becomes the central hub page

Phase 7: Prompt Library (9 pages) — WEEK 7-8

High SEO value (prompt templates are heavily searched)
Directly usable by customers (copy-paste value)

Phase 8: Use Case Guides (9 pages) — WEEK 8-10

Deep, production-grade implementation guides
Highest content effort per page
Strongest backlink magnets (original, comprehensive content)

Phase 9: Advanced & Developer (5 pages) — WEEK 10-11

Appeals to technical users and agencies
API reference connects to existing API docs section

Phase 10: SEO & Getting Started (5 pages + config) — WEEK 11-12

Pillar pages for SEO architecture
llms.txt for AI discoverability
Getting started flow ties everything together

Ongoing: Backlink Integration

After each phase, update existing pages with links to new content
Add “Related articles” sections to all existing AI pages
Update docs.json navigation after each phase

Appendix: Competitive Comparison Summary

Metric	GoHighLevel	OpenAI	Anthropic	HoopAI (Current)	HoopAI (Target)
AI docs pages	~90	~200+	~100+	~72	~135
Prompt engineering	2 articles	Full guide + model-specific	7+ sub-pages	0	6 pages
Prompt library	In-app templates	Separate tab (dozens)	Separate tab (dozens)	0	9 pages
Voice AI guides	31	Voice agents guide	Limited	1	9 pages
Model cards	0	System cards per model	System cards per model	0	1 comprehensive
Trust/Safety	0	Trust portal + guides	Trust center + RSP + cards	0	6 pages
Use case guides	Marketplace	241 cookbook recipes	4 deep-dive guides	0	9 pages
API docs for AI	2	Full reference	Full reference	0	1+ pages
llms.txt	No	No	No	No	Yes
Internal linking	Moderate	Strong	Strong	Weak	Strong

This plan was generated by analyzing 5 competitive/industry sources in parallel. All page content should be written using HoopAI’s own UI screenshots (white-labeled, no GHL branding) and follow Mintlify authoring conventions defined in the project’s CLAUDE.md and skill files.

Welcome

Core setup

Account management

​HoopAI AI Documentation — Comprehensive Implementation Plan

​Table of Contents

​1. Current State & Gap Analysis

​What We Have (Existing AI Documentation)

​Critical Gaps (What’s Missing)

​Gap Summary

​2. Proposed New Navigation Structure

​Current Navigation (in docs.json)

​Proposed Navigation (New Top-Level Tab)

​3. Phase 1: Prompt Engineering & Best Practices

​Page 1: ai/prompt-engineering/overview.mdx

​Page 2: ai/prompt-engineering/conversation-ai-prompts.mdx

​Page 3: ai/prompt-engineering/voice-ai-prompts.mdx

​Page 4: ai/prompt-engineering/advanced-techniques.mdx

​Page 5: ai/prompt-engineering/common-mistakes.mdx

​Page 6: ai/prompt-engineering/optimization.mdx

​4. Phase 2: Voice AI Deep Guides

​Page 7: ai/voice-ai/creating-agents.mdx

​Page 8: ai/voice-ai/phone-setup.mdx

​Page 9: ai/voice-ai/inbound-outbound.mdx

​Page 10: ai/voice-ai/appointment-booking.mdx

​Page 11: ai/voice-ai/call-escalation.mdx

​Page 12: ai/voice-ai/website-widget.mdx

​Page 13: ai/voice-ai/testing-debugging.mdx

​Page 14: ai/voice-ai/troubleshooting.mdx

​5. Phase 3: Conversation AI Deep Guides

​Page 15: ai/conversation-ai/multi-channel.mdx

​Page 16: ai/conversation-ai/multi-bot.mdx

​Page 17: ai/conversation-ai/troubleshooting.mdx

​6. Phase 4: Workflow AI & Content AI Guides

​Page 18: ai/workflow-ai/gpt-actions.mdx

​Page 19: ai/workflow-ai/ai-decision-maker.mdx

​Page 20: ai/workflow-ai/connecting-bots.mdx

​Page 21: ai/workflow-ai/examples.mdx

​Page 22: ai/content-ai/email-builder.mdx

​Page 23: ai/content-ai/social-planner.mdx

​Page 24: ai/content-ai/page-builder.mdx

​Page 25: ai/content-ai/best-practices.mdx

​7. Phase 5: Trust, Safety & Compliance

​Page 26: ai/trust-safety/overview.mdx

​Page 27: ai/trust-safety/data-privacy.mdx

​Page 28: ai/trust-safety/guardrails.mdx

​Page 29: ai/trust-safety/compliance.mdx

​Page 30: ai/trust-safety/limitations.mdx

​Page 31: ai/trust-safety/security.mdx

​8. Phase 6: AI Model Information & Transparency

​Page 32: ai/overview/models.mdx

​Page 33: ai/overview/features-matrix.mdx

​Page 34: ai/overview/pricing.mdx

​Page 35: ai/overview/glossary.mdx

​9. Phase 7: Prompt Library & Templates

​Page 36: ai/prompt-library/overview.mdx

​Pages 37-44: Industry-Specific Prompt Templates

​10. Phase 8: Use Case Guides (Cookbook-Style)

​Page 45: ai/use-cases/overview.mdx

​Page 46: ai/use-cases/ai-receptionist.mdx

​Page 47: ai/use-cases/lead-qualification-bot.mdx

​Page 48: ai/use-cases/appointment-scheduler.mdx

​Page 49: ai/use-cases/after-hours-support.mdx

​Page 50: ai/use-cases/real-estate-agent.mdx

​Page 51: ai/use-cases/ecommerce-support.mdx

​Page 52: ai/use-cases/multi-location.mdx

​Page 53: ai/use-cases/review-automation.mdx

​11. Phase 9: Advanced & Developer Docs

​Page 54: ai/advanced/performance.mdx

​Page 55: ai/advanced/cost-optimization.mdx

​Page 56: ai/advanced/multi-language.mdx

​Page 57: ai/advanced/api-reference.mdx

​Page 58: ai/advanced/migration.mdx

​12. Phase 10: SEO, Backlinks & LLM Discoverability

​Page 59: Enable llms.txt generation

​Page 60: ai/getting-started/overview.mdx

​Page 61: ai/getting-started/choosing-ai.mdx

​Page 62: ai/getting-started/quick-start.mdx

​Page 63: ai/getting-started/checklist.mdx

​13. Backlink Strategy (Cross-Cutting)

​Internal Linking Architecture