Installation Guide
Get your Blocktell chatbot installed and running on your website. Choose from multiple installation methods based on your setup.
Requirements
HTTPS Website
Your website must use HTTPS for security
Modern Browser
Supports Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
JavaScript Enabled
The widget requires JavaScript to function
Valid Chatbot ID
You need a trained chatbot from your dashboard
Installation Methods
Script Tag (Recommended)
Fastest way to get started with just a simple script tag
Installation Steps
- 1
Copy your chatbot embed code from the dashboard
- 2
Paste it before the closing </body> tag on your website
- 3
Save and refresh your page
- 4
Your chatbot is now live!
Code Example
<!-- Add this to your HTML -->
<script>
window.__blocktell = {
chatbot_id: "your-chatbot-id"
};
</script>
<script src="https://your-domain.com/widget.umd.js"></script>NPM Package
For React/Vue/Angular applications with package management
Installation Steps
- 1
Install the Blocktell package via npm
- 2
Import and configure in your application
- 3
Initialize with your chatbot configuration
- 4
Deploy your updated application
Code Example
# Install via npm
npm install @blocktell/widget
# Or via yarn
yarn add @blocktell/widget
# Import in your app
import { BlocktellWidget } from '@blocktell/widget'
// Initialize
BlocktellWidget.init({
chatbot_id: 'your-chatbot-id'
})Verify Installation
After installation, verify your chatbot is working correctly:
- Check that the widget appears in the bottom corner of your page
- Click the widget to open the chat interface
- Send a test message and verify you get a response
- Check browser console for any error messages