QueryWing Documentation - API Reference, SDK Guide, and Developer Docs

Everything you need to build, deploy, and scale intelligent AI chatbots with QueryWing. Complete developer documentation including API reference, widget integration, webhook setup, SDK libraries, and code examples.

Getting Started with QueryWing

Set up your first AI chatbot in 5 minutes. Create your account, build your bot with a custom knowledge base, get your integration code, and deploy the widget to your website.

Why QueryWing

AI-powered conversations. Multi-language support. Advanced analytics. Enterprise security. Live chat integration. Easy customization.

Prerequisites

Modern web browser, HTTPS-enabled website for production, JavaScript enabled, QueryWing account (free to start), email verification, and API access enabled.

Quick Start - Widget Installation

Add the QueryWing JavaScript widget to your website with a simple script tag. Configuration options include data-bot-id (required), data-position (default: bottom-right), and data-theme (default: light).

API Reference

Complete REST API documentation for the QueryWing chatbot platform. Base URL: https://api.querywing.com/v1

API Authentication

All API requests require Bearer token authentication using your API key. Generate API keys in your dashboard under Settings. Rate limits: 1000 API requests per hour, 10000 webhook events per hour.

Core API Endpoints

POST /api/v1/chat - Send messages to your chatbot. GET /api/v1/conversations - Retrieve conversation history. POST /api/v1/leads - Create and manage leads. GET /api/v1/analytics - Access performance metrics. POST /api/v1/webhooks - Configure webhook endpoints. GET /api/v1/bots - Manage your chatbot instances.

Webhook Configuration

Set up webhooks to receive real-time notifications. Events include conversation.started, message.received, and conversation.ended.

SDK and Libraries

JavaScript SDK

Official JavaScript SDK for Node.js and browser environments. Install via npm install @querywing/sdk.

Python SDK

Python SDK for server-side integrations and data processing. Install via pip install querywing-sdk.

React Components

Pre-built React components for easy integration. Install via npm install @querywing/react. Includes QueryWingWidget and QueryWingProvider components.

Community Libraries

Community-maintained SDKs available for PHP, Go, Ruby, and Java.

Plans and Pricing

QueryWing offers flexible pricing tiers: Free (basic chat and analytics), Starter at $49/month (offline messages, sentiment analysis, AI lead scoring, conversation export, 2 team members), Growth at $99/month (predictive analytics, CRM integrations, visual flow builder, Zapier/Make integration, webhook events, 5 team members), Scale at $299/month (audit logs, A/B testing, white-label branding, AI agent actions, custom fine-tuning, multi-brand workspace, 10 team members), and Enterprise with custom pricing (SSO/SAML, dedicated account manager, on-premise deployment, unlimited team members).

Integrations

Zapier and Make Integration

Connect QueryWing to 5000+ apps via Zapier or Make (Integromat). Supported triggers include conversation.started, message.received, lead.created, and conversation.ended. Available actions include sending messages, updating leads, and creating notes. Available on Growth plan and above.

Webhook Events

Real-time event notifications sent to your HTTPS endpoints. Supported events: conversation.started, message.received, message.sent, lead.scored, conversation.ended, agent.action.executed. Available on Growth plan and above.

AI Features

AI Lead Scoring

Automatically scores leads 0-100 based on conversation engagement, intent signals, and behavioral patterns. Hot leads score 80+, warm leads 50-79, cold leads below 50. Available on Starter plan and above.

Visual Flow Builder

Drag-and-drop conversation flow designer with canvas-based editor. Create multi-step conversation flows with conditions, branches, API calls, and variable assignments. Available on Growth plan and above.

AI Agent Actions

Enable your AI chatbot to take real actions: make API calls, book appointments, look up order status, update CRM records, and more. Configure actions with endpoint, method, headers, and parameters. Available on Scale plan and above.

Custom AI Fine-Tuning

Train your chatbot on domain-specific data by uploading training examples (input/output pairs), importing from conversation history, or bulk importing. Available on Scale plan and above.

White-Label Branding

Remove "Powered by QueryWing" branding from the chat widget for a fully branded customer experience. Available on Scale plan and above.

Multi-Brand Workspace

Manage up to 10 brands from a single account. Each brand has its own name, logo, primary color, domain, and configuration. Available on Scale plan and above.

Advanced Features

Multi-Bot Orchestration

Manage multiple chatbots and route conversations intelligently based on context, user intent, or business rules.

Enterprise Integrations

Connect with Salesforce, HubSpot, Pipedrive CRM systems. SSO via SAML, OAuth, and LDAP. Analytics integrations with Google Analytics, Mixpanel, and Amplitude.

Code Examples

Practical examples for JavaScript widget integration, React component integration, Node.js server-side API usage, Python SDK implementation, PHP backend integration, and Vue.js component setup.

Troubleshooting

Common issues and solutions including widget not loading, API errors (401 Unauthorized, 429 Rate Limited, 500 Server Error), and performance optimization tips.