beta This component version is ready to be used but is still in active development.

Chatbot Standalone container

The vf-chatbot-standalone component provides a full-screen conversational interface between a user and an AI system. It is typically accessed through a dedicated route or external site. Designed for more complex interactions, it supports extended dialogues, exploration of multiple topics, and access to documents or detailed support resources.

github location npm version

Usage

When to use this component

Only use the chatbot standalone if there's evidence it helps users:

  • Engage in longer sessions or structured tasks such as report generation, data analysis, or learning journeys
  • Focus in a distraction-free environment optimized for dialogue
  • Interact with the bot as primary interface, rather than a secondary support layer
  • Access rich responses such as cards, file previews, or dynamic visualizations

For example, the standalone chatbot works well when users need to complete complex workflows or explore content across multiple interactions. It is also effective when the conversation itself drives the experience, rather than supporting it. Test with users to ensure the dedicated interface supports their goals and provides clear value over embedded alternatives.

When not to use this component

The chatbot standalone opens in a dedicated interface and removes users from their current context. This can interrupt active tasks or create unnecessary friction for users who only need quick or simple guidance.

Avoid using the standalone chatbot for brief interactions, especially when users benefit from staying within the current page or task flow. A chatbot modal or embedded support is usually more appropriate in these cases.

Do not use the standalone chatbot when:

  • The task can be resolved with a simple search or static content
  • The chatbot does not offer a clear improvement over lighter support mechanisms
  • Accessing the chatbot disrupts processes that require deep concentration or formal
  • The chatbot lacks the intelligence or depth to sustain a meaningful experience
  • The target audience expects or benefits more from traditional, structured interfaces

Test your design without a standalone chatbot first. Well-written content, embedded guidance, or contextual help may meet user needs more effectively without introducing unnecessary complexity.

Deciding between modal vs standalone

The chatbot modal and chatbot standalone are two distinct variants for delivering conversational interfaces. Choose between them based on use case needs and task complexity.

Modal

  • For in-context support (e.g. help with current page or workflow)
  • Access point is via a floating action button on the page
  • Supports simple tasks such as getting information

Standalone

  • Suitable for exploratory or focused workflows (e.g. discovering genetic variants)
  • Launched via a link (such as "Talk to our AI chat assistant")
  • Supports more complex tasks that benefit from sustained engagement

Anatomy

Element Description
Title bar Shows the chatbot name, minimise button and close button. The title bar may include a dropdown for selecting categories.
Dialogue section Scrollable chat window showing the conversation log.
Intro message A brief onboarding message explaining the purpose and capabilities of the chatbot. Shows the icon, title and short message (Max. 2 lines of text).
Banner Used to show optional disclaimers or alerts (Max. 3 lines of text). For cases that require user consent, use a blur overlay on the background or a pre-access popup instead, as banners may be missed.
Text input area Open input field for typing and sending queries. Expands up to 5 lines, after which it becomes scrollable.

Flows

Flow Details
Suggested prompts Appear on the initial screen. Provide a quick-start to users with clickable queries. They help to provide context on the type of questions the user can ask on the platform. (Max. 60 characters)
Closing the chat dialogue Clicking on the close icon "X" triggers a confirmation prompt to prevent accidental loss of the chat log.
Error management If the chatbot is unable to provide a response to the query, display a clear error message and provide an alternative way for them to get their answers.
Links Displayed in a clear underlined style. They can be shown inline or as a list.
Source attribution Chips are shown in relevant paragraphs which cite the sources. Links to the sources and more details can be accessed via a "View sources" button.
Feedback on a query level Users can assess the AI responses with a thumbs up/thumbs down or optional close/open response fields to give more details.
Category selection A dropdown in the title bar lets users switch focus areas (e.g LLM version or data source). Single or multi-selection variants can be used depending on the use case.

Working example

You can access working example of standalone version here: Visual Framework Chatbot - Standalone

Visual branding elements and content

The Chatbot branding elements follow EMBL brand guidelines but can be updated to suit your use case. For advice on branding updates please contact the EMBL Communications Team.

Texts shown in the examples are placeholder content. Please review and update all wording to fit your your project needs and ensure it meets legal, accessibility and organisational requirements.

Visual branding elements and content

The Chatbot branding elements follow EMBL brand guidelines but can be updated to suit your use case. For advice on branding updates please contact the EMBL Communications Team.

Texts shown in the examples are placeholder content. Please review and update all wording to fit your your project needs and ensure it meets legal, accessibility and organisational requirements.

Accessibility

The component targets WCAG 2.1 AA accessibility standard.

Installation

yarn add @visual-framework/vf-chatbot-standalone @visual-framework/vf-chatbot-action-prompt @visual-framework/vf-chatbot-feedback @visual-framework/vf-chatbot-prompt @visual-framework/vf-chatbot-selector @visual-framework/vf-chatbot-sources @visual-framework/vf-chatbot-welcome

Sass/CSS

@import "@visual-framework/vf-chatbot-standalone/index.scss";

JavaScript

import { VFChatbotStandalone, initVFChatbotStandalone } from "@visual-framework/vf-chatbot-standalone";

Implementation

Basic Setup

  1. JavaScript Initialization
// Or with custom configuration
const chatbotInstances = initVFChatbotStandalone(config);

where config is the configuration object with different options as described below

Core Configuration Options

const config = {
  // Basic Settings
  title: "AI Assistant",
  welcome_message: "Welcome! I'm here to help",
  input_placeholder: "Ask me anything...",
  welcome_max_suggestions: 4,
  
  // Content & Branding
  disclaimer: 'Custom disclaimer with <a href="/privacy">privacy policy</a>',
  footnote: 'Custom footnote with <a href="/feedback">feedback link</a>',
  
  // Icons & Assets
  icons: {
    assistant_avatar: "path/to/assistant-icon.svg",
    user_avatar: "path/to/user-icon.svg",
    send_button: "path/to/send-icon.svg",
    main_logo_url: "path/to/logo.svg"
  },
  
  // API Configuration
  api: {
    chat_endpoint: "/api/chat",
    feedback_endpoint: "/api/feedback", 
    qa_data_url: "path/to/qa-data.json",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer your-token"
    },
    timeout: 10000
  },
  
  // Feature Toggles
  features: {
    enable_welcome: true,
    enable_feedback: true,
    enable_sources: true,
    enable_welcome_suggestions: true,
    enable_typing_indicator: true,
    enable_disclaimer: true,
    enable_predefined_qa: true,
    enable_fallback_responses: true,
    enable_qa_data_loading: true,
    enable_instant_feedback: false
  }
};

Service Selector Configuration

The chatbot includes an integrated selector component which can be configured to present different selection options to user:

const selectorConfig = {
  selectorContext: {
    chatbotRoutes: {
      // Multi-selection settings
      multiSelect: true,
      maxMultiSelect: 3,
      
      // Search functionality
      showSearch: true,
      showSearchThreshold: 5,
      
      // "All Services" option
      showAllServices: true,
      showAllServicesSelected: true,
      
      // Data source
      routes: "assets/vf-chatbot-selector-services.json",
      
      // UI labels
      placeholder: "Select services",
      title: "Available Services"
    }
  }
};

Selector Data Format (JSON):

{
  "routes": [
    {
      "id": "service-1",
      "title": "Service 1 title"
    },
    {
      "id": "service-2", 
      "title": "Service 2 title"
    }
  ]
}

Event Handling

Built-in Event Handlers

Chatbot comes with a provision to allow custom event handlers. These handlers can be defined in your code to handle specific actions for different events triggered during interaction with chatbot. Configure custom handlers for chatbot events:

const config = {
  handlers: {
    on_message_send: "handleMessageSend",
    on_response_receive: "handleResponseReceive", 
    on_feedback_submit: "handleFeedbackSubmit",
    on_suggestion_click: "handleSuggestionClick",
    on_error: "handleError",
    on_conversation_start: "handleConversationStart",
    on_conversation_end: "handleConversationEnd"
  }
};

// Implement handler functions
function handleMessageSend(message, conversationId) {
  console.log('User sent:', message);
  // Track analytics, log conversations, etc.
}

function handleResponseReceive(response, sources, prompts) {
  console.log('Assistant responded:', response);
  // Process response, update UI, etc.
}

