You can manually embed your Webchat as a component or an HTML <div>.

If you just want to quickly add a bot to your website, use the Quick Start guide.

You will need:

​
As a component

You can embed Webchat directly in your website as a component:

1

Get your embed code

Navigate to either the Studio or the Dashboard.

  1. Select Share in the upper-right corner.
  2. Select Configure, then copy the src URL in the second script tag:
2

Copy the script URL

Open the URL in your browser and copy the content of the page. It should look something like this:

https://files.bpcontent.cloud/2025/03/18/14/20250318141028-30WRMG85.js
window.botpress.init({
    "botId": "xxxxxxxxxxxxxxxxxxxxxx",
    "configuration": {
        "website": {},
        "email": {},
        "phone": {},
        "termsOfService": {},
        "privacyPolicy": {},
        "variant": "soft",
        "themeMode": "light",
        "fontFamily": "inter"
    },
    "clientId": "xxxxxxxxxxxxxxxxxxxxxx"
});
3

Add the Webchat component

Insert the following HTML where you want Webchat to appear, then paste the script:

<div class="webchat" style="height: 600px; width: 400px;">
  <iframe
    style="height: 100%; width: 100%; border: none;"
    srcdoc='
    <!doctype html>
    <html lang="en">
      <head></head>
      <body>
        <script src="https://cdn.botpress.cloud/webchat/v2.2/inject.js"></script>
        <script defer>
          window.botpress.on("webchat:ready", () => {
            botpress.open();
          });
          // Paste your Webchat config snippet here
        </script>
      </body>
    </html>'
  ></iframe>
</div>

Now you can customize the styles of the parent <div> to suit your layout.

To make Webchat fill your website’s entire screen, update the wrapper’s height and width properties:

<div class="webchat" style="height: 100vh; width: 100vw;">

​
In an HTML div

You can embed Webchat directly in an HTML <div>:

1

Get your embed code

Navigate to either the Studio or the Dashboard.

  1. Select Share in the upper-right corner.
  2. Select Configure, then copy the src URL in the second script tag:
2

Copy the script URL

Open the URL in your browser and copy the content of the page. It should look something like this:

https://files.bpcontent.cloud/2025/03/18/14/20250318141028-30WRMG85.js
window.botpress.init({
    "botId": "xxxxxxxxxxxxxxxxxxxxxx",
    "configuration": {
        "website": {},
        "email": {},
        "phone": {},
        "termsOfService": {},
        "privacyPolicy": {},
        "variant": "soft",
        "themeMode": "light",
        "fontFamily": "inter"
    },
    "clientId": "xxxxxxxxxxxxxxxxxxxxxx"
});
3

Add Webchat to an HTML div

Now you can embed Webchat directly in an HTML <div>. For example:

<div id="webchat-container" style="position: relative; width: 100%; height: 100%;">
  <script src="https://cdn.botpress.cloud/webchat/v2.2/inject.js"></script>
  <script>
    window.botpress.on("webchat:ready", () => {
      window.botpress.open();
    });

    // Paste your Webchat config snippet here
  </script>
  <style>
    #webchat-container {
      position: relative;
      width: 100%;
      height: 100%;
    }
    .bpFab {
      display: none;
    }
    .bpWebchat {
      position: absolute !important;
      top: 0 !important;
      left: 0 !important;
      right: 0 !important;
      bottom: 0 !important;
      width: 100% !important;
      height: 100% !important;
    }
  </style>
</div>

You can also use this script in a CMS like Wix.