Command Palette

Search for a command to run...

Website Widget

Deploy Botrelic chatbots directly on your websites and web applications.

Overview

Botrelic provides an embeddable website widget that allows businesses to deploy AI chatbots directly on websites and web applications.

The widget connects directly to:

  • Workspace
  • AI Agent
  • Sessions
  • Human Handoff

Businesses can either:

  • Use the AI chatbot widget directly
  • Redirect users to WhatsApp conversations
  • Or combine both experiences

Widget Embed Script

To deploy the widget, place the following script tag into the <head> or just before the closing </body> tag of your website:

<script src="https://widget.botrelic.com/loader.js" data-bot-id="agent_id"></script>

How it works:

  • Initialization: The script fetches the widget assets and renders the chat bubble.
  • Workspace connection: The data-agent-id links the widget to your secure Workspace.
  • AI Agent loading: The specific AI Agent configuration (knowledge base, prompts) is loaded automatically.
  • Once embedded, the widget automatically connects website visitors to the configured Botrelic AI Agent.

Widget Conversation Flow

Website Visitor
Botrelic Widget
Workspace Routing
Session Creation
AI Agent
Response
Human Handoff (if needed)

During this flow:

  • Sessions are automatically created when the user sends a message.
  • AI context persists during ongoing conversations.
  • Human escalation occurs seamlessly without interrupting the customer experience.

Widget Customization

Widget configuration and styling are controlled at the Workspace level, allowing you to match your brand identity without code changes.

Branding

Customize colors, fonts, launcher icon, and widget position (left/right bottom).

Messaging

Set welcome messages, prompt suggestions, and button labels.

WhatsApp Redirect Integration

Botrelic widgets can include a WhatsApp redirect option that allows website visitors to directly continue conversations in WhatsApp.

Business benefits:

  • Faster customer engagement
  • Mobile-first communication
  • Ideal for sales inquiries and Lead generation
  • Direct customer support channels

WhatsApp Redirect Flow

Website Visitor
Botrelic Widget Opens
User clicks WhatsApp CTA
WhatsApp Opens
Conversation starts

Configuration options include setting your WhatsApp business number, CTA button label, pre-filled message, and widget placement.

Example WhatsApp redirect URL payload:

https://wa.me/919999999999?text=Hello
  • Pre-filled messages: Help start the conversation seamlessly when the user lands in WhatsApp.
  • Redirection behavior: On mobile, it opens the WhatsApp app; on desktop, it opens WhatsApp Web.
  • Lead conversion: Businesses can improve conversion by moving high-intent users into a persistent WhatsApp chat.

Widget Mode vs Full WhatsApp Integration

Widget Redirect Mode
  • Redirects user to external WhatsApp app
  • No Botrelic AI automation
  • No Sessions created
  • Simple lead generation use case
Full WhatsApp Integration
  • Conversations managed inside Botrelic
  • AI Agents respond automatically
  • Sessions are tracked and created
  • Human Handoff supported
  • Workspace routing enabled

Session Handling

Every website conversation creates a Session. Sessions securely store:

  • Messages and interaction logs
  • Conversation history
  • AI context for multi-turn chats
  • Escalation status

Sessions remain securely connected to your Workspace, AI Agent, and Human Handoff workflows.

Human Handoff

When AI fallback triggers:

  • The conversation routes to human agents
  • Live support continues inside the exact same widget
  • Customer experience remains fluid and uninterrupted

Fallback triggers typically occur on unsupported questions, specific escalation keywords, or low AI confidence.

Deployment Best Practices

  • Place the widget setup script globally across your website (e.g., header/footer).
  • Optimize the welcome message to clearly state what the AI can help with.
  • Maintain an updated knowledge base for accurate AI reasoning.
  • Configure escalation rules to match your support team hours.
  • Test the flow extensively before production deployment.
  • Use the WhatsApp CTA strategically on high-intent pages for better lead conversions.

Troubleshooting

Related Documentation