function handleFeedbackSubmit(feedbackData) {
  console.log('Feedback received:', feedbackData);
  // Send to analytics, update models, etc.
}

Custom Event Listeners

Likewise you can also listen to events emitted by the chatbot for specific interactions:

// Listen for specific chatbot events
document.addEventListener('vf-chatbot:message-send', (event) => {
  const { message, conversationId } = event.detail;
  // Handle message send
});

document.addEventListener('vf-chatbot:message-receive', (event) => {
  const { message, conversationId } = event.detail;
  // Handle message send
});

document.addEventListener('vf-chatbot-feedback:submit', (event) => {
  const { messageId, feedbackType, feedbackText } = event.detail;
  // Handle feedback submission
});

document.addEventListener('vf-chatbot-welcome:suggestion-click', (event) => {
  const { question } = event.detail;
  // Handle suggestion clicks
});

document.addEventListener('vf-chatbot:assistant-change', (obj) => {
  const { selectedRoutes } = obj.selectedAssistants;
  const { conversationId } = obj.conversationId;
  // Handle service selection
});

document.addEventListener('vf-chatbot:error', (event) => {
  const { message, conversationId } = event.detail;
  // Handle message send
});

document.addEventListener('vf-chatbot:conversation-start', (event) => {
  const { message, conversationId } = event.detail;
  // Handle conversation start
});

document.addEventListener('vf-chatbot:conversation-end', (event) => {
  const { message, conversationId } = event.detail;
  // Handle conversation end
});

Feedback System Configuration

Feedback (with form)

const config = {
  features: {
    enable_feedback: true,
    enable_instant_feedback: false // Default
  }
};

Instant Feedback (one-click)

const config = {
  features: {
    enable_feedback: true,
    enable_instant_feedback: true // Thumbs up/down only
  }
};

Q&A Data Configuration

Load predefined questions and answers:

const config = {
  features: {
    enable_predefined_qa: true,
    enable_qa_data_loading: true
  },
  api: {
    qa_data_url: "path/to/qa-data.json"
  }
};

Q&A Data Format:

{
  "predefinedQA": {
    "How can I submit genomic data to EMBL-EBI?": {
      "answer": "To submit genomic data, visit the EMBL-EBI submission portal, where you’ll find step-by-step guides and tools for submitting sequencing data, assemblies, annotations, and more.",
      "sources": [
        {
          "domain": "ebi.ac.uk",
          "title": "EMBL's European Bioinformatics Institute",
          "url": "https://www.ebi.ac.uk/",
          "description": "Run BLAST searches against comprehensive sequence databases at EMBL-EBI."
        },
        {
          "domain": "ena-docs.readthedocs.io",
          "title": "ENA Documentation",
          "url": "https://ena-docs.readthedocs.io/en/latest/",
          "description": "ENA Documentation"
        }
      ]
    }
  },
  "fallbackResponses": [
    {
      "answer": "I'm sorry, I'm having trouble connecting to my knowledge base right now. Could you try again in a moment?",
      "prompts": [
        {
          "action_text": "Contact support team",
          "action_url": "tel:+44 1223 494 444"
        },
        {
          "action_text": "Submit a support request",
          "action_url": "https://www.ebi.ac.uk/about/contact/support/"
        }
      ]
    }
  ]
}

API Integration

Chat Endpoint

Your chat API should accept POST requests:

// Request format
{
  "message": "User's question",
  "conversationId": "unique-id",
  "context": {
    "selectedServices": ["service-1", "service-2"]
  }
}

// Response format
{
  "response": "Assistant's answer",
  "sources": [
    {
      "title": "Documentation Link",
      "url": "https://example.com/docs"
    }
  ],
  "prompts": [
    {
      "action_text": "Learn More",
      "action_url": "https://example.com/learn"
    }
  ]
}

Custom Welcome Screen

const config = {
  features: {
    enable_welcome: true,
    enable_welcome_suggestions: true
  },
  welcome_logo: true,
  welcome_message: "Welcome to our AI assistant!",
  welcome_suggestions_title: "Popular questions:",
  welcome_max_suggestions: 6
};

Source Citations

const config = {
  features: {
    enable_sources: true
  }
};

// Sources in API response
{
  "response": "Here's the information...",
  "sources": [
    {
      "title": "Official Documentation", 
      "url": "https://docs.example.com",
      "description": "Complete guide to the platform"
    }
  ]
}

Action Prompts

// Action prompts in API response
{
  "response": "I can help you with that...",
  "prompts": [
    {
      "action_text": "Start Tutorial",
      "action_url": "https://example.com/tutorial"
    },
    {
      "action_text": "Contact Support", 
      "action_url": "mailto:support@example.com"
    }
  ]
}

Instance Management

// Get chatbot configuration
const config = chatbotInstance.getConfiguration();

// Destroy instance
chatbotInstance.destroy();

React Integration

The HTML template can be adapted for React applications. See the React syntax section below for implementation details on using the HTML template for the chatbot in JSX components.

Variants

Select up to 3 services Clear all

AI Assistant

Welcome! I am here to help

Try asking me:

Disclaimer: This chatbot is designed to assist you with general information and basic inquiries. See our disclaimer notes.

Review AI generated content for accuracy. Leave feedback.
Nunjucks syntax

Depending on your environment you'll want to use render or include. As a rule of thumb: server-side use include, precompiled browser use render. If you're using vf-eleventy you should use include.

Using include

You'll need to pass a context object from your code or Yaml file (example), as well as the path to the Nunjucks template. Nunjucks' include is an abstraction of render and provides some additional portability.


{% set context fromYourYamlFile %}
- or -
{% set context = { 
"component-type" : "container",
"hide-from-sitemenu" : true,
"config" : [object Object],

 }
%}
{% include "../path_to/vf-chatbot-standalone/vf-chatbot-standalone.njk" %}

Using render

This approach is best for bare-bones Nunjucks environments, such as precompiled templates with the Nunjucks slim runtime where include is not be available.


{% render '@vf-chatbot-standalone', {
  "component-type" : "container",
  "hide-from-sitemenu" : true,
  "config" : [object Object],
  }
%}
React syntax 
import React, { useEffect, useRef } from "react";
import { initVFChatbotStandalone } from "@visual-framework/vf-chatbot-standalone/vf-chatbot-standalone.js";

