Add an AI Chatbot to Your Website

New to the widget? See the chat widget overview, or add contact forms to the same site.

Install in 4 steps

<script src="https://rsflowhub.com/widget/v1/rsflowhub-widget.js"
        data-widget-token="wt_sec_YOUR_WIDGET_TOKEN"
        async></script>

<body>
  <!-- your page -->

  <script src="https://rsflowhub.com/widget/v1/rsflowhub-widget.js"
        data-widget-token="wt_sec_YOUR_WIDGET_TOKEN"
        async></script>
</body>

<?php // Appearance > Theme File Editor > footer.php, just before wp_footer() or </body>.
// Or paste the script tag into a plugin such as "WPCode" / "Insert Headers and Footers" (Footer section).
?>
<script src="https://rsflowhub.com/widget/v1/rsflowhub-widget.js"
        data-widget-token="wt_sec_YOUR_WIDGET_TOKEN"
        async></script>

{% comment %} Online Store > Themes > Edit code > layout/theme.liquid, just before </body> {% endcomment %}
<script src="https://rsflowhub.com/widget/v1/rsflowhub-widget.js"
        data-widget-token="wt_sec_YOUR_WIDGET_TOKEN"
        async></script>

// Easiest: paste the script tag into public/index.html before </body>.
// Or load it from a component:
import { useEffect } from 'react';

export default function ChatWidget() {
  useEffect(() => {
    const s = document.createElement('script');
    s.src = 'https://rsflowhub.com/widget/v1/rsflowhub-widget.js';
    s.async = true;
    s.dataset.widgetToken = 'wt_sec_YOUR_WIDGET_TOKEN';
    document.body.appendChild(s);
    return () => s.remove();
  }, []);
  return null;
}

import Script from 'next/script';

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://rsflowhub.com/widget/v1/rsflowhub-widget.js"
          data-widget-token="wt_sec_YOUR_WIDGET_TOKEN"
          strategy="afterInteractive"
        />
      </body>
    </html>
  );
}

{{-- Just before </body> in your main layout --}}
<script src="https://rsflowhub.com/widget/v1/rsflowhub-widget.js"
        data-widget-token="wt_sec_YOUR_WIDGET_TOKEN"
        async></script>

Settings you control from the dashboard

Changes appear on your site the next time a page loads. No re-install needed.

Reply to visitors live

On the Starter plan and above you can take any website chat over from the AI and answer the visitor yourself. Open the chatbot's Conversations tab in your dashboard, pick a chat and write a reply (or press Take over). The visitor sees your reply in the chat within a few seconds, under your first name.

• While a person has the chat, the AI does not answer it and no credits are used.
• Hand back to AI returns the chat to the bot. If nobody on your team writes for 2 hours, it goes back to the AI by itself, so a visitor is never left without an answer.
• When a visitor presses Talk to Human, the chat shows Wants a person under the Live filter and you get an email (it follows the support ticket email setting). The visitor can still leave a ticket if they cannot wait.
• The account owner and team members with the admin role can reply. Other roles can read chats but not reply.
• On the Free plan, Talk to Human opens the ticket form only.

Want live prices, stock or order status in the chat? See Live data from your API.

Restrict it to your domains

In Security & domains list one domain per line. example.com also covers www.example.com; use *.example.com to allow every subdomain. Requests from any other website get 403 Origin not allowed.

JavaScript API (optional)

The script exposes a small global object, RSFlowHubChatbot, so your own buttons or pages can control the chat. You can call it right away: if the chat has not been downloaded yet, calls such as open() download it first and then run. The rsflowhub:ready event fires once the chat button is on the page, and rsflowhub:chat-loaded once the full chat has loaded.

// Run after the widget has started
window.addEventListener('rsflowhub:ready', () => {
  document.querySelector('#help-button').addEventListener('click', () => {
    RSFlowHubChatbot.open();
  });
});

RSFlowHubChatbot.close();            // minimise the chat
RSFlowHubChatbot.toggle();           // open / close
RSFlowHubChatbot.toggleFullscreen(); // expand / shrink
RSFlowHubChatbot.reset();            // clear the conversation

Advanced: override a setting in the page

Attributes on the script tag win over the dashboard value, which is handy for per-page variations.

Credits, limits and privacy

• Credits: each reply is billed to the chatbot owner at the same rates as the Chatbot API. Greetings and answers found directly in your FAQ cost little or nothing. See Rate Limits & Credits.
• When credits run out (or your monthly spending limit is reached) visitors see "This assistant is temporarily unavailable". They never see billing details.
• Visitor limits: messages up to 2,000 characters, 100 messages per conversation, and about 20 messages per minute per visitor IP. Lead and ticket forms are limited to a few submissions per minute.
• Daily limit: once your daily message limit is used up, visitors see "We've reached today's chat limit" until the next day (server time). The counter and your 80% / limit-reached emails reset every day.
• Email volume: lead and ticket emails are capped at 10 per hour per chatbot to protect your inbox. Everything is still saved in the dashboard.
• Isolation: the chat renders inside a Shadow DOM, so your site's CSS (resets, Bootstrap/Tailwind, global button or div rules, even !important ones) cannot restyle or hide it, and the widget's CSS cannot affect your page.
• Speed: the file your pages load is a tiny loader (about 4 KB gzipped) that only draws the chat button. The chat itself (about 15 KB gzipped) is downloaded the first time a visitor points at, taps or opens the button, so pages where nobody chats pay almost nothing. Styles are bundled in: no extra stylesheet request.
• Accessibility: the chat is a labelled dialog that works with a keyboard and screen readers (new messages are announced, Esc closes it and returns focus to the chat button), respects "reduce motion", and automatically picks light or dark text so any brand color stays readable.
• Script updates: we improve the widget script under the same URL, and browsers refresh it about once an hour. RSFlowHubChatbot.version tells you which version a page is running.
• Browser storage: the widget keeps the conversation id (24 hours), whether the lead form was completed, whether the attention bubble was dismissed, and a cached copy of your widget settings in the visitor's localStorage. No cookies are set.

Privacy and your visitors' data

You decide what your visitors are told and how long their data is kept. You remain responsible for your own privacy policy and legal basis; these are the tools to support it.

• What is stored: the chat messages, the details a visitor types into the details form (name, email, phone/company), support tickets, and the time they ticked the consent box. IP addresses are used only for short-lived rate limiting and are not saved with conversations. In your browser's localStorage the widget keeps only the conversation id, whether the form was completed and a cached copy of your widget settings; no cookies are set.
• AI processing: messages are processed by AI providers to write replies. Use the notice under the message box to say so, for example “Replies are generated by AI. Chats are kept for 90 days.”, and link your privacy policy.
• Consent checkbox: switch on Require a consent checkbox and the details and ticket forms cannot be sent without it. The time of consent is stored with the lead or ticket.
• Retention: choose 30, 90, 180 or 365 days (or “until I delete it”). Every night older chat conversations, leads and resolved or closed tickets are deleted automatically. Open tickets are kept. Conversations you started yourself in the dashboard test chat are never deleted automatically.
• Access and erasure requests: open the chatbot's Leads tab, enter the visitor's email under Privacy requests, then Download their data (a JSON file with their leads, tickets and chats) or Erase their data (permanent). You can also delete a single lead or ticket with the trash icon. Chats are linked to a visitor only when they left their details or opened a ticket in that chat; other chats are removed by the retention setting.

Troubleshooting