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

Bubble

Add your AI agent to a Bubble app with the website widget code and an HTML element

Overview

To add your AI agent to a Bubble app, copy the website widget code from QwryAI and paste it into an HTML element on your page. The chat bubble appears in the corner of that page.

What you can do

Answer visitors' questions on your Bubble site from a chat bubble, without them leaving the page.

Before you start

  • A QwryAI account with an AI agent
  • A Bubble app you can edit. You can test in Preview on Bubble's free plan; a paid plan is needed to deploy the app live.

How to add your AI agent to Bubble

1. Copy your embed code

  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 Website widget.
  4. Under Widget setup, click Copy. The code already points to your agent, so paste it exactly as copied.
The Website bubble panel in QwryAI with the widget code and its Copy button
Deploy → Website widget shows your agent's code, ready to copy.

2. Open your page in the Bubble editor

Open your app in the Bubble editor, go to the Design tab, and pick the page that should show the chat bubble.

3. Add an HTML element

Under Visual Elements, drag HTML onto the page. Its size and position don't matter: the chat bubble always sits in the bottom-right corner.

4. Paste the code and preview

  1. With the HTML element selected, open Properties → Content.
  2. Replace the placeholder in the HTML box with your QwryAI code. Leave Display as iFrame off.
  3. Click Preview to open your app with the chat bubble.
Bubble editor with an HTML element selected, the QwryAI code in its HTML box, and the chat bubble showing on the canvas
The chat bubble appears on the canvas as soon as the code is pasted.

Check it works

Open your published Bubble 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 Bubble app in Preview with the QwryAI chat window open and its greeting
The chat window open in the app's Preview.

Next steps