function Chatbot() {
  const chatbotRef = useRef(null);

  // Define config outside the useEffect so it's accessible to JSX
  const vfchatbotStandaloneConfig = {
    title: "AI Assistant",
    welcome_logo: `${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot--icon-64x64-dark-green.svg`,
    welcome_message: "Hello! How can I help you today?",
    welcome_logo_alt: "AI Assistant",
    welcome_suggestions_title: "Try asking me:",
    input_placeholder: "Ask me ...",
    welcome_max_suggestions: 4,
    disclaimer: 'Disclaimer: This chatbot is designed to assist you with general information and basic inquiries. See our <a class="vf-banner__link" target="_blank" href="https://www.ebi.ac.uk/data-protection/privacy-notice/embl-ebi-public-website/">disclaimer notes</a>.',
    footnote: 'Review AI generated content for accuracy. <a class="vf-link" target="_blank" href="https://embl.service-now.com/esc?id=sc_cat_item&sys_id=5eeb8eb91b92e650b376da88b04bcbc1">Leave feedback</a>.',
    icons: {
      assistant_avatar: `${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot--icon-16x16-dark-green.svg`,
      user_avatar: `${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot--avatar-user.svg`,
      send_button: `${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot--icon-send.svg`,
      main_logo_url: `${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot--icon-32x32-dark-green.svg`,
    },
    api: {
      chat_endpoint: false,//"/api/chat",
      feedback_endpoint: "/api/feedback",
      qa_data_url: `${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot-qa.json`,
      headers: {
        "Content-Type": "application/json",
        Authorization: "Bearer your-token",
      },
      timeout: 10000,
    },
    features: {
      // enable_welcome: true,
      enable_feedback: true,
      enable_sources: true,
      // enable_welcome_suggestions: true,
      enable_typing_indicator: true,
      // enable_disclaimer: true,
      enable_predefined_qa: true,
      // enable_fallback_responses: true,
      enable_qa_data_loading: true,
      enable_instant_feedback: false
    },
    behavior: {
      auto_scroll: true,
      typing_delay: 800,
    },
    selectorContext: {
      chatbotRoutes: {
        multiSelect: true,
        maxMultiSelect: 3,
        showSearch: true,
        showSearchThreshold: 5,
        showAllServices: true,
        showAllServicesSelected: true,
        routes: "../../assets/vf-chatbot/assets/vf-chatbot-selector-services.json",
        placeholder: "Select services",
        title: "Services"
      }
    },
    handlers: {
      on_message_send: "handleMessageSend",
      on_response_receive: "handleResponseReceive",
      on_feedback_submit: "handleFeedbackSubmit", 
      on_suggestion_click: "handleSuggestionClick",
      on_error: "handleError",
      on_conversation_start: "handleConversationStart",
      on_conversation_end: "handleConversationEnd",
    }
  };

  useEffect(() => {
    if (!chatbotRef.current) return;

    // Create ALL templates programmatically to avoid React className issues
    const createAllTemplates = () => {
      // Get the chatbot standalone container
      const chatbotContainer = chatbotRef.current.querySelector(
        "[data-vf-js-chatbot-standalone]"
      );
      if (!chatbotContainer) {
        console.error("Chatbot container not found");
        return;
      }

      // Remove existing templates
      const templateIds = [
        "welcome-suggestion-template",
        "feedback-positive-template",
        "feedback-negative-template",
        "user-message-template",
        "assistant-message-template",
        "loading-indicator-template",
        "action-prompts-template",
        "single-action-prompt-template",
      ];

      templateIds.forEach((id) => {
        const existing = document.getElementById(id);
        if (existing) existing.remove();
      });

      // Create welcome suggestion template
      const welcomeTemplate = document.createElement("template");
      welcomeTemplate.id = "welcome-suggestion-template";
      welcomeTemplate.innerHTML = `
        <div class="vf-chatbot-action-prompt">
          <a href="#" class="vf-chatbot-action-prompt__link vf-u-padding--200"></a>
        </div>
      `;
      chatbotContainer.appendChild(welcomeTemplate);

      // Create feedback positive template
      const feedbackPosTemplate = document.createElement("template");
      feedbackPosTemplate.id = "feedback-positive-template";
      feedbackPosTemplate.innerHTML = `
        <div class="vf-chatbot-feedback__form vf-u-margin__top--400">
          <div class="vf-chatbot-feedback__form-content vf-u-padding--400">
            <div class="vf-chatbot-feedback__form-content-header">
              <div class="vf-chatbot-feedback__title">Tell us more (optional)</div>
              <button role="button" class="vf-chatbot-feedback__form-close vf-button vf-button--icon vf-button--dismiss | vf-banner__button" type="button" aria-label="Close feedback form" data-vf-js-feedback-form-close>
                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
                  <title>dismiss banner</title>
                  <path d="M14.3,12.179a.25.25,0,0,1,0-.354l9.263-9.262A1.5,1.5,0,0,0,21.439.442L12.177,9.7a.25.25,0,0,1-.354,0L2.561.442A1.5,1.5,0,0,0,.439,2.563L9.7,11.825a.25.25,0,0,1,0,.354L.439,21.442a1.5,1.5,0,0,0,2.122,2.121L11.823,14.3a.25.25,0,0,1,.354,0l9.262,9.263a1.5,1.5,0,0,0,2.122-2.121Z" />
                </svg>
              </button>
            </div>
            <div class="vf-chatbot-feedback__options">
              <button class="vf-chatbot-feedback__option" data-feedback-option="accurate">Accurate answer</button>
              <button class="vf-chatbot-feedback__option" data-feedback-option="easy">Easy to understand</button>
              <button class="vf-chatbot-feedback__option" data-feedback-option="formatted">Well formatted</button>
              <button class="vf-chatbot-feedback__option" data-feedback-option="helpful">Helpful</button>
            </div>
            <div class="vf-chatbot-feedback__comment-title">Comments</div>
            <textarea class="vf-chatbot-feedback__comment" rows="4" data-vf-js-feedback-comment></textarea>
            <button type="button" class="vf-chatbot-feedback__submit vf-u-padding--200" data-vf-js-feedback-submit>Submit</button>
          </div>
        </div>
      `;
      chatbotContainer.appendChild(feedbackPosTemplate);

      // Create feedback negative template
      const feedbackNegTemplate = document.createElement("template");
      feedbackNegTemplate.id = "feedback-negative-template";
      feedbackNegTemplate.innerHTML = `
        <div class="vf-chatbot-feedback__form vf-u-margin__top--400">
          <div class="vf-chatbot-feedback__form-content vf-u-padding--400">
            <div class="vf-chatbot-feedback__form-content-header">
              <div class="vf-chatbot-feedback__title">Tell us more (optional)</div>
              <button role="button" class="vf-chatbot-feedback__form-close vf-button vf-button--icon vf-button--dismiss | vf-banner__button" type="button" aria-label="Close feedback form" data-vf-js-feedback-form-close>
                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
                  <title>dismiss banner</title>
                  <path d="M14.3,12.179a.25.25,0,0,1,0-.354l9.263-9.262A1.5,1.5,0,0,0,21.439.442L12.177,9.7a.25.25,0,0,1-.354,0L2.561.442A1.5,1.5,0,0,0,.439,2.563L9.7,11.825a.25.25,0,0,1,0,.354L.439,21.442a1.5,1.5,0,0,0,2.122,2.121L11.823,14.3a.25.25,0,0,1,.354,0l9.262,9.263a1.5,1.5,0,0,0,2.122-2.121Z" />
                </svg>
              </button>
            </div>
            <div class="vf-chatbot-feedback__options">
              <button class="vf-chatbot-feedback__option" data-feedback-option="inaccurate">Inaccurate answer</button>
              <button class="vf-chatbot-feedback__option" data-feedback-option="nocontext">Did not use context</button>
              <button class="vf-chatbot-feedback__option" data-feedback-option="poorformat">Poorly formatted</button>
              <button class="vf-chatbot-feedback__option" data-feedback-option="nothelpful">Not helpful</button>
            </div>
            <div class="vf-chatbot-feedback__comment-title">Comments</div>
            <textarea class="vf-chatbot-feedback__comment" rows="4" data-vf-js-feedback-comment></textarea>
            <button type="button" class="vf-chatbot-feedback__submit vf-u-padding--200" data-vf-js-feedback-submit>Submit</button>
          </div>
        </div>
      `;
      chatbotContainer.appendChild(feedbackNegTemplate);

      // Create user message template
      const userTemplate = document.createElement("template");
      userTemplate.id = "user-message-template";
      userTemplate.innerHTML = `
        <div class="vf-chatbot-message vf-chatbot-message--user vf-u-margin__top--400">
          <div class="vf-chatbot-message__avatar vf-u-margin__bottom--200">
            <span class="vf-chatbot-message__avatar-name">You</span>
            <img src="${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot--avatar-user.svg" alt="You" />
          </div>
          <div class="vf-chatbot-message__content vf-u-padding--200">
            <div class="vf-chatbot-message__content-prompt vf-u-padding__left--200 vf-u-padding__right--200">Hello!</div>
          </div>
        </div>
      `;
      chatbotContainer.appendChild(userTemplate);

      // Create assistant message template
      const assistantTemplate = document.createElement("template");
      assistantTemplate.id = "assistant-message-template";
      assistantTemplate.innerHTML = `
        <div class="vf-chatbot-message vf-chatbot-message--assistant vf-u-margin__top--400">
          <div class="vf-chatbot-message__avatar vf-u-margin__bottom--200">
            <img src="${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot--icon-16x16-dark-green.svg" alt="AI Assistant" />
            <span class="vf-chatbot-message__avatar-name">AI Assistant</span>
          </div>
          <div class="vf-chatbot-message__content vf-u-padding--200">
            <div class="vf-chatbot-message__content-prompt vf-u-padding__left--200 vf-u-padding__right--200">How can I help you?</div>
          </div>
        </div>
        <div class="vf-chatbot-feedback vf-u-margin__top--200" data-vf-js-chatbot-feedback></div>
      `;
      chatbotContainer.appendChild(assistantTemplate);

      // Create loading indicator template
      const loadingTemplate = document.createElement("template");
      loadingTemplate.id = "loading-indicator-template";
      loadingTemplate.innerHTML = `
        <div class="vf-chatbot-message vf-chatbot-message--assistant vf-chatbot-message--loading vf-u-margin__top--400">
          <div class="vf-chatbot-message__avatar vf-u-margin__bottom--200">
            <img src="${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot--icon-16x16-dark-green.svg" alt="AI Assistant" />
            <span class="vf-chatbot-message__avatar-name">AI Assistant</span>
          </div>
          <div class="vf-chatbot-message__content vf-u-padding--200">
            <div class="vf-chatbot-message__content-loading-dots">...</div>
          </div>
        </div>
      `;
      chatbotContainer.appendChild(loadingTemplate);

      // Create action prompts template
      const actionPromptsTemplate = document.createElement("template");
      actionPromptsTemplate.id = "action-prompts-template";
      actionPromptsTemplate.innerHTML = `
        <div class="vf-chatbot-action-prompts">
          <div class="vf-chatbot-action-prompts__list" data-vf-js-action-prompts-list></div>
        </div>
      `;
      chatbotContainer.appendChild(actionPromptsTemplate);

      // Create single action prompt template
      const singleActionTemplate = document.createElement("template");
      singleActionTemplate.id = "single-action-prompt-template";
      singleActionTemplate.innerHTML = `
        <div class="vf-chatbot-action-prompt">
          <a href="#" class="vf-chatbot-action-prompt__link vf-u-padding--200"></a>
        </div>
      `;
      chatbotContainer.appendChild(singleActionTemplate);

      console.log("All templates created and added to chatbot container");
    };

    // Create all templates first
    createAllTemplates();

    // Define ALL handler functions
    let suggestionClickCount = 0;
    let messageCount = 0;

    window.handleMessageSend = function(eventData) {
      messageCount++;
      console.log(`Message sent (call #${messageCount}):`, eventData.message);
    };

    window.handleResponseReceive = function(eventData) {
      console.log('Response received:', eventData.response);
    };

    window.handleFeedbackSubmit = function(eventData) {
      console.log('Feedback submitted:', eventData);
    };

    window.handleSuggestionClick = function(eventData) {
      suggestionClickCount++;
      console.log(`Suggestion clicked (call #${suggestionClickCount}):`, eventData);
      console.log('Event data:', JSON.stringify(eventData, null, 2));
    };

    window.handleError = function(eventData) {
      console.log('Error occurred:', eventData);
    };

    window.handleConversationStart = function(eventData) {
      console.log('Conversation started:', eventData);
    };

    window.handleConversationEnd = function(eventData) {
      console.log('Conversation ended:', eventData);
    };

    // Initialize chatbot with proper cleanup check
    setTimeout(() => {
      // More thorough initialization check
      if (window.vfChatbotInitialized) {
        console.log('Global chatbot already initialized, skipping...');
        return;
      }

      const existingInstance = chatbotRef.current?.querySelector('[data-vf-chatbot-initialized]');
      if (existingInstance) {
        console.log('Component chatbot already initialized, skipping...');
        return;
      }

      if (typeof initVFChatbotStandalone === "function") {
        console.log('Starting chatbot initialization...');
        const chatbotInstances = initVFChatbotStandalone(vfchatbotStandaloneConfig);

        // Mark as initialized globally and on component
        window.vfChatbotInitialized = true;
        if (chatbotRef.current) {
          chatbotRef.current.setAttribute('data-vf-chatbot-initialized', 'true');
        }

        console.log("Chatbot initialized once:", chatbotInstances);
      }
    }, 200);

    // Complete cleanup function - remove ALL handlers
    return () => {
      console.log('Cleaning up chatbot handlers...');
      
      // Reset counters
      suggestionClickCount = 0;
      messageCount = 0;
      
      // Remove all handler functions
      delete window.handleMessageSend;
      delete window.handleResponseReceive;
      delete window.handleFeedbackSubmit;
      delete window.handleSuggestionClick;
      delete window.handleError;
      delete window.handleConversationStart;
      delete window.handleConversationEnd;

      // Remove global initialization flag
      delete window.vfChatbotInitialized;

      // Remove initialization marker
      if (chatbotRef.current) {
        chatbotRef.current.removeAttribute('data-vf-chatbot-initialized');
      }

      console.log('Cleanup completed');
    };
  }, []); // Empty dependency array - runs only once!

  // Update the return JSX to use config values:
  return (
    <>
      <div
        ref={chatbotRef}
        className="vf-content vf-chatbot-standalone-container"
        data-vf-js-chatbot-standalone-container
      >
        <div className="vf-chatbot-standalone__header">
          <div className="vf-chatbot-standalone__header-left">
            <div
              className="vf-chatbot-selector"
              data-vf-js-chatbot-selector
              data-routes-path={`${process.env.PUBLIC_URL}/assets/chatbot/vf-chatbot-selector-services.json`}
              data-multiselect="true"
              data-max-multiselect="3"
              data-show-search="true"
              data-show-all-services="true"
              data-show-all-services-selected="true"
            >
              <button
                className="vf-chatbot-selector__title"
                data-vf-js-selector-toggle
              >
                <img
                  src={vfchatbotStandaloneConfig.icons.main_logo_url}
                  alt={vfchatbotStandaloneConfig.welcome_logo_alt}
                />
                <div className="vf-chatbot-selector__title-content">
                  <span className="vf-chatbot-selector__main-text">
                    {vfchatbotStandaloneConfig.title}
                  </span>
                  <span className="vf-chatbot-selector__title-text">
                    Services
                  </span>
                </div>
                <span className="vf-chatbot-selector__chevron">
                  <svg
                    width="32"
                    height="31"
                    viewBox="0 0 32 31"
                    fill="none"
                    xmlns="http://www.w3.org/2000/svg"
                  >
                    <g clipPath="url(#clip0_3647_8230)">
                      <path
                        d="M15.999 19.0975C15.7378 19.098 15.479 19.0468 15.2377 18.9468C14.9963 18.8469 14.7771 18.7001 14.5926 18.5151L8.32863 11.9279C8.21951 11.8137 8.13399 11.6791 8.07698 11.5318C8.01998 11.3845 7.99261 11.2274 7.99645 11.0695C8.00028 10.9116 8.03525 10.756 8.09934 10.6117C8.16342 10.4673 8.25537 10.337 8.36992 10.2283C8.48446 10.1195 8.61934 10.0344 8.76683 9.97791C8.91432 9.92139 9.07152 9.89454 9.2294 9.89889C9.38729 9.90325 9.54277 9.93872 9.68692 10.0033C9.83107 10.0678 9.96106 10.1602 10.0694 10.2751L15.7094 16.2143C15.7467 16.2537 15.7916 16.2851 15.8414 16.3066C15.8912 16.3281 15.9448 16.3391 15.999 16.3391C16.0533 16.3391 16.1069 16.3281 16.1567 16.3066C16.2065 16.2851 16.2514 16.2537 16.2886 16.2143L21.9286 10.2751C22.037 10.1602 22.167 10.0678 22.3112 10.0033C22.4553 9.93872 22.6108 9.90325 22.7687 9.89889C22.9266 9.89454 23.0838 9.92139 23.2312 9.97791C23.3787 10.0344 23.5136 10.1195 23.6282 10.2283C23.7427 10.337 23.8347 10.4673 23.8987 10.6117C23.9628 10.756 23.9978 10.9116 24.0016 11.0695C24.0055 11.2274 23.9781 11.3845 23.9211 11.5318C23.8641 11.6791 23.7786 11.8137 23.6694 11.9279L17.439 18.4991C17.2503 18.6888 17.0259 18.8394 16.7788 18.9421C16.5316 19.0448 16.2667 19.0976 15.999 19.0975Z"
                        fill="#707372"
                      />
                    </g>
                    <defs>
                      <clipPath id="clip0_3647_8230">
                        <rect
                          width="16"
                          height="16"
                          fill="white"
                          transform="translate(8 6.5)"
                        />
                      </clipPath>
                    </defs>
                  </svg>
                </span>
              </button>

              <div
                className="vf-chatbot-selector__dropdown"
                data-vf-js-selector-dropdown
              >
                <div className="vf-chatbot-selector__search">
                  <label
                    className="vf-u-sr-only"
                    id="vf-chatbot-selector-search-label"
                    htmlFor="vf-chatbot-selector-search"
                  >
                    Type to search
                  </label>
                  <input
                    type="text"
                    id="vf-chatbot-selector-search"
                    aria-labelledby="vf-chatbot-selector-search-label"
                    placeholder="Select services"
                    data-vf-js-selector-search
                  />
                </div>

                <div className="vf-chatbot-selector__header">
                  <span data-max-select="3">Select up to 3 services</span>
                  <a
                    href="#"
                    className="vf-chatbot-selector__clear"
                    data-vf-js-selector-clear
                  >
                    Clear all
                  </a>
                </div>
                <ul
                  className="vf-chatbot-selector__list"
                  data-vf-js-chatbot-selector-list
                ></ul>
              </div>
            </div>
          </div>
        </div>

        <div
          className="vf-chatbot-standalone | vf-u-background-color-ui--grey--light vf-u-margin__bottom--400"
          data-vf-js-chatbot-standalone
        >
          <div
            className="vf-chatbot-standalone__content"
            data-vf-js-chatbot-standalone-content
          >
            <div
              className="vf-chatbot-welcome"
              data-vf-js-chatbot-welcome
              data-max-questions={vfchatbotStandaloneConfig.welcome_max_suggestions}
              data-enable-qa-data-loading="true"
              data-enable-predefined-qa="true"
              data-enable-fallback-responses="true"
              data-qa-data-url={vfchatbotStandaloneConfig.api.qa_data_url}
            >
              <div className="vf-chatbot-welcome__content">
                <div className="vf-chatbot-welcome__logo">
                  <img
                    src={vfchatbotStandaloneConfig.welcome_logo}
                    alt={vfchatbotStandaloneConfig.welcome_logo_alt}
                  />
                </div>
                <h1 className="vf-chatbot-welcome__title">{vfchatbotStandaloneConfig.title}</h1>
                <div className="vf-chatbot-welcome__message">
                  {vfchatbotStandaloneConfig.welcome_message}
                </div>
              </div>
              <div className="vf-chatbot-welcome__suggestions">
                <p className="vf-chatbot-welcome__suggestions-title">
                  {vfchatbotStandaloneConfig.welcome_suggestions_title}
                </p>
                <div
                  className="vf-chatbot-welcome__suggestions-grid"
                  data-vf-js-chatbot-welcome-suggestions-grid
                ></div>
              </div>
            </div>
            <div
              className="vf-chatbot-standalone__messages"
              data-vf-js-chatbot-standalone-messages
              data-auto-scroll={vfchatbotStandaloneConfig.behavior.auto_scroll}
            ></div>
            <div
              className="vf-chatbot-standalone__disclaimer"
              data-vf-js-chatbot-standalone-disclaimer
            >
              <div className="vf-banner vf-banner--alert vf-banner--info">
                <div className="vf-banner__content">
                  <p className="vf-banner__text" dangerouslySetInnerHTML={{__html: vfchatbotStandaloneConfig.disclaimer}}>
                  </p>
                  <button
                    type="button"
                    role="button"
                    aria-label="close notification banner"
                    className="vf-button vf-button--icon vf-button--dismiss | vf-banner__button"
                  >
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
                      <title>dismiss banner</title>
                      <path d="M14.3,12.179a.25.25,0,0,1,0-.354l9.263-9.262A1.5,1.5,0,0,0,21.439.442L12.177,9.7a.25.25,0,0,1-.354,0L2.561.442A1.5,1.5,0,0,0,.439,2.563L9.7,11.825a.25.25,0,0,1,0,.354L.439,21.442a1.5,1.5,0,0,0,2.122,2.121L11.823,14.3a.25.25,0,0,1,.354,0l9.262,9.263a1.5,1.5,0,0,0,2.122-2.121Z" />
                    </svg>
                  </button>
                </div>
              </div>
            </div>
          </div>
          <div className="vf-chatbot-standalone__input-container">
            <div className="vf-chatbot-standalone__input-wrapper">
              <label
                className="vf-u-sr-only"
                id="vf-chatbot-standalone-input-label"
                htmlFor="vf-chatbot-standalone-input"
              >
                {vfchatbotStandaloneConfig.input_placeholder}
              </label>
              <textarea
                id="vf-chatbot-standalone-input"
                aria-labelledby="vf-chatbot-standalone-input-label"
                className="vf-chatbot-standalone__input vf-form__textarea vf-u-padding__left--400"
                placeholder={vfchatbotStandaloneConfig.input_placeholder}
                rows="1"
                data-vf-js-chatbot-standalone-input
              ></textarea>
              <button
                className="vf-chatbot-standalone__send-button"
                aria-label="Send message"
                data-vf-js-chatbot-standalone-send
              >
                <img
                  src={vfchatbotStandaloneConfig.icons.send_button}
                  alt="Send"
                />
              </button>
            </div>

            <div
              className="vf-chatbot-standalone__footnote vf-u-margin__top--200"
              data-vf-js-chatbot-standalone-footnote
              dangerouslySetInnerHTML={{__html: vfchatbotStandaloneConfig.footnote}}
            >
            </div>
          </div>
        </div>
      </div>
    </>
  );
}

