00

Help, When You Need It.

Most questions about S2W AI Navigator, Gateway, and Concierge have answers already written down — in the admin guides, the FAQ below, or the quick troubleshooting checks on this page. If you still need a human, our Jira support portal is one click away.

Every setting. Every feature. Every answer.

The full admin guides are the most complete reference. Each is a single PDF covering installation, configuration, every setting, maintenance, and troubleshooting — written for WordPress administrators running the plugin on a live site. If you’re about to search for an answer, start here.

Guide · 14 pages

S2W AI Navigator

v2.3.0

Installation, API key setup, content indexing, page role overrides, Pinecone, widget appearance, navigation behavior, multilingual mode, analytics, and maintenance.


Open PDF →

Guide · 15 pages

S2W AI Gateway

v1.8.0

Four-tier security model, HMAC authentication, the module registry, EDD / Jira / LatePoint / Hybrid / MCP Proxy providers, diagnostics, credential encryption, and third-party provider registration.


Open PDF →

Guide · 18 pages

S2W AI Concierge

v2.5.0

The three readiness gates, personas and templates, confirmations audit log, escalation settings, agentic tools, AI Gateway + CRM integration, the AI Advisor, WP-CLI commands, and privacy.


Open PDF →

The questions everyone asks first.

These are the fastest answers. If your question isn’t here, skim the troubleshooting section below or jump straight to the admin guide for the plugin you’re configuring.

Do I need a paid account with OpenAI to use these plugins?
+

Yes. S2W AI Navigator — and by extension AI Concierge, which uses Navigator’s key — requires a valid OpenAI API key. You create this on your own OpenAI account at platform.openai.com. The key starts with sk-.

Typical monthly cost for a small site (20–50 pages, moderate traffic) is $1–$3. OpenAI bills your account directly — speak2web sees none of this cost.

The chat widget is not appearing on my site. What’s wrong?
+

This is almost always one of three things:

  • No OpenAI API key saved. Go to S2W AI Navigator → Settings → General and paste your key. A red admin notice banner appears on every admin page until a valid key is saved.
  • AI Navigator hasn’t indexed any pages yet. Click Index All Pages Now on the Navigator settings page. The widget needs at least one indexed page to have something to answer from.
  • (AI Concierge only) One of the three readiness gates is red. Open S2W AI Concierge → Personas — the banner at the top shows which gate needs attention.

See the troubleshooting section below for more symptoms and fixes.

How do I re-index my content after I’ve updated pages?
+

You usually don’t need to. After the first manual index, every time a post or page is saved, AI Navigator automatically re-indexes just that page in the background. The index always stays current.

Run a full manual re-index via Index All Pages Now when: you’ve upgraded the plugin, changed the embedding model, done a bulk content migration, or enabled semantic chunking for the first time.

Do I need all three plugins, or can I use just one?
+

You can use any one on its own, but they build on each other:

  • AI Navigator is the foundation — it reads and indexes your site content and powers the chat widget. It works standalone.
  • AI Concierge sits on top of Navigator and adds personas, escalations, and template workflows. It requires Navigator.
  • AI Gateway is optional infrastructure for giving personas real tool access — booking appointments in LatePoint, creating Jira tickets, looking up EDD licenses. Install it when you want your AI to resolve, not just answer.

If all three are installed, they must run on the same S2W_INFRA_VERSION (currently 1_2). Update them together.

Where is the Page Role setting? I can’t find it.
+

It’s not in the plugin settings page — it’s in the post editor sidebar. Open any page or post for editing, then look in the right-hand sidebar for a box labelled “S2W AI Navigator — Page Role.”

If you don’t see it, click the three-dot menu (⋮) at the top right of the editor and check Preferences → Panels to make sure it’s enabled.

Setting the correct role on your 5–10 most important pages (Contact, Pricing, Product, FAQ, About) is the single highest-leverage configuration action you can take — it directly improves navigation accuracy.

What’s the difference between the free tier and Pro?
+

AI Navigator Free: up to 50 indexed pages, text-embedding-3-small + gpt-4o-mini models, browser TTS, MySQL vector search. Pro: unlimited pages, larger embedding model, gpt-4o chat, OpenAI TTS voices, Pinecone + semantic chunking, analytics dashboard.

AI Concierge Free: Dispatcher + 1 active specialist persona. Pro: unlimited personas, analytics, voice, webhooks, agentic tools, CRM integration, AI Advisor Pro features, revision history.

AI Gateway: no paid tier — free forever.

Is my visitor data safe? What about GDPR?
+

Yes. A seven-pattern PII scrubber runs automatically before any conversation data is written to the database — credit card numbers, SSNs, bank accounts, passport numbers, phone numbers, emails, and IP addresses are redacted.

