Dashboard

AI Agent Management

Deploy

Add your chatbot to a website or ecommerce storefront.

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available QwryAI pages before exploring further.

Before You Deploy

Deployment makes the chatbot available to customers, so complete the quality checks first. The chatbot should answer core questions, escalate correctly, and match the website where it will appear.

  • Data sources are processed.
  • Playground tests pass for common questions.
  • Appearance matches your brand.
  • Lead forms and escalation settings are configured.
  • Billing and usage limits are ready for expected traffic.
QwryAI deployment readiness view
The deploy page is the final step after data, testing, and appearance setup.
  • Review setup before copying the embed code.
  • Use a private test page if you want to verify before public launch.

Deployment Method

  1. Open the selected chatbot.
  2. Go to Deploy.
  3. Copy the embed code.
  4. Paste the code into your website, theme, CMS, or tag manager.
  5. Publish your site changes.
  6. Open the live website and send a test message.
<script>
  window.qwryaiSettings = {
    chatbotId: "YOUR_CHATBOT_ID",
    workspaceId: "YOUR_WORKSPACE_ID"
  };
</script>
<script src="https://cdn.qwry.ai/widget.js" async></script>
QwryAI website widget example
After publishing, verify that the launcher opens and the chatbot responds.
  • Test from the same domain customers use.
  • Confirm the conversation appears in QwryAI.

Troubleshooting

ProblemWhat to check
Widget does not appearConfirm the embed code is complete, published, and not blocked by the site theme or CSP.
Wrong chatbot appearsConfirm the embed key belongs to the selected chatbot and workspace.
Widget appears but does not answerCheck chatbot active state, plan status, credits, and message limits.
Conversation missing in QwryAIConfirm the live domain uses the latest published script and the correct environment.
  • Confirm the embed code was copied completely.
  • Confirm the website change was published.
  • Check that the chatbot is active.
  • Make sure the embed key belongs to the correct chatbot.
  • Check browser console errors if the widget does not load.
Deployment areaLaunch check
Chat widgetDisplay name, initial message, suggested messages, placeholder, feedback, copy button, notices, footer, and embed method are configured.
Website embedThe script is published on the live customer-facing page, not only in a preview editor.
Connected channelsEmail, Slack, Zapier, WhatsApp, Messenger, Instagram, Telegram, and Shopify routes are tested separately when enabled.
AttachmentsImages, PDFs, file count, file size, PDF page count, and unsupported formats are handled before launch.