export default Chatbot;
HTML 
<!-- Standalone Chatbot -->
<div class="vf-content vf-chatbot-standalone-container" data-vf-js-chatbot-standalone-container data-vf-chatbot-config='{"title":"AI Assistant","welcome_logo":true,"welcome_message":"Welcome! I am here to help","welcome_logo_alt":"AI Assistant","welcome_suggestions_title":"Try asking me:","input_placeholder":"Ask me ...","welcome_max_suggestions":4,"disclaimer":{"val":"Disclaimer: This chatbot is designed to assist you with general information and basic inquiries. See our <a class=\"vf-banner__link\" target=\"_blank\" rel=\"noopener noreferrer\" aria-label=\"disclaimer notes (opens in new tab)\" href=\"https://www.ebi.ac.uk/data-protection/privacy-notice/embl-ebi-public-website/\">disclaimer notes</a>.","length":329},"footnote":{"val":"Review AI generated content for accuracy. <a class=\"vf-link\" target=\"_blank\" rel=\"noopener noreferrer\" aria-label=\"Leave feedback (opens in new tab)\" href=\"https://embl.service-now.com/esc?id=sc_cat_item&sys_id=5eeb8eb91b92e650b376da88b04bcbc1\">Leave feedback</a>.","length":264},"icons":{"assistant_avatar":"../../assets/vf-chatbot-standalone/assets/vf-chatbot--icon-16x16-dark-green.svg","user_avatar":"../../assets/vf-chatbot-standalone/assets/vf-chatbot--avatar-user.svg","send_button":"../../assets/vf-chatbot-standalone/assets/vf-chatbot--icon-send.svg","main_logo_url":"../../assets/vf-chatbot-standalone/assets/vf-chatbot--icon-32x32-dark-green.svg"},"api":{"chat_endpoint":false,"feedback_endpoint":false,"qa_data_url":"../../assets/vf-chatbot-standalone/assets/vf-chatbot-qa.json","headers":{"Content-Type":"application/json","Authorization":"Bearer your-token"},"timeout":10000},"features":{"enable_welcome":true,"enable_feedback":true,"enable_sources":true,"enable_welcome_suggestions":true,"enable_typing_indicator":true,"enable_disclaimer":true,"enable_predefined_qa":true,"enable_fallback_responses":true,"enable_qa_data_loading":true,"enable_instant_feedback":false},"behavior":{"auto_scroll":true,"typing_delay":800},"selectorContext":{"chatbotRoutes":{"multiSelect":true,"maxMultiSelect":3,"showSearch":true,"showSearchThreshold":5,"showAllServices":true,"showAllServicesSelected":true,"routes":"../../assets/vf-chatbot-standalone/assets/vf-chatbot-selector-services.json","placeholder":"Select services","title":"Services"}},"handlers":{"on_message_send":"handleMessageSend","on_response_receive":"handleResponseReceive","on_feedback_submit":"handleFeedbackSubmit","on_suggestion_click":"handleSuggestionClick","on_error":"handleError","on_conversation_start":"handleConversationStart","on_conversation_end":"handleConversationEnd"}}'>

  <div class="vf-chatbot-standalone__header">
    <div class="vf-chatbot-standalone__header-left">
      <div class="vf-chatbot-selector" data-vf-js-chatbot-selector data-routes-path="../../assets/vf-chatbot-standalone/assets/vf-chatbot-selector-services.json" data-multiselect="true" data-max-multiselect="3" data-show-search="true" data-show-all-services="true" data-show-all-services-selected="true">
        <button class="vf-chatbot-selector__title" data-vf-js-selector-toggle>
          <img src="../../assets/vf-chatbot/assets/vf-chatbot--icon-32x32-dark-green.svg" alt="AI Assistant">
          <div class="vf-chatbot-selector__title-content">
            <span class="vf-chatbot-selector__main-text">AI Assistant</span>
            <span class="vf-chatbot-selector__title-text">Services</span>
          </div>
          <span class="vf-chatbot-selector__chevron">
            <svg width="32" height="31" viewBox="0 0 32 31" fill="none" xmlns="http://www.w3.org/2000/svg">
              <g clip-path="url(#clip0_3647_8230)">
                <path d="M15.999 19.0975C15.7378 19.098 15.479 19.0468 15.2377 18.9468C14.9963 18.8469 14.7771 18.7001 14.5926 18.5151L8.32863 11.9279C8.21951 11.8137 8.13399 11.6791 8.07698 11.5318C8.01998 11.3845 7.99261 11.2274 7.99645 11.0695C8.00028 10.9116 8.03525 10.756 8.09934 10.6117C8.16342 10.4673 8.25537 10.337 8.36992 10.2283C8.48446 10.1195 8.61934 10.0344 8.76683 9.97791C8.91432 9.92139 9.07152 9.89454 9.2294 9.89889C9.38729 9.90325 9.54277 9.93872 9.68692 10.0033C9.83107 10.0678 9.96106 10.1602 10.0694 10.2751L15.7094 16.2143C15.7467 16.2537 15.7916 16.2851 15.8414 16.3066C15.8912 16.3281 15.9448 16.3391 15.999 16.3391C16.0533 16.3391 16.1069 16.3281 16.1567 16.3066C16.2065 16.2851 16.2514 16.2537 16.2886 16.2143L21.9286 10.2751C22.037 10.1602 22.167 10.0678 22.3112 10.0033C22.4553 9.93872 22.6108 9.90325 22.7687 9.89889C22.9266 9.89454 23.0838 9.92139 23.2312 9.97791C23.3787 10.0344 23.5136 10.1195 23.6282 10.2283C23.7427 10.337 23.8347 10.4673 23.8987 10.6117C23.9628 10.756 23.9978 10.9116 24.0016 11.0695C24.0055 11.2274 23.9781 11.3845 23.9211 11.5318C23.8641 11.6791 23.7786 11.8137 23.6694 11.9279L17.439 18.4991C17.2503 18.6888 17.0259 18.8394 16.7788 18.9421C16.5316 19.0448 16.2667 19.0976 15.999 19.0975Z" fill="#707372" />
              </g>
              <defs>
                <clipPath id="clip0_3647_8230">
                  <rect width="16" height="16" fill="white" transform="translate(8 6.5)" />
                </clipPath>
              </defs>
            </svg>
          </span>
        </button>

        <div class="vf-chatbot-selector__dropdown" data-vf-js-selector-dropdown>

          <div class="vf-chatbot-selector__search">
            <label class="vf-u-sr-only" id="vf-chatbot-selector-search-label" for="vf-chatbot-selector-search">Type to search</label>
            <input type="text" id="vf-chatbot-selector-search" aria-labelledby="vf-chatbot-selector-search-label" placeholder="Select services" data-vf-js-selector-search>
          </div>


          <div class="vf-chatbot-selector__header">
            <span data-max-select="3">Select up to 3 services</span>
            <a href="#" class="vf-chatbot-selector__clear" role="button" data-vf-js-selector-clear>Clear all</a>
          </div>
          <ul class="vf-chatbot-selector__list" data-vf-js-chatbot-selector-list>
            <!-- Routes will be populated dynamically via JavaScript -->
          </ul>
        </div>

      </div>
    </div>
  </div>

  <div class="vf-chatbot-standalone | vf-u-background-color-ui--grey--light vf-u-margin__bottom--400" data-vf-js-chatbot-standalone>
    <div class="vf-chatbot-standalone__content" data-vf-js-chatbot-standalone-content>

      <!-- Welcome Screen -->
      <div class="vf-chatbot-welcome" data-vf-js-chatbot-welcome data-max-questions="4" data-enable-qa-data-loading="true" data-enable-predefined-qa="true" data-enable-fallback-responses="true" data-qa-data-url="../../assets/vf-chatbot/assets/vf-chatbot-qa.json">
        <div class="vf-chatbot-welcome__content">
          <div class="vf-chatbot-welcome__logo">
            <img src="../../assets/vf-chatbot-standalone/assets/vf-chatbot--icon-32x32-dark-green.svg" alt="AI Assistant">
          </div>
          <h1 class="vf-chatbot-welcome__title">AI Assistant</h1>
          <div class="vf-chatbot-welcome__message">
            Welcome! I am here to help
          </div>
        </div>
        <div class="vf-chatbot-welcome__suggestions">
          <p class="vf-chatbot-welcome__suggestions-title vf-u-margin__bottom--200">Try asking me:</p>
          <div class="vf-chatbot-welcome__suggestions-grid" data-vf-js-chatbot-welcome-suggestions-grid>
            <!-- Suggestions will be populated dynamically from qa.json using the template below -->
          </div>
        </div>

        <!-- Template for welcome suggestions using vf-chatbot-action-prompt -->
        <template id="welcome-suggestion-template">
          <div class="vf-chatbot-action-prompt">
            <a href="#" class="vf-chatbot-action-prompt__link vf-u-padding--200" role="button">

            </a>
          </div>
        </template>
      </div>

      <!-- Messages Container -->
      <div class="vf-chatbot-standalone__messages" data-vf-js-chatbot-standalone-messages data-auto-scroll="true">
        <!-- Messages will be added here dynamically -->
      </div>

      <!-- Disclaimer Banner -->
      <div class="vf-chatbot-standalone__disclaimer" data-vf-js-chatbot-standalone-disclaimer>
        <div class="vf-banner vf-banner--alert vf-banner--info">
          <div class="vf-banner__content">
            <p class="vf-banner__text">Disclaimer: This chatbot is designed to assist you with general information and basic inquiries. See our <a class="vf-banner__link" target="_blank" rel="noopener noreferrer" aria-label="disclaimer notes (opens in new tab)" href="https://www.ebi.ac.uk/data-protection/privacy-notice/embl-ebi-public-website/">disclaimer notes</a>.</p>
            <button role="button" aria-label="close notification banner" class="vf-button vf-button--icon vf-button--dismiss | vf-banner__button">
              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
                <title>dismiss banner</title>
                <path d="M14.3,12.179a.25.25,0,0,1,0-.354l9.263-9.262A1.5,1.5,0,0,0,21.439.442L12.177,9.7a.25.25,0,0,1-.354,0L2.561.442A1.5,1.5,0,0,0,.439,2.563L9.7,11.825a.25.25,0,0,1,0,.354L.439,21.442a1.5,1.5,0,0,0,2.122,2.121L11.823,14.3a.25.25,0,0,1,.354,0l9.262,9.263a1.5,1.5,0,0,0,2.122-2.121Z" />
              </svg>
            </button>
          </div>
        </div>
      </div>
    </div>

    <!-- Input Container -->
    <div class="vf-chatbot-standalone__input-container">
      <div class="vf-chatbot-standalone__input-wrapper">
        <label class="vf-u-sr-only" id="vf-chatbot-standalone-input-label" for="vf-chatbot-standalone-input">Ask me</label>
        <textarea id="vf-chatbot-standalone-input" aria-labelledby="vf-chatbot-standalone-input-label" class="vf-chatbot-standalone__input vf-form__textarea vf-u-padding__left--400" placeholder="Ask me ..." rows="1" data-vf-js-chatbot-standalone-input></textarea>
        <button class="vf-chatbot-standalone__send-button" aria-label="Send message" data-vf-js-chatbot-standalone-send>
          <img src="../../assets/vf-chatbot-standalone/assets/vf-chatbot--icon-send.svg" alt="Send">
        </button>
      </div>

      <div class="vf-chatbot-standalone__footnote vf-u-margin__top--200" data-vf-js-chatbot-standalone-footnote>
        Review AI generated content for accuracy. <a class="vf-link" target="_blank" rel="noopener noreferrer" aria-label="Leave feedback (opens in new tab)" href="https://embl.service-now.com/esc?id=sc_cat_item&sys_id=5eeb8eb91b92e650b376da88b04bcbc1">Leave feedback</a>.
      </div>
    </div>

    <!-- Templates -->
    <template id="feedback-positive-template">
      <div class="vf-chatbot-feedback__form vf-u-margin__top--400">
        <div class="vf-chatbot-feedback__form-content vf-u-padding--400">
          <div class="vf-chatbot-feedback__form-content-header">
            <div class="vf-chatbot-feedback__title">Tell us more (optional)</div>
            <button role="button" class="vf-chatbot-feedback__form-close vf-button vf-button--icon vf-button--dismiss | vf-banner__button" type="button" aria-label="Close feedback form" data-vf-js-feedback-form-close>
              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
                <title>dismiss banner</title>
                <path d="M14.3,12.179a.25.25,0,0,1,0-.354l9.263-9.262A1.5,1.5,0,0,0,21.439.442L12.177,9.7a.25.25,0,0,1-.354,0L2.561.442A1.5,1.5,0,0,0,.439,2.563L9.7,11.825a.25.25,0,0,1,0,.354L.439,21.442a1.5,1.5,0,0,0,2.122,2.121L11.823,14.3a.25.25,0,0,1,.354,0l9.262,9.263a1.5,1.5,0,0,0,2.122-2.121Z" />
              </svg>
            </button>
          </div>
          <div class="vf-chatbot-feedback__options">
            <button class="vf-chatbot-feedback__option" data-feedback-option="accurate">
              Accurate answer
            </button>
            <button class="vf-chatbot-feedback__option" data-feedback-option="easy">
              Easy to understand
            </button>
            <button class="vf-chatbot-feedback__option" data-feedback-option="formatted">
              Well formatted
            </button>
            <button class="vf-chatbot-feedback__option" data-feedback-option="helpful">
              Helpful
            </button>
          </div>
          <label id="vf-chatbot-feedback-comment-title" for=id="vf-chatbot-feedback-comment" class="vf-chatbot-feedback__comment-title">Comments</label>
          <textarea id="vf-chatbot-feedback-comment" aria-labelledby="vf-chatbot-feedback-comment-title" class="vf-chatbot-feedback__comment" rows="4"></textarea>
          <button type="submit" class="vf-chatbot-feedback__submit vf-u-padding--200" data-vf-js-feedback-submit>
            Submit
          </button>
        </div>
      </div>
    </template>
    <template id="feedback-negative-template">
      <div class="vf-chatbot-feedback__form vf-u-margin__top--400">
        <div class="vf-chatbot-feedback__form-content vf-u-padding--400">
          <div class="vf-chatbot-feedback__form-content-header">
            <div class="vf-chatbot-feedback__title">Tell us more (optional)</div>
            <button role="button" class="vf-chatbot-feedback__form-close vf-button vf-button--icon vf-button--dismiss | vf-banner__button" type="button" aria-label="Close feedback form" data-vf-js-feedback-form-close>
              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
                <title>dismiss banner</title>
                <path d="M14.3,12.179a.25.25,0,0,1,0-.354l9.263-9.262A1.5,1.5,0,0,0,21.439.442L12.177,9.7a.25.25,0,0,1-.354,0L2.561.442A1.5,1.5,0,0,0,.439,2.563L9.7,11.825a.25.25,0,0,1,0,.354L.439,21.442a1.5,1.5,0,0,0,2.122,2.121L11.823,14.3a.25.25,0,0,1,.354,0l9.262,9.263a1.5,1.5,0,0,0,2.122-2.121Z" />
              </svg>
            </button>
          </div>
          <div class="vf-chatbot-feedback__options">
            <button class="vf-chatbot-feedback__option" data-feedback-option="inaccurate">
              Inaccurate answer
            </button>
            <button class="vf-chatbot-feedback__option" data-feedback-option="nocontext">
              Did not use context
            </button>
            <button class="vf-chatbot-feedback__option" data-feedback-option="poorformat">
              Poorly formatted
            </button>
            <button class="vf-chatbot-feedback__option" data-feedback-option="nothelpful">
              Not helpful
            </button>
          </div>
          <label id="vf-chatbot-feedback-comment-title" for=id="vf-chatbot-feedback-comment" class="vf-chatbot-feedback__comment-title">Comments</label>
          <textarea id="vf-chatbot-feedback-comment" aria-labelledby="vf-chatbot-feedback-comment-title" class="vf-chatbot-feedback__comment" rows="4"></textarea>
          <button type="submit" class="vf-chatbot-feedback__submit vf-u-padding--200" data-vf-js-feedback-submit>
            Submit
          </button>
        </div>
      </div>
    </template>

    <template id="user-message-template">
      <div class="vf-chatbot-message vf-chatbot-message--user  vf-u-margin__top--400">
        <div class="vf-chatbot-message__avatar vf-u-margin__bottom--200">
          <span class="vf-chatbot-message__avatar-name">You</span>
          <img src="../../assets/vf-chatbot-standalone/assets/vf-chatbot--avatar-user.svg" alt="You">
        </div>
        <div class="vf-chatbot-message__content vf-u-padding--200">
          <div class="vf-chatbot-message__content-prompt vf-u-padding__left--200  vf-u-padding__right--200">
            Hello!
          </div>
        </div>
      </div>
    </template>

    <template id="assistant-message-template">
      <div class="vf-chatbot-message vf-chatbot-message--assistant  vf-u-margin__top--400">
        <div class="vf-chatbot-message__avatar vf-u-margin__bottom--200">
          <img src="../../assets/vf-chatbot-standalone/assets/vf-chatbot--icon-16x16-dark-green.svg" alt="AI Assistant">
          <span class="vf-chatbot-message__avatar-name">AI Assistant</span>
        </div>
        <div class="vf-chatbot-message__content vf-u-padding--200">
          <div class="vf-chatbot-message__content-prompt vf-u-padding__left--200  vf-u-padding__right--200">
            How can I help you?
          </div>
        </div>
      </div>
      <div class="vf-chatbot-feedback vf-u-margin__top--200" data-vf-js-chatbot-feedback></div>
    </template>

    <template id="loading-indicator-template">
      <div class="vf-chatbot-message vf-chatbot-message--assistant vf-chatbot-message--loading  vf-u-margin__top--400">
        <div class="vf-chatbot-message__avatar vf-u-margin__bottom--200">
          <img src="../../assets/vf-chatbot-standalone/assets/vf-chatbot--icon-16x16-dark-green.svg" alt="AI Assistant">
          <span class="vf-chatbot-message__avatar-name">AI Assistant</span>
        </div>
        <div class="vf-chatbot-message__content vf-u-padding--200">
          <div class="vf-chatbot-message__content-loading-dots">
            ...
          </div>
        </div>
      </div>
    </template>

    <template id="action-prompts-template">
      <div class="vf-chatbot-action-prompts">
        <div class="vf-chatbot-action-prompts__list" data-vf-js-action-prompts-list>
          <!-- Individual prompts will be populated here -->
        </div>
      </div>
    </template>

    <template id="single-action-prompt-template">
      <div class="vf-chatbot-action-prompt">
        <a href="#" class="vf-chatbot-action-prompt__link vf-u-padding--200" role="button">

        </a>
      </div>
    </template>
  </div>