AI Concierge exposes a Privacy page for right-to-erasure by email, plus a wp s2w-aic erase <email> WP-CLI command. Conversation retention defaults to 90 days and is configurable. Credentials for Gateway providers (EDD, Jira, MCP Proxy) are stored AES-256-CBC encrypted.

Full detail is in the admin guides — Concierge §10 (Privacy), Gateway §16 (Credentials & Encryption).

Can I use a language other than English?
+

Yes. Multilingual mode is enabled by default in AI Navigator and operates at the server level, not via browser translation. The visitor’s browser language is auto-detected, a language picker appears in the widget header, and all queries are processed and answered in the selected language. WPML and Polylang are detected automatically through their hreflang tags.

Voice input uses OpenAI Whisper, which supports 50+ languages.

I moved my site to a new domain. My license stopped working.
+

Pro licenses are domain-tied. Moving to a new domain requires a license transfer — open a ticket in our support portal and include both the old and new domain names. Transfers are normally processed within one business day.

Quick fixes for common symptoms.

Try these first. The full troubleshooting tables — with every symptom and every known cause — live in the last section of each admin guide.

Symptom · Navigator

Widget doesn’t appear on the site at all

No OpenAI API key saved. Go to S2W AI Navigator → Settings → General, paste a valid key, click Save Settings. Without a key, no widget renders — anywhere.

Symptom · Navigator

Widget appears but doesn’t respond

API key is invalid or rate-limited. Check the green validation badge next to the key in Settings. If red, re-check the key at platform.openai.com and confirm your billing is active.

Symptom · Navigator

Widget navigates to the wrong page

Page role mismatch. Open the incorrectly matched page in the WordPress editor and set the correct role in the S2W AI Navigator — Page Role sidebar box. Check “Mark as canonical destination” on your primary Contact / Pricing / Product pages.

Symptom · Navigator

Long pages return low-confidence answers

Semantic chunking isn’t active for those pages. Open the Index Viewer — any page with chunk_count=1 and word_count>300 needs to be re-indexed. Click the per-row Re-Index button, or run Index All Pages Now. Requires Pro + Pinecone.

Symptom · Concierge

Readiness banner is red

All three gates must be green. Gate 1: AI Navigator active + v2.0.1+. Gate 2: Navigator has indexed at least one page (click Index All Pages Now). Gate 3: at least one active non-Dispatcher persona (edit and save the Sales Guide).

Symptom · Concierge

Persona answers things it shouldn’t

Topics Out is too vague or incomplete. Edit the persona, add specific topic names to Topics Out, and tighten the Always / Never Rules. Use AI Advisor → Troubleshoot to get a targeted diagnosis.

Symptom · Gateway

/auth returns 401 with valid credentials

Password must be a WordPress Application Password — not the user’s login password. Generate one at Users → Your Profile → Application Passwords.

Symptom · Gateway

Provider’s tools missing from the manifest

The provider’s is_configured() returned false. Check: (1) the required plugin (EDD, Jira, LatePoint) is active, (2) credentials are saved, (3) Test Connection succeeds on the Providers page.

Symptom · All three plugins

“Cannot redeclare class S2W_Updater_1_x” fatal

Mixed infra versions. All three S2W plugins must be on the same S2W_INFRA_VERSION. Update AI Navigator + AI Gateway + AI Concierge to the same release and clear PHP opcache.

Symptom · All three plugins

Strange behavior right after an update

Clear your browser cache, then clear any server-side cache (SiteGround SuperCacher, W3 Total Cache, WP Rocket, etc.). Run a full re-index in Navigator. If Concierge shows template updates, click Sync on the Templates page.

Full troubleshooting tables — with every known symptom, cause, and fix — live in Section 17 of the Navigator guide, Section 19 of the Gateway guide, and Section 19 of the Concierge guide. Worth bookmarking.

Still stuck? Talk to a human.

Our support team runs on Jira Service Management. Open a ticket and we’ll get back to you with a real answer — not a bot, not a canned response. When you submit, include:

  • ✓Which plugin and version (e.g., AI Navigator v2.1.42)
  • ✓Your WordPress and PHP versions
  • ✓A clear description of what you expected vs. what happened
  • ✓Any error messages or screenshots
  • ✓Your site URL (helps us reproduce the issue faster)

Speak2Web Helpdesk

Jira Service Management

Open a ticket, track its status, and get updates by email. The portal has pre-built request types for installation help, bug reports, license transfers, and feature requests.


Open a Support Ticket →

RESPONSE · USUALLY WITHIN 1 BUSINESS DAY

One more place to look: the Quick Install Guides.

If you’re still setting things up for the first time, the short-form Quick Install Guides walk you through the fastest path from plugin zip to working widget.

Scroll to Top