⚡ HTML / Drop-in CDN
Zero build tools required. Add two lines of code to your HTML template before the closing body tag.
View HTML snippet →⚛️ React & Next.js
Clean hook-based mounting with next/script and useEffect lifecycle safety for SPA/SSR applications.
🛒 Shopify & WooCommerce
Collect cart abandoned orders, answer product inquiries, and initiate instant checkout with seamless mobile optimization.
View Shopify snippet →🐍 Python & Node.js
Serve Botly Pro directly from FastAPI, Flask, Django, or Express with optional secure backend webhook lead forwarding.
View Python snippet →Public JavaScript SDK Reference (window.BotlyChatbot)
Control the chatbot programmatically from any button, page event, marketing workflow, or CRM link.
| Method | Category | Description | Example Usage |
|---|---|---|---|
BotlyChatbot.init(options) |
Core | Initializes and renders the chatbot widget with custom config schema. | BotlyChatbot.init({ goal: 'lead_generation' }) |
BotlyChatbot.open() |
Core | Expands the chat window and scrolls conversation into focus. | BotlyChatbot.open() |
BotlyChatbot.close() |
Core | Collapses the chat window back into the floating launcher icon. | BotlyChatbot.close() |
BotlyChatbot.toggle() |
Core | Toggles the open/closed state of the chat window. | BotlyChatbot.toggle() |
BotlyChatbot.setCompanyGoal(goal) |
Goal | Dynamically reconfigures the company goal, lead prompts, and triage logic. | BotlyChatbot.setCompanyGoal('payment_checkout') |
BotlyChatbot.simulateUnlistedInquiry(q) |
Leads | Injects an unlisted question to trigger proactive lead capture triage. | BotlyChatbot.simulateUnlistedInquiry('Custom enterprise pricing') |
BotlyChatbot.startCheckout(quote) |
Payment | Opens chat and launches interactive in-chat payment checkout card. | BotlyChatbot.startCheckout({ quoteRef: 'Q-100', totalAmount: 79 }) |
BotlyChatbot.getCapturedLeads() |
Leads | Returns array of all captured leads with names, phones, queries, and goals. | const leads = BotlyChatbot.getCapturedLeads() |
BotlyChatbot.exportLeadsCSV() |
Leads | Downloads formatted CSV file of all captured customer inquiries. | BotlyChatbot.exportLeadsCSV() |
BotlyChatbot.reset() |
Core | Clears chat history and re-renders fresh welcome state. | BotlyChatbot.reset() |