</div>

Examples

Installation info

ation

yarn add @visual-framework/vf-chatbot-standalone @visual-framework/vf-chatbot-action-prompt @visual-framework/vf-chatbot-feedback @visual-framework/vf-chatbot-prompt @visual-framework/vf-chatbot-selector @visual-framework/vf-chatbot-sources @visual-framework/vf-chatbot-welcome

Sass/CSS

@import "@visual-framework/vf-chatbot-standalone/index.scss";

JavaScript

import { VFChatbotStandalone, initVFChatbotStandalone } from "@visual-framework/vf-chatbot-standalone";

Implementation

Basic Setup

  1. JavaScript Initialization
// Or with custom configuration
const chatbotInstances = initVFChatbotStandalone(config);

where config is the configuration object with different options as described below

Core Configuration Options

const config = {
// Basic Settings
title: "AI Assistant",
welcome_message: "Welcome! I'm here to help",
input_placeholder: "Ask me anything...",
welcome_max_suggestions: 4,

// Content & Branding
disclaimer: 'Custom disclaimer with <a href="/privacy">privacy policy</a>',
footnote: 'Custom footnote with <a href="/feedback">feedback link</a>',


// Icons & Assets
icons: {
assistant_avatar: "path/to/assistant-icon.svg",
user_avatar: "path/to/user-icon.svg",
send_button: "path/to/send-icon.svg",
main_logo_url: "path/to/logo.svg"
},


// API Configuration
api: {
chat_endpoint: "/api/chat",
feedback_endpoint: "/api/feedback",
qa_data_url: "path/to/qa-data.json",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer your-token"
},
timeout: 10000
},


