Use External Libraries in Botpress Projects
# 📖tutorials
If we can make all NPM packages compatible with Botpress, then we can leverage the work of 17 million developers to build even more advanced chatbots without needing to code everything from scratch. This approach can significantly speed up development time and inspire a wide range of new ideas and projects Starting with the first project, even a simple one (scraping and summarizing a webpage), which hopefully leads to lots of new projects, ideas, chatbots and tutorials using NPM packages 🛠️ I think I'm going to build all the examples in this same thread, provide the required code, and then create a separate project for each one in #1120796649686573086. This way, we can see how this evolves and how we can progress to more advanced use cases, using even better solutions than Netlify serverless functions. So, if you have ideas about which external libraries (NPM) to use or some excellent use cases, let us know! 🫡
"NPM packages, short for Node Package Manager packages, are essential tools for developers working with Node.js. These packages are repositories of code that provide additional functionality or utilities to a project without the need to write everything from scratch. NPM serves as a platform where developers can publish, share, and manage open-source projects. By using NPM packages, developers can save time, enhance reusability, benefit from community support, manage dependencies efficiently, and access a wide selection of libraries and tools for various functionalities like server-side rendering, data validation, and more. In essence, NPM packages can be considered external libraries. They are external in the sense that they are not part of the core codebase of a project but are instead external resources that developers can integrate into their applications to extend their functionality. These packages are maintained by the community and can be easily included in projects to streamline development, improve code quality, and leverage existing solutions without reinventing the wheel."
In this solution, we are using serverless functions and then directing the Axios call from the Botpress chatbot to that function. I'm using Netlify serverless functions, which are free; there are other options available for more professional use. The Netlify free version has a 10-second timeout limit, so it doesn't work with large code that takes a lot of time to execute, but it's super useful for testing and building stuff. And we don't want to use large code that takes minutes to execute in our chatbots anyway. Code to use Puppeteer and scrape webpages, inside a serverless function
Copy code
const chromium = require("@sparticuz/chromium");
const puppeteer = require('puppeteer-core');

