dunefox-chatbot
v1.0.8
Published
Official Dunefox chatbot widget — add AI chat to any website in seconds
Downloads
299
Maintainers
Readme
dunefox-chatbot
The easiest way to add an AI chatbot to any website — HTML, React, Next.js, Vue, Laravel, WordPress, and more.
Dunefox is an AI-powered customer support platform. Deploy an intelligent chatbot on your website in under 2 minutes — no backend required. Manage all conversations, FAQs, and analytics from the Dunefox Console.
✨ Features
- 🤖 AI-powered responses — trained on your content, answers customer questions instantly
- ⚡ Zero-config embed — one
<script>tag, works on any site - 🎨 Fully customisable — position, icon, colors, and white-label branding
- 📱 Mobile-first — full-screen on mobile, floating panel on desktop
- 🔒 Privacy-safe — GDPR-friendly, no PII collected by default
- 🌐 Universal — HTML, React, Next.js, Vue, Nuxt, Laravel, WordPress, Webflow, Shopify
Installation
npm install dunefox-chatbot
# or: yarn add dunefox-chatbot | pnpm add dunefox-chatbotGet your Tenant ID from the Dunefox Console → Settings → Install Widget.
Platform Guides
HTML / Laravel / WordPress / Any Site
No npm required. Paste this snippet before </body>:
<!-- AI Chatbot by Dunefox (dunefox.io) -->
<script src="https://app.dunefox.io/api/sdk/chatbot.js"></script>
<script>
DunefoxChat.init({ tenantId: 'YOUR_TENANT_ID' });
</script>Works on WordPress, Webflow, Squarespace, Shopify, Wix, and any HTML page.
Next.js (App Router)
// app/layout.tsx
import { DunefoxChatbot } from 'dunefox-chatbot/react';
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>
{children}
{/* AI chatbot — SSR-safe, mounts only in browser */}
<DunefoxChatbot tenantId="YOUR_TENANT_ID" />
</body>
</html>
);
}React (Vite / CRA)
import { DunefoxChatbot } from 'dunefox-chatbot/react';
export default function App() {
return (
<>
<YourApp />
<DunefoxChatbot tenantId="YOUR_TENANT_ID" />
</>
);
}Vue 3 / Nuxt
<script setup>
import { onMounted, onBeforeUnmount } from 'vue';
onMounted(async () => {
const { init } = await import('dunefox-chatbot');
init({ tenantId: 'YOUR_TENANT_ID' });
});
onBeforeUnmount(async () => {
const { destroy } = await import('dunefox-chatbot');
destroy();
});
</script>WordPress / WooCommerce
Add via WPCode or your theme's functions.php:
add_action('wp_footer', function() { ?>
<script src="https://app.dunefox.io/api/sdk/chatbot.js"></script>
<script>DunefoxChat.init({ tenantId: 'YOUR_TENANT_ID' });</script>
<?php });API Reference
init(options)
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| tenantId | string | required | Your Dunefox tenant ID |
| position | 'bottom-right' \| 'bottom-left' \| 'top-right' \| 'top-left' | 'bottom-right' | Widget anchor corner |
| defaultOpen | boolean | false | Open the chat panel on page load |
| hideBranding | boolean | false | Remove "Powered by Dunefox" badge (paid plans) |
| baseUrl | string | https://app.dunefox.io | Override for staging/self-hosted |
| iconUrl | string | Dunefox default | Custom toggle button icon URL |
open() / close()
Programmatically show or hide the chat panel:
DunefoxChat.open();
DunefoxChat.close();Useful for triggering the chatbot from your own CTA button:
document.getElementById('my-help-btn').addEventListener('click', () => {
DunefoxChat.open();
});destroy()
Completely remove the widget from the page:
DunefoxChat.destroy();Branding & White Label
By default, a small "⚡ Powered by Dunefox AI" badge appears near the widget — this links back to dunefox.io and helps us grow.
To remove it on paid / white-label plans:
DunefoxChat.init({
tenantId: 'YOUR_TENANT_ID',
hideBranding: true, // available on Pro and above
});Building from Source
cd packages/chatbot-sdk
npm install
npm run build
# Outputs: dist/index.js (ESM), dist/index.cjs (CJS), dist/chatbot.umd.js (browser UMD)About Dunefox
Dunefox is a modern AI customer support platform built for businesses of all sizes. With Dunefox you can:
- 🤖 Deploy an AI chatbot for your website in under 2 minutes
- 💬 Manage all customer conversations from a unified inbox
- ❓ Build and publish FAQ knowledge bases your AI can answer from
- 📊 Track engagement and resolution rates with real-time analytics
- 🔗 Integrate via webhooks and REST APIs
- 🛒 Works with WooCommerce, Shopify, and any e-commerce platform
Get started for free at dunefox.io — no credit card required.
Support & Docs
- 📖 Documentation: docs.dunefox.com
- 💬 Community & support: dunefox.io/support
- 🐛 Issues: GitHub Issues
- 🌐 Website: dunefox.io
License
MIT © Dunefox
Built with ❤️ by the Dunefox team — AI chatbots for every website.