// Feature Toggles
features: {
enable_welcome: true,
enable_feedback: true,
enable_sources: true,
enable_welcome_suggestions: true,
enable_typing_indicator: true,
enable_disclaimer: true,
enable_predefined_qa: true,
enable_fallback_responses: true,
enable_qa_data_loading: true,
enable_instant_feedback: false
}
};

Service Selector Configuration

The chatbot includes an integrated selector component which can be configured to present different selection options to user:

const selectorConfig = {
selectorContext: {
chatbotRoutes: {
// Multi-selection settings
multiSelect: true,
maxMultiSelect: 3,

// Search functionality
showSearch: true,
showSearchThreshold: 5,


// "All Services" option
showAllServices: true,
showAllServicesSelected: true,


// Data source
routes: "assets/vf-chatbot-selector-services.json",


// UI labels
placeholder: "Select services",
title: "Available Services"
}
}
};

Selector Data Format (JSON):

{
"routes": [
{
"id": "service-1",
"title": "Service 1 title"
},
{
"id": "service-2", 
"title": "Service 2 title"
}
]
}

Event Handling

Built-in Event Handlers

Chatbot comes with a provision to allow custom event handlers. These handlers can be defined in your code to handle specific actions for different events triggered during interaction with chatbot. Configure custom handlers for chatbot events:

