OmniChat WP Documentation

Everything you need to install, configure, and extend OmniChat WP. The plugin ships with sensible defaults, so you can be live in just a few minutes.

Installation

Download the latest omnichat-wp.zip build.
In the WordPress dashboard, navigate to Plugins → Add New → Upload Plugin.
Select the ZIP file and click Install Now. Once it uploads, click Activate.

CLI fans can install straight from the command line:

wp plugin install https://example.com/downloads/omnichat-wp.zip --activate

Connect to OpenRouter

Go to OmniChat → Connection in the WP Admin.
Paste your OpenRouter API key into the secure field.
Enter the default model name (e.g. openai/gpt-4.1). You can override this per agent later.
Click Save Changes.

Create your first agent

Navigate to OmniChat → Agents (coming in the next build step).
Click Add Agent and supply a name, persona prompt, and optionally a unique model.
Choose which knowledge base sources the agent can access.

Embed the widget

Use the shortcode anywhere on your site:

[omnichat agent="default"]

Or add the OmniChat block in Gutenberg. The floating launcher can be toggled under Appearance settings.

Knowledge base indexing

Index site content

Head to OmniChat → Knowledge and click Scan Site. Choose posts, pages, and custom post types to include.

Upload documents

Drop PDFs, DOCX, TXT, or CSV files into the upload area. OmniChat extracts text, chunks it, and stores semantic embeddings for fast retrieval.

Escalation workflow

When the bot lacks confidence (or strict mode blocks a response), OmniChat captures user details and emails your support address with the transcript. You can customise both agent and user email templates under Email & Support.

Need help?

Join the community forum or email support@omnichatwp.example.com. The plugin’s in-dashboard analytics will highlight unanswered questions so you can strengthen the knowledge base over time.