Documentation

Choosing between OpenAI and Google Gemini, picking a model, and keeping the bill predictable.

• Choosing between OpenAI and Google Gemini
• Getting an API key and saving it
• Picking a model
• What Sohay costs to run
• Daily token caps and rate limits

The inbox where every chat is saved, searched, assigned, and answered.

• The Conversations inbox
• Searching, filtering and sorting conversations
• Assigning, pinning and closing conversations
• Deleting a conversation, and what happens next
• What human handoff is
• Turning human handoff on

Hooks, filters, the REST surface, and the tools registry.

• Hooks and filters — where to start
• Customising Sohay with code
• The tools registry
• Adding your own chat tool
• The REST API surface
• Capabilities and the implies graph

Install Sohay, connect an AI provider, and get your first answers working.

• What Sohay is and how it answers questions
• Requirements and compatibility
• Install and activate Sohay
• First-run setup — provider, key, model and spend cap
• Publish your first article and sync it

Letting a person take over a chat from the assistant.

• What human handoff is
• Turning human handoff on
• Knowing when somebody is waiting
• Before you switch handoff on

Writing the articles your chatbot answers from, and keeping them indexed.

• How the Knowledge Base answers questions
• Writing a good Knowledge Base article
• Organising articles with categories and tags
• Syncing articles to the AI index
• Article length and how content is processed
• The Knowledge Base search cache

The public Knowledge Base: where it lives, what its URLs are, and how to restyle it.

• Where visitors read your Knowledge Base
• Changing the Knowledge Base URL
• Restyling the Knowledge Base pages
• Overriding a Knowledge Base template

What Sohay sends, what it stores, how long it keeps it, and who on your team can see it.

• What Sohay sends to OpenAI and Google
• Where your API keys are stored
• Exporting and erasing visitor data
• How long conversations are kept
• What happens when you uninstall Sohay
• Giving your team access without making them admins

Diagnosing a Sohay install that is not behaving.

• The chatbot isn’t using my articles
• When a Knowledge Base sync fails
• Answers cut off behind a CDN or proxy
• Reading the Diagnostics screen and the log
• Does Sohay slow down my site?
• Sohay on WordPress Multisite

The chat widget itself — where it appears, what it says first, and how it looks.

• Turning the chat widget on and off
• Hiding the widget on specific pages
• Customising the welcome message and system prompt
• Branding the widget
• Why other plugins can’t see inside the chat

What the chatbot can do on a store: catalog, stock, prices, policies, and the cart.

• What the chatbot can do on a WooCommerce store
• The shopping tools, one by one
• Carts, guests and page caching
• Currency, taxes and locale
• Turning individual shopping tools off
• Running Sohay without WooCommerce