const config = {
handlers: {
on_message_send: "handleMessageSend",
on_response_receive: "handleResponseReceive", 
on_feedback_submit: "handleFeedbackSubmit",
on_suggestion_click: "handleSuggestionClick",
on_error: "handleError",
on_conversation_start: "handleConversationStart",
on_conversation_end: "handleConversationEnd"
}
};

// Implement handler functions
function handleMessageSend(message, conversationId) {
console.log('User sent:', message);
// Track analytics, log conversations, etc.
}


function handleResponseReceive(response, sources, prompts) {
console.log('Assistant responded:', response);
// Process response, update UI, etc.
}


function handleFeedbackSubmit(feedbackData) {
console.log('Feedback received:', feedbackData);
// Send to analytics, update models, etc.
}

Custom Event Listeners

Likewise you can also listen to events emitted by the chatbot for specific interactions:

// Listen for specific chatbot events
document.addEventListener('vf-chatbot:message-send', (event) => {
const { message, conversationId } = event.detail;
// Handle message send
});

document.addEventListener('vf-chatbot:message-receive', (event) => {
const { message, conversationId } = event.detail;
// Handle message send
});


document.addEventListener('vf-chatbot-feedback:submit', (event) => {
const { messageId, feedbackType, feedbackText } = event.detail;
// Handle feedback submission
});


