The Salespeak LLM Optimization plugin enhances your site by detecting AI visitors—such as ChatGPT, GPTBot, BingPreview, and PerplexityBot—and serving them optimized responses directly from a Salespeak-managed origin.
Regular human visitors continue to see your site exactly as usual, with no changes or interruptions.
This guide walks you through integrating the Salespeak AI Proxy with your existing Nginx setup, enabling optimized crawling and understanding by AI assistants (LLMs). The integration is lightweight, fast to install, and fail-safe—if anything goes wrong, your site continues to function normally for all human traffic.
What the Salespeak AI Proxy Does
The Salespeak AI Proxy automatically detects AI visitors such as:
ChatGPT
Claude
Gemini
Perplexity
Other LLM-based crawlers
When detected, it serves them Salespeak-optimized content, improving how your site appears and is understood in AI-generated answers — without affecting regular users.
What’s Included
The Salespeak AI Proxy package contains:
Lua modules (4 files)
Setup guide with copy-paste Nginx configuration snippets
Install helper script for fast setup
Requirements
Before you begin, make sure you have:
-
OpenResty (Nginx with Lua support)
⚠️ Standard Nginx does not support Lua and will not work
-
Your Salespeak Organization ID
xd98cd51-a282-42ea-a48b-11797ce79779
Path Exclusions
By default, all paths under:
/app/*
are excluded from AI processing.
This ensures internal dashboards or app routes are never modified.
Quick Setup (≈ 5 Minutes)
1. Install Dependencies
From the package directory, run:
./install.sh 9d98cd51-a282-42ea-a48b-11797ce79779
This installs all required Lua dependencies and configures the proxy.
2. Update Your Nginx Configuration
Open your nginx.conf and add the provided code snippets from:
README.md
These snippets enable the Salespeak AI Proxy and hook it into the request lifecycle.
3. Reload Nginx
Apply the changes:
nginx -s reload
(or restart your OpenResty service if needed)
Verifying the Integration
You can test the setup by simulating an AI crawler request:
curl -I -H "User-Agent: ChatGPT-User/1.0" https://your-site.com/
If the integration is working, the request will be routed through the Salespeak AI Proxy and served optimized content.
Using Standard Nginx?
If you’re currently running standard Nginx, you have two options:
Option 1: Switch to OpenResty (Recommended)
OpenResty is a drop-in replacement for Nginx.
Your existing Nginx configuration will work unchanged
Lua support is enabled out of the box
Option 2: Use the Salespeak Docker Sidecar
If migrating Nginx isn’t an option, you can run the Salespeak AI Proxy as a Docker sidecar alongside your existing setup.
👉 Reach out to Salespeak support and we’ll help you set this up.
Fail-Safe by Design
The Salespeak AI Proxy is built to be safe and non-disruptive:
If the proxy fails, traffic automatically falls back
Human visitors are never affected
Your site continues to function normally at all times
Need Help?
If you have questions, need help with OpenResty, or want to explore the Docker sidecar option, contact Salespeak support — we’re happy to help.