Descrição
Pinpointed AI Sommelier is a conversational wine & spirits expert for your WooCommerce store.
Instead of forcing customers to click through filters and hundreds of bottles, it asks natural questions like:
- “What are you cooking?”
- “What’s your budget per bottle?”
- “Is this a gift? Who is it for?”
Then it recommends wines and spirits from your live WooCommerce inventory and links directly to the product pages so customers can check out in a click.
The result: more confident buyers, higher average order values, and fewer “I don’t know what to choose” drop-offs.
Key features
-
💬 Floating AI chat widget
Modern, mobile-friendly chat bubble that appears on your store and product pages. -
🧠 Conversational sommelier
Helps with food pairing, budget guidance, gift ideas and style preferences (light, fruity, full-bodied, etc.). -
🛒 Inventory-aware recommendations
Only suggests products that exist in your live catalog, with direct links to product pages. -
💸 Free plan to try it
Built-in “Get Free Plan License” button in the settings. No manual account creation required. -
📊 Real-time analytics (Pro/Enterprise)
Track conversation volume, top recommended products, conversion rates, and revenue attribution. -
🎨 Widget customization (Pro/Enterprise)
Custom launcher icons, greeting messages, chat positioning, and brand colors to match your store. -
📈 Flexible pricing plans
Free, Starter ($39/mo), Pro ($99/mo), and Enterprise ($299/mo) with unlimited conversations. -
🌍 Multi-currency & theme-friendly
Reads your WooCommerce currency and works with any theme. Designed to avoid clashing with your site CSS. -
🔒 Privacy-conscious by design
Sends chat text, domain and basic store metadata – not customer names, emails or payment details.
New in Version 2.0
Tabbed Admin Interface
– Clean, organized settings with dedicated tabs
– Settings, Plan & Billing, Customization, and Analytics all in one place
Real Analytics Dashboard (Pro/Enterprise)
– Actual conversation counts (not demo data)
– Top recommended products by click-through
– Conversion tracking and revenue attribution
– Peak engagement hours
– CSV export for Enterprise users
Advanced Customization (Pro/Enterprise)
– Upload custom launcher icons (your logo instead of default corkscrew)
– Customize greeting message (200 characters)
– Choose widget position (bottom-left/right, top positions for Enterprise)
– Brand color for chat header and messages
– Enterprise: Custom widget title and hide branding option
Enterprise Plan
– Truly unlimited conversations (fair use: 5,000 messages/month for typical stores)
– Store knowledge indexing (answers questions about your policies, delivery, etc.)
– White-label options
– Dedicated support
– Custom integrations
Improved Plan Display
– Correctly shows “Unlimited” for Enterprise (no false limits)
– Clear usage meters for Free/Starter/Pro
– One-click Stripe checkout for upgrades
How it works (high level)
- The plugin adds a small floating chat launcher to your storefront.
- When a shopper asks a question, the plugin securely calls the Pinpointed gateway (Cloudflare Worker).
- The gateway talks to your AI workflow (e.g. an n8n backend) plus your WooCommerce catalog.
- The customer sees a friendly, natural reply with clickable product links.
You keep control of your products and pricing while offloading the “What should I buy?” conversations to the AI sommelier.
External Services
This plugin relies on an external service to function:
Pinpointed AI Service (Gateway)
– Service URL: Cloudflare Worker endpoint (e.g. pinpointed-gateway.ian-d13.workers.dev) as configured in the plugin settings.
– Purpose: handles licensing, token authentication, AI conversation routing and plan usage tracking.
– Data sent: chat messages, session ID, store domain, basic WooCommerce currency metadata and product search terms.
– Data NOT sent by default: customer names, emails, payment details or WordPress login details.
Airtable (Analytics – Pro/Enterprise only)
– Purpose: stores conversation analytics, product click data, and conversion tracking.
– Data sent: session IDs, product names, prices, timestamps, conversation counts.
– Data NOT sent: customer personal information, payment details.
– Access: Only accessible by your Pinpointed tenant ID.
The chat widget JavaScript is also loaded from the configured gateway URL in order to render the floating chat interface.
By activating the plugin, requesting a license, or upgrading your plan, you agree that the plugin may communicate with these external services to operate the AI sommelier functionality. You can deactivate or delete the plugin at any time to stop all external calls.
For legal details, see the Pinpointed AI Sommelier Terms & Conditions on the Pinpointed site.
Privacy Policy
What data we collect:
– Chat messages and questions (to provide AI recommendations)
– Session IDs (random identifiers for conversation continuity)
– Store domain and currency settings
– Product search terms and recommendation clicks (Pro/Enterprise analytics)
What we DON’T collect:
– Customer names, email addresses, or contact information
– Payment details or financial information
– WordPress user accounts or passwords
– Personal browsing history
Data storage:
– Conversation data: Processed in real-time, not permanently stored unless analytics enabled
– Analytics data (Pro/Enterprise): Stored in Airtable with tenant isolation
– Custom icons: Stored in your WordPress uploads directory
Your rights:
– You can disable the plugin at any time
– Enterprise users can request data export via CSV
– Contact support@pinpointed.dev for data deletion requests
GDPR Compliance:
– No personal data collection without consent
– Session IDs are anonymous and cannot identify individuals
– Data processing agreements available for Enterprise customers
Instalação
- Upload the plugin files to
/wp-content/plugins/pinpointed-ai-sommelieror install via Plugins Add New. - Activate the plugin through the Plugins screen.
- Make sure WooCommerce is installed and active.
- Go to Pinpointed AI in your WordPress admin (top-level menu).
- Click “Get Free Plan License” to create a free license for your store, then click “Save & Authenticate”.
After that, the AI chat widget will appear on your storefront (if “Load on all pages” is enabled).
Shortcode or global load
You have two options:
- Global load – enable “Load on all pages” in the settings so the chat appears everywhere.
-
Shortcode – use:
[ai_sommelier]
on any page or post where you want to force-load the widget, even if global load is turned off.
Perguntas frequentes
-
Do I need a Pinpointed account?
-
No separate account signup is required for the Free plan.
When you click “Get Free Plan License” the plugin calls the Pinpointed gateway, creates a free license for your store domain and fills the license field for you. You then click “Save & Authenticate” to activate it.
-
What are the plan limits?
-
- Free: 10 conversations per month
- Starter: 100 conversations per month
- Pro: 2,500 conversations per month
- Enterprise: Unlimited (fair use: up to 5,000 AI messages/month for typical stores)
-
How does the custom icon feature work?
-
Pro and Enterprise users can upload a custom launcher icon (recommended 128x128px PNG or SVG) to replace the default corkscrew icon. The launcher button has a clean white background, and your icon displays on top. This allows for perfect brand integration.
-
What analytics are available?
-
Pro & Enterprise users get:
– Daily and monthly conversation counts
– Top recommended products with click counts
– Click-through and conversion rates
– Peak engagement hours
– Average order value comparisonEnterprise users additionally get:
– Revenue attribution
– CSV data export
– Custom reportsAnalytics are based on real data from Airtable, not mock/demo data.
-
Can I customize the widget appearance?
-
Pro & Enterprise users can customize:
– Custom launcher icon (upload your logo)
– Greeting message (200 characters max)
– Widget position (bottom-left, bottom-right)
– Header and message accent colorEnterprise users additionally get:
– Top positions (top-left, top-right)
– Custom widget title
– Hide “Powered by Pinpointed” branding -
Is there a shortcode?
-
Yes. Use:
[ai_sommelier]on any page or post where you want the widget to appear.
If “Load on all pages” is enabled in the settings, you don’t need the shortcode. -
Which WooCommerce versions are supported?
-
The plugin requires WooCommerce and has been tested with recent versions up to the version listed above in “Tested up to”. It should work with most standard WooCommerce setups and themes.
-
Which languages does it support?
-
The assistant can respond in multiple languages depending on your backend configuration.
The WordPress plugin itself is translation-ready and has been tested with English, French, German and Dutch. -
How does billing work for paid plans?
-
- You start on the Free plan (10 conversations/month).
- From the Plan & Billing tab, click upgrade buttons for Starter, Pro, or Enterprise.
- This opens a secure Stripe checkout session where you complete the subscription.
- Usage limits and plan status are tracked by the Pinpointed gateway.
- All billing is handled securely through Stripe.
-
What happens if I hit my plan limit?
-
If you reach the monthly conversation limit for your plan, the gateway will return a clear error (e.g. free_quota_exceeded) and the chat will show a friendly message asking you to upgrade or increase your plan.
Free and Starter users will see upgrade prompts. Pro users can upgrade to Enterprise for unlimited conversations.
-
Does it store personal data?
-
By default, the plugin and gateway receive:
- The customer’s question / chat text
- A session ID (random identifier)
- Your store domain and basic WooCommerce currency metadata
- Product search terms used to find recommendations
It does not send customer names, emails, payment details, or WordPress user data unless you explicitly customize your backend workflow to do so.
Analytics data (conversation counts, product clicks) is stored in Airtable for Pro and Enterprise users.
Avaliações
Colaboradores e desenvolvedores
“Pinpointed AI Sommelier” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
ColaboradoresTraduzir o “Pinpointed AI Sommelier” para seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
2.0.5
- UI: Show animated “typing” dots on the Send button while waiting for a reply.
- UI: Use a custom chat launcher icon and add a fallback icon to prevent a blank/white launcher.
2.0.0
Major Release – Complete Redesign
-
NEW: Tabbed Admin Interface
- Organized settings across 4 tabs: Settings, Plan & Billing, Customization, Analytics
- Modern card-based design
- Improved user experience
-
NEW: Real Analytics Dashboard (Pro/Enterprise)
- Track actual conversation volume (daily/monthly)
- Top recommended products with click counts
- Conversion rate tracking
- Peak engagement hours
- Revenue attribution (Enterprise)
- CSV export capability (Enterprise)
- Powered by Airtable integration
-
NEW: Custom Launcher Icons (Pro/Enterprise)
- Upload your own icon (PNG/SVG, 128x128px recommended)
- Clean white background launcher
- Default corkscrew icon for all plans
- Remove/revert to default option
-
NEW: Advanced Customization (Pro/Enterprise)
- Custom greeting messages (200 characters)
- Widget positioning (bottom-left/right, top positions for Enterprise)
- Brand color for header and user messages
- Custom widget title (Enterprise)
- Hide branding option (Enterprise)
-
IMPROVED: Enterprise Plan Display
- Correctly shows “Unlimited” conversations
- No false limit warnings
- Fair use policy clearly displayed
-
IMPROVED: Plan Management
- Clear usage meters with visual indicators
- Warning messages at 75% and 90% usage
- One-click Stripe checkout for all paid plans
- Better plan comparison display
-
FIX: Launcher Icon Visibility
- Icon always visible on white background
- Brand color no longer covers launcher icon
- Custom icons display at optimal size
-
FIX: Usage Limit Handling
- Proper null checking for enterprise unlimited plan
- Accurate percentage calculations
- Better error messages
-
TECHNICAL: File Management
- Proper file upload handling for custom icons
- Automatic cleanup when removing/replacing icons
- Security validations (PNG/JPG/SVG only)
1.0.2
- Fixed JWT token display and tenant ID binding in admin screen.
- Improved Stripe checkout / onboarding flow for Starter and Pro plans.
1.0.1
- Fix: improved free-license onboarding (
/onboard/free) reliability and error handling. - Fix: Stripe /billing/checkout integration for Starter / Pro upgrades.
- Improvement: better admin connection status and JWT handling.
- Minor copy and documentation updates in the settings and readme.
1.0.0
- Added Stripe upgrade buttons (Starter / Pro) inside the admin settings.
- Introduced terms & conditions link and clearer plan descriptions.
- Improved admin UX; moved settings to a top-level “Pinpointed AI” menu.
- Minor styling and accessibility tweaks to the chat widget.
- Added privacy policy declaration for GDPR compliance.
- Added deactivation hook to clean up scheduled events.
- Enhanced security with improved nonce verification and input validation.
- Code quality improvements: better caching and internationalization.
0.1.2
- New floating chat layout with improved mobile handling.
- Signed WooCommerce search endpoint for secure product lookups.
- Internal licensing and tenant binding improvements.
0.1.1
- Initial public beta of the AI Sommelier widget for WooCommerce.