document.addEventListener('vf-chatbot-welcome:suggestion-click', (event) => {
const { question } = event.detail;
// Handle suggestion clicks
});


document.addEventListener('vf-chatbot:assistant-change', (obj) => {
const { selectedRoutes } = obj.selectedAssistants;
const { conversationId } = obj.conversationId;
// Handle service selection
});


document.addEventListener('vf-chatbot:error', (event) => {
const { message, conversationId } = event.detail;
// Handle message send
});


document.addEventListener('vf-chatbot:conversation-start', (event) => {
const { message, conversationId } = event.detail;
// Handle conversation start
});


document.addEventListener('vf-chatbot:conversation-end', (event) => {
const { message, conversationId } = event.detail;
// Handle conversation end
});

Feedback System Configuration

Feedback (with form)

const config = {
features: {
enable_feedback: true,
enable_instant_feedback: false // Default
}
};

Instant Feedback (one-click)

const config = {
features: {
enable_feedback: true,
enable_instant_feedback: true // Thumbs up/down only
}
};

Q&A Data Configuration

Load predefined questions and answers:

const config = {
features: {
enable_predefined_qa: true,
enable_qa_data_loading: true
},
api: {
qa_data_url: "path/to/qa-data.json"
}
};

Q&A Data Format:

{
"predefinedQA": {
"How can I submit genomic data to EMBL-EBI?": {
"answer": "To submit genomic data, visit the EMBL-EBI submission portal, where you’ll find step-by-step guides and tools for submitting sequencing data, assemblies, annotations, and more.",
"sources": [
{
  "domain": "ebi.ac.uk",
  "title": "EMBL's European Bioinformatics Institute",
  "url": "https://www.ebi.ac.uk/",
  "description": "Run BLAST searches against comprehensive sequence databases at EMBL-EBI."
},
{
  "domain": "ena-docs.readthedocs.io",
  "title": "ENA Documentation",
  "url": "https://ena-docs.readthedocs.io/en/latest/",
  "description": "ENA Documentation"
}
]
}
},
"fallbackResponses": [
{
"answer": "I'm sorry, I'm having trouble connecting to my knowledge base right now. Could you try again in a moment?",
"prompts": [
{
  "action_text": "Contact support team",
  "action_url": "tel:+44 1223 494 444"
},
{
  "action_text": "Submit a support request",
  "action_url": "https://www.ebi.ac.uk/about/contact/support/"
}
]
}
]
}

API Integration

Chat Endpoint

Your chat API should accept POST requests:

// Request format
{
"message": "User's question",
"conversationId": "unique-id",
"context": {
"selectedServices": ["service-1", "service-2"]
}
}

// Response format
{
"response": "Assistant's answer",
"sources": [
{
"title": "Documentation Link",
"url": "https://example.com/docs"
}
],
"prompts": [
{
"action_text": "Learn More",
"action_url": "https://example.com/learn"
}
]
}

Custom Welcome Screen

const config = {
features: {
enable_welcome: true,
enable_welcome_suggestions: true
},
welcome_logo: true,
welcome_message: "Welcome to our AI assistant!",
welcome_suggestions_title: "Popular questions:",
welcome_max_suggestions: 6
};

Source Citations

const config = {
features: {
enable_sources: true
}
};

// Sources in API response
{
"response": "Here's the information...",
"sources": [
{
"title": "Official Documentation",
"url": "https://docs.example.com",
"description": "Complete guide to the platform"
}
]
}

Action Prompts

// Action prompts in API response
{
"response": "I can help you with that...",
"prompts": [
{
"action_text": "Start Tutorial",
"action_url": "https://example.com/tutorial"
},
{
"action_text": "Contact Support", 
"action_url": "mailto:support@example.com"
}
]
}

Instance Management

// Get chatbot configuration
const config = chatbotInstance.getConfiguration();

// Destroy instance
chatbotInstance.destroy();

React Integration

The HTML template can be adapted for React applications. See the React syntax section below for implementation details on using the HTML template for the chatbot in JSX components.

Changelog

Changelog

Changelog

1.0.0-beta.2

  • Updated package.json with correct settings

1.0.0-beta.1

  • Initial version
  • Auto-resizing textarea (1-5 rows with scroll)
  • Configurable Q&A data loading with fallback responses
  • Enhanced accessibility
  • Comprehensive event handling system

Assets


File system location: components/vf-chatbot-standalone

Find an issue on this page? Propose a change or discuss it.