Skip to content
QwryAI
Documentation

Explore the documentation

Quick StartWelcome to QwryAI

Get started with QwryAI and discover how to build an AI support assistant trained on your business data.

Quick StartBuild Your First AI Agent

Create a support agent from your website, review its knowledge, and publish it to your site.

Quick StartBest Practices

Use these practices to improve answer quality, reduce failed handoffs, and keep your chatbot useful over time.

Quick StartResponse Quality

Improve how accurately and helpfully your chatbot answers customers.

AI Agent ManagementPlayground

Test and optimize your chatbot before deployment.

AI Agent ManagementData Sources

Add, train, and maintain the knowledge your agent uses to answer customer questions.

AI Agent ManagementDeploy

Add your chatbot to a website or ecommerce storefront.

AI Agent ManagementSettings

Choose the Copilot model, set a rate limit, and block spam and countries.

AI Agent ManagementEmail Settings

Configure email handoff and reply behavior for chatbot support workflows.

AI Agent ManagementLead Forms

Collect customer details directly inside the chat experience.

AI Agent ManagementIntegrations

Connect QwryAI with external platforms and business tools.

AI Agent ManagementDeveloper & Agent Access

Connect QwryAI to external AI tools, MCP clients, scripts, and CLI workflows.

AI Agent ManagementBackstage

Ask questions about your agent and workspace in a dedicated internal conversation.

AI Agent ManagementInstructions

Define your agent's behavior, guardrails, model, and response style.

AI Agent ManagementProcedures

Write a repeatable customer process with instructions, conditions, and actions.

AI Agent ManagementAction approvals

Review the exact input before an action performs a business write.

Pages

Integrations

WordPress

Add your AI agent to a WordPress site with the QwryAI plugin and your Agent ID

Overview

WordPress doesn't need embed code. Install the QwryAI plugin from the WordPress plugin directory, paste your Agent ID into its settings, and the plugin adds the chat bubble to every page of your site.

What you can do

Answer visitors' questions on your WordPress site from a chat bubble, without editing your theme.

Before you start

  • A QwryAI account with an AI agent
  • A WordPress site (6.0 or later) where you can install plugins. WordPress.com sites need a plan that allows plugins.

How to add your AI agent to WordPress

1. Install the QwryAI plugin

  1. Sign in to your WordPress admin. It's usually at yoursite.com/wp-admin.
  2. Go to Plugins → Add Plugin. Older WordPress versions call it Add New Plugin.
  3. Search for QwryAI.
  4. Click Install Now on the QwryAI plugin, then click Activate.
WordPress Add Plugins page with the QwryAI plugin found by searching for QwryAI
Search for QwryAI on the Add Plugins page, then install and activate it.

2. Copy your Agent ID

  1. In QwryAI, open the AI agent you want on your site.
  2. Click Channels in the sidebar, then click Manage on the Chat bubble card.
  3. Click Deploy and choose WordPress.
  4. Next to Agent ID, click Copy.
The Add to WordPress dialog in QwryAI with the Agent ID and its Copy button
Deploy → WordPress shows your Agent ID, ready to copy.

3. Paste it into WordPress

  1. In WordPress admin, go to Settings → QwryAI Options.
  2. Paste your Agent ID into the Agent ID field.
  3. Click Save Changes.
WordPress QwryAI Plugin Settings page with an Agent ID saved
Settings → QwryAI Options after the Agent ID is saved.

Check it works

Open your site in a new browser window, open the chat bubble, and ask a question your agent should know. The conversation appears in your QwryAI Inbox.

A WordPress site with the QwryAI chat bubble and its greeting in the bottom-right corner
The chat bubble appears on every page once the Agent ID is saved.

Troubleshooting

WordPress says the Agent ID doesn't look right

Copy it again with the Copy button in Deploy → WordPress, and paste it without extra spaces or line breaks.

The chat bubble doesn't show on the site

Check that the QwryAI plugin is active and the Agent ID is saved. If your site uses a caching plugin or a host cache, clear it, then reload the page.

Next steps