Skip to main content

Ask AI chatbot widget for React

Add an AI chatbot or AI search widget to your React application using Biel.ai's React components.

The biel-react package includes three components: BielButton for a floating chatbot, BielSearchButton for AI-powered search, and BielBot for embedding the chatbot directly in your page layout.

Prerequisites​

  • A Biel.ai account. If you don't have one, sign up for free.
  • A project created in your Biel.ai dashboard. Follow the Quickstart guide to create one.
  • A React application ready to install Biel.ai.
  • Node.js installed.

Add the chatbot widget​

Chatbot widget for docs

  1. Install Biel.ai:

    npm install biel-react
    info

    If you're using yarn as your package manager, run yarn add biel-react instead of the npm command above.

  2. In the main component where you wish to place the chatbot (often src/App.js), embed the Biel.ai button:

    import React, { useEffect } from 'react';

    import { BielButton } from 'biel-react';
    import { defineCustomElements } from 'biel-search/loader';
    import 'biel-search/dist/biel-search/biel-search.css';

    function App() {

        useEffect(() => {
            if (typeof window !== 'undefined') {
            defineCustomElements(window);
            }
        }, []);

        return (
            <div className="App">
                {/* Other components and content */}
                <BielButton project="<YOUR_PROJECT_ID>"
                    header-title="Biel.ai chatbot"
                    button-position="bottom-right"
                    modal-position="bottom-right"
                    button-style="dark">Ask AI
                </BielButton>
            </div>
        );
    }

    export default App;

    Replace <YOUR_PROJECT_ID> with your project's ID from the Biel.ai dashboard.

  3. Start your React app by running npm start or yarn start in your terminal. Once it compiles successfully, verify that the chatbot appears and functions correctly on your site.

Add the search widget​

Biel search

  1. Install Biel.ai:

    npm install biel-react
    info

    If you're using yarn as your package manager, run yarn add biel-react instead of the npm command above.

  2. In the component where you want to place the search widget, embed the Biel.ai search button:

    import React, { useEffect } from 'react';

    import { BielSearchButton } from 'biel-react';
    import { defineCustomElements } from 'biel-search/loader';
    import 'biel-search/dist/biel-search/biel-search.css';

    function App() {

        useEffect(() => {
            if (typeof window !== 'undefined') {
            defineCustomElements(window);
            }
        }, []);

        return (
            <div className="App">
                {/* Other components and content */}
                <BielSearchButton project="<YOUR_PROJECT_ID>"
                    header-title="Biel.ai chatbot"
                    button-style="rounded">Search
                </BielSearchButton>
            </div>
        );
    }

    export default App;

    Replace <YOUR_PROJECT_ID> with your project's ID from the Biel.ai dashboard.

  3. Start your React app by running npm start or yarn start in your terminal. Once it compiles successfully, verify that the search widget appears and functions correctly on your site.

Add embedded chat​

Use BielBot to render the chatbot inline in your page layout instead of as a floating button. This is useful for building dedicated help pages or embedding the chatbot within a specific section of your site. See Embedded mode for more details.

  1. Install Biel.ai:

    npm install biel-react
    info

    If you're using yarn as your package manager, run yarn add biel-react instead of the npm command above.

  2. In the component where you want the chatbot to appear inline, embed BielBot with embedded-mode set to true:

    import React, { useEffect } from 'react';

    import { BielBot } from 'biel-react';
    import { defineCustomElements } from 'biel-search/loader';
    import 'biel-search/dist/biel-search/biel-search.css';

    function HelpPage() {

        useEffect(() => {
            if (typeof window !== 'undefined') {
            defineCustomElements(window);
            }
        }, []);

        return (
            <div className="HelpPage">
                <BielBot project="<YOUR_PROJECT_ID>" embedded-mode="true"></BielBot>
            </div>
        );
    }

    export default HelpPage;

    Replace <YOUR_PROJECT_ID> with your project's ID from the Biel.ai dashboard.

  3. Start your React app by running npm start or yarn start in your terminal. Once it compiles successfully, verify that the chatbot appears inline on the page.

Next steps​