exports.handler = async function(event, context) {
  const data = JSON.parse(event.body);
  const url = data.url;

  if (!url) {
    return {
      statusCode: 400,
      body: JSON.stringify({ error: 'No URL provided in the request body' })

  const browser = await puppeteer.launch({
    args: chromium.args,
    executablePath: await chromium.executablePath(),
    headless: chromium.headless,
    ignoreHTTPSErrors: true,

  const page = await browser.newPage();

  await page.goto(url, { waitUntil: 'domcontentloaded' });

  const headingsAndTexts = await page.evaluate(() => {
    const headings = Array.from(document.querySelectorAll('h1, h2, h3, h4, h5, h6'));
    const paragraphs = Array.from(document.querySelectorAll('p'));
    const headingsTexts = => ({ tag: h.tagName, text: h.innerText }));
    const paragraphsTexts = => ({ tag: p.tagName, text: p.innerText }));
    return [...headingsTexts, ...paragraphsTexts];

  await browser.close();

  return {
    statusCode: 200,
    body: JSON.stringify({
      status: 'Ok',
      content: headingsAndTexts
Botpress Execute Code card with Axios call (I set it up to try again after 10 seconds if something goes wrong, but after testing, it normally took 3-5 seconds to scrape the provided webpage):
Copy code
const fetchUrl = workflow.webpage

async function fetchPageContentWithRetry(url, retryDelay = 10000, maxRetries = 1) {
  let attempts = 0;

  const attemptFetchingData = async () => {
    try {
      const data = { url };
      const response = await'', data);
      workflow.scrapeData = JSON.stringify(;
      return true;
    } catch (error) {
      console.error(`Attempt ${attempts + 1}: Error fetching page content:`, error);
      if (attempts < maxRetries) {
        console.log(`Waiting for ${retryDelay / 1000} seconds before retrying...`);
        await new Promise(resolve => setTimeout(resolve, retryDelay));
        return attemptFetchingData();
      } else {
        console.log(`Failed to fetch page content after ${maxRetries} attempts.`);
        return false;

  return attemptFetchingData();

await fetchPageContentWithRetry(fetchUrl);
After asking the user to provide a webpage link and storing it in 'workflow.webpage', send that URL in an Axios call directed to your serverless function, here called ''. Wait for the response and store it in 'workflow.scrapeData', then use that as an AI Task input and ask the AI to summarize the webpage content.
⬆️ These projects requires that you know how to use serverless functions (Netlify, AWS Lambda, Appwrite etc.). Another option is to wait for these community builds, which everyone can connect to their own Botpress chatbots, using only the provided chatbot code in Execute code cards. And this Netlify that I'm using is free and allows 125k function calls per site per month. The third option is to wait for even better and more user-friendly solutions.
wow devmik. Your on the technical side huh 😁
This is so advanced, i fall to the side trying to process all of this information
That's a good idea @quick-musician-29561 🙂
🛠️ 🧎‍♂️ The second example chatbot (YouTube trending videos) might not be as useful as the first example (summarize webpage), but it was an equally fun way to test the usage of external libraries with Botpress
Both these examples use an NPM package called Puppeteer, and this is one option for using external libraries that aren't pre-installed in Botpress Cloud. Those who don't want to build their own serverless functions can use these that I and soon others are building. Download the chatbot files and all required code is there already, pointed to the correct serverless function, using the correct libraries. If you want to build your own serverless functions, all the code to get started is also provided here in these tutorials.
After this, I'm moving away from Puppeteer and starting to build other examples using different NPM packages and external libraries with Botpress. Some good reasons to use Node libraries like Puppeteer with Botpress: 1. We don't need any external libraries to build really good chatbots for many real use cases that companies and clients need. But some use cases might need more functionality, and then we can use NPM packages and leverage the work of 17 million developers to build even more advanced Botpress chatbots. 2. You have total control of the info you need to provide the users from the website. You can decide what information you need to get from websites; in the first example, I used headings (titles) and paragraphs (text) and then the chatbot summarizes those to the user. In the second example using YouTube search, I took the video title, channel name, image URL, and link to the video, then displayed those to the user. Also, you have control when the info is scraped from the webpage, for example, every time when someone uses the chatbot (so the information is not hours or days old). 3. You can let users add webpages to the Knowledge Base. You can ask users to provide a webpage, then scrape the webpage data and store the result in the KB table. Then ask the user if they want to add more webpages (maybe news, research, etc.) or if they want to start asking questions from the new info (not only summarize it but ask all questions related to that). 4. You can do many of the same things with APIs also, but many times they cost money. Web scraping and the usage of other external Node libraries are free with serverless functions (125k function calls and 100 hours of execute time a month). If your users exceeds those limits, then you'll have enough money to pay for the serverless functions PRO version (2M function calls, 1000 hours of execute time a month, $19 on Netlify).
⬆️ Chatbot file, chatbot code, and serverless function code can be found in the #share-your-bots link above. A simple chatbot (bot file + code in that link) that creates a random UUID and stores it to a 'workflow.randomUuid' variable. It generates unique identifiers for use in your chatbots and use cases. All projects follow the same scenario: We have a task in our chatbot that requires the use of an external library. The chatbot connects to that library using Axios, gets back the response, and then we display the result to the chatbot user or store it to a variable. Netlify (and other similar companies but this is my favorite) allows us to build and deploy serverless functions meaning we can really easily create API endpoints where we can hit that serverless function and perform the tasks we need. While this might not seem like a lot, what we can do with these is to create a serverless function which we can hit as an API endpoint inside of our Botpress chatbots, scenarios or really from anywhere.
Next projects we are going to try and build using external libraries in Botpress: **UUID: **Generates unique identifiers for use in your applications, ensuring each ID is distinct ✅ **date-fns: **Provides a comprehensive set of date utilities, allowing for easy manipulation, parsing, and formatting of dates. jsonwebtoken: Facilitates the creation, decoding, and verification of JSON Web Tokens (JWTs) for secure data transmission 🛠️ Enables real-time, bidirectional communication between web clients and servers. We can see that bot builders already have needs and real use cases for UUID and jsonwebtoken. With date-fns, we can build our own customized calendars (modern, functional, good-looking user interface) for example with React. Date-fns excels for its simplicity, efficiency, and modern JavaScript compatibility, ideal for developers seeking a light but powerful date library. And I know that some bot builders here have used WebSocket for building a real-time connection between Botpress and Slack. WebSocket is a low-level protocol that enables two-way communication over the web, and is a library built on top of WebSocket (and other technologies) to provide an easier and more robust solution for building real-time web applications. So maybe helps us in some pain points with those projects.
I write down everything that I have learned and include it in those chatbot links. Sometimes, I collect the important parts to this thread also to keep everything related to this in one tutorial thread💡 UUID is done, so I guess next is JSON Web Token.
Three chatbot ideas using JSON Web Token 1. Chatbot asks for login (username, password). After the user provides those, it creates a JSON Web Token and stores that in a user variable. JWT expires after 30 minutes. If the user ends the chat and comes back before 30 minutes, they don't need to provide login credentials again but have access to the chatbot using that JSON Web Token. If they come back after 30 minutes, JWT has expired, and users need to log in again with username and password, and then a new JSON Web Token is created for the next 30 minutes. You can change it to expire after 5 minutes, 1 hour etc. 2. Chatbot with two Knowledge Bases, which both require a login (username, password). When the user goes to one of those workflows using that Knowledge Base, the chatbot asks to provide the login credentials and then it creates a JSON Web Token. When the user goes to another workflow which has the second Knowledge Base, it first checks if the JSON Web Token is valid and then doesn't require logging in, but if it's not valid or has expired, it asks to log in again. It doesn't matter which KB they try to access first, without JWT they first need to log in, and with a valid JWT they can continue asking questions without login. 3. Similar to the second chatbot, but instead of accessing two Knowledge Bases with login or JWT, it tries to make an Axios call to two different servers (or whichever applications or platforms your chatbot is connected to). The first chatbot checks if there is a valid JWT, then they can continue, and if there isn't, then the users need to first log in (username, password), then a new JWT is created and they can come back or connect to the other servers/applications without login until JWT has expired. You can build advanced chatbot use cases for both authentication (by verifying user identity with login credentials) and authorization (by determining what actions an authenticated user is allowed to perform with JSON Web Tokens).
the JSON Web Token idea is great as it is indeed stateless (no user information gets stored unlike e.g. OAuth.). We are working with a technical client which specifically asks for an extra layer of security which JWT could provide. Good find 🛠️
Hi ! I've been following your tutorial to use external libraries in botpress and i'm working with it and you had a brilliant idea ! But after all this work, I'm facing a dilemma, do you think that instead of using netlify's serverless functions i could use a botpress custom integration ?
You can definitely do a custom integration. You can use whatever library you want in the integration and set up an 'Action' that shows up as a card in Botpress. There you can get whatever input you have and it calls the action in the integration where your library is installed. Interested to know what libraries you are interested in?
Nice ! I was planning to create an integration but using serverless functions in it. However, i can just use the botpress custom integration in order to execute my functions "localy". Let's give some context, my goal is to fetch the page's content from sharepoint and insert it in table rows to use it as a knowledge base. I have done some work upstream like create the http request to fetch the data I want and only these data and the program to get an access token, now i have to parse the content that i get back from the request because it include some html tags that i dont want to insert in my table. I'm planning to use node-html-parser in replacement of DOMParser to parse the response and only retrieve the text content.