Hey, still trying to work out whether this is possible, getting conflicting information from the docs bot, and would like a definitive answer before we move on to try other things. Basically, we are looking to begin a conversation via the Chat API from our backend, and pass context information into that chat. We can do this with the following calls which are working: /users/get-or-create (create or fetch user with userId) /conversations (begin convo, get conversationId) */events * (send custom event containing context data) We now have a userId and a conversationId so feel it should now be possible to later on start up this same conversation when the bot user clicks a link in their email. In our website, we've successfully embedded the webchat UI, currently doing this using the React Webchat component. [In the docs for this](https://www.botpress.com/docs/webchat/react-library/components/webchat), it shows that we can add conversationId and UserCredentials as props to this component, with the UserCredentials being made up of userId and userToken. However, I can't find any docs that discuss how to use these. My assumption would be that userToken would be a jwt created using the userId and some secret (like we do for the Chat API), however I can't find anywhere to set this secret in the Webchat configuration. Can I please have some help with this? If this isn't possible, what are some alternatives to achieve this "pre-baking" of conversation information that is completely ready for use when the user initiates a bot conversation? https://cdn.discordapp.com/attachments/1440637878710308885/1440637879112958036/image.png?ex=691ee214&is=691d9094&hm=0ac4521c2bd70f69e97229f6278c4a6f9cabfa8344b878123be161589779a1a6&

Hi all, Fairly new to Botpress here and I seem to be running into a roadblock as I'm trying to display a bot within a page on my Webflow site. I've been following the instructions [here](https://www.botpress.com/docs/webchat/integrations/webflow) and [here](https://www.botpress.com/docs/webchat/get-started/embed-in-element), but for some reasons the bot won't show. I've tried several different elements as you can see in the below screenshots. Right now I have - a Webflow div with

pollux-container

id - a custom code block with

pollux-embed

id - a div inside the custom code block with

pollux-div

id I tried setting each of these elements as the target of the "Where to show chat" field in my bot's webchat settings but nothing works. The custom code is properly setup in the of my page. The toggled version of the same bot works fine. So the issue seems to rely on the embed setup but I can't figure it out. No JS error shows in console. Anyone ran into the same problem ? Any help or tip would be greatly appreciated. Thanks a lot ! https://cdn.discordapp.com/attachments/1440619528332640287/1440619528588496978/Capture_decran_2025-11-19_a_09.17.03.png?ex=691ed0fd&is=691d7f7d&hm=dd32d177e82e2a2d56c49f3fd13f8ff0264417662482fc665dc5c770e6c7c37f& https://cdn.discordapp.com/attachments/1440619528332640287/1440619529070710885/Capture_decran_2025-11-19_a_09.17.16.png?ex=691ed0fd&is=691d7f7d&hm=679a811a554f6dad1af542bac87797bd3b9081d0068b40fc444e5065fc44f125& https://cdn.discordapp.com/attachments/1440619528332640287/1440619529322496010/Capture_decran_2025-11-19_a_09.17.39.png?ex=691ed0fd&is=691d7f7d&hm=0fdb0ae3dc7083d0bd144fb6148be2d4c3937fc6b919a68d33a9e3b4d14ca2f8& https://cdn.discordapp.com/attachments/1440619528332640287/1440619529591066765/Capture_decran_2025-11-19_a_09.17.57.png?ex=691ed0fd&is=691d7f7d&hm=1f692323adea04c8008fa257784e97cd2c850b405ec2f790ba53b2eaf94af3ce& https://cdn.discordapp.com/attachments/1440619528332640287/1440619529850851449/Capture_decran_2025-11-19_a_09.18.22.png?ex=691ed0fd&is=691d7f7d&hm=eb64cebe03d591b0f2a3693c0869979aa6ba0f76b5ee02fc2e3fd867800acc47&

Hey there, quick question: Does botpress recognize variables inside variables? Usecase: I use a couple actions in multiple places. Instead of copy and pasting the prompts for these action everytime I defined a variable and saved the custom prompt as default value in it. In these custom prompts I use variables to get some other information. Back to the question: Do you run a recursive loop to really match all variables or just a one time run and my variables are sent as plain text?

Hey everyone, I'm trying to set up a fallback behaviour. I want the bot to: 1) Search the KB 2) If a high-confidence result exists → use only the KB data 3) If no KB result or confidence < 0.75 → fall back to OpenAI and generate an answer What’s the recommended way to implement this in Botpress right now? Should this all stay inside the Autonomous Node, or should I handle the fallback using a condition + separate node? Any guidance appreciated!

Hello, how does the 500-message limit work? Is it only the incoming messages sent by the user, or all the messages displayed in the chatbot? https://cdn.discordapp.com/attachments/1440375494242467840/1440376258788851784/image.png?ex=691dee6c&is=691c9cec&hm=4af85c44e82123dc42230045080b5ab73910947699453af67ac26111227f8d9d& https://cdn.discordapp.com/attachments/1440375494242467840/1440376259493494875/image.png?ex=691dee6d&is=691c9ced&hm=66a3dba7bb6e90860c2deea604c16e22f4ceeb0c2b2852001079beca4b8f7de4&

I have a client who uses Gitbook and Botpress, and now he wants to add the chatbot to Gitbook pages or, at the very least, embed the Webchat in a page, but I'm not finding a way to do so. The embed in the page converts to a link and does not display the webchat.

my webchat it doeesn't working at all (mainly it doesn't response any request). current version 3.3. - first when we type the query it doesn't turn into chat interface. (more like pass by) - TRY ON EMULATOR IT'S FINE AND WORKS, when publish, try through cdn doesn't work - not embed at all. try from cdn.botpress

I reached my 5k limit really quick, and am wondering if this is a glitch? I haven't sent even more than 150 messages yet, but its still saying that I reached the limit. Would really find it helpful if someone could give me some insights in what may be causing the problem. Thank you! https://cdn.discordapp.com/attachments/1440243063703343114/1440243064034689077/image.png?ex=691d7260&is=691c20e0&hm=9ec4a465fa192f89f1b7e5a2032505e8b9ec06dc6773a653bd97749178cd07f5& https://cdn.discordapp.com/attachments/1440243063703343114/1440243064521359390/image.png?ex=691d7261&is=691c20e1&hm=427af889e6cae37d1aedf62429425a2e7229013841df140d82af252f2cf891a7& https://cdn.discordapp.com/attachments/1440243063703343114/1440243065020354601/image.png?ex=691d7261&is=691c20e1&hm=df48a89f46f0133eb66dd9a3415e8b8b45b5ede804a3686d198957bcef4d7fb3&

I need my bot to ask the user if it's being helpful after the bot has responded to four messages. If the user says yes, the bot should suggest subscribing to my newsletter. I have a Workflow in Main with an AutonomousNode that includes the instructions and knowledge base. That works perfectly. What I'm doing is using the "After Incoming" hook to increment the variable event.state.conversation.messageCount. If the variable equals 4, I set event.state.conversation.goToFeedbackWorkflow to TRUE. Then in the "After Turn End" hook, if event.state.conversation.goToFeedbackWorkflow is TRUE, I try to go to a Workflow called "feedback_workflow". But it doesn't work - I get this error: "An error occurred on hook after_turn_end "GoToFeedback": Error: event.setFlag is not a function" I think my strategy is too complicated. Before this, I was trying a different approach: adding an 'Always' transition in the AutonomousNode that would go to a Card, and in that Card, using AI Transitions with expressions like {{goToFeedbackWorkflow ? 'GO_FEEDBACK' : 'CONTINUE'}} or {{@conversation.goToFeedbackWorkflow}} to create the flow and go to a Card where I could ask the user for feedback. But the AI Transition doesn't work (or maybe it's the transition from the AutonomousNode that doesn't work). That's why I tried using a separate workflow instead. What's the correct way to conditionally redirect to a different workflow after the 4th message? Is there a simpler pattern in Botpress for "after N messages, execute a specific workflow or node"?

We're moving forward with our Microsoft Teams integration and have a question regarding billing and costs. In our setup, the Azure Bot acts only as an intermediary between Botpress and Teams. All the logic and execution lives entirely in Botpress. Since the implementation and billing happen on Botpress' side, we're trying to understand whether Azure or Microsoft Teams introduce any additional costs in this scenario.

I'm trying to start an existing conversation in the Webchat. In the window.botpress.init section I'm adding the conversationId and it also seems I need to provide userId and a userToken (though I can't find this documented anywhere). Something like this: window.botpress.init({ "botId": "", "conversationId": "", "user": { "userId": "", "userToken": "" }, ... }) Asking the docs bot, they say I need to set the webchatSigningKey in the dashboard. I can then use this secret along with the userId to sign a jwt which I'll pass in the init. The only thing is I cannot find anywhere to configure this secret in the dashboard... There are a load of webchat config options but they are mostly theme related. I've spent a while trying to find this and not been able to, however it's still possible I may have just missed it. Any help really appreciated! https://cdn.discordapp.com/attachments/1439994652286779452/1439995255033434167/image.png?ex=691c8b96&is=691b3a16&hm=f6230a63fa6d14eea8b82280f185f01b9fe2619a5b8049b6e8c6c7698e717467&

I can't make a call to the createOrGetConversation API. My bot is using the Telegram channel, it has been working through Telegram for a while now. The API asks me for an integration Id or name. "message": "Must specify either integrationId or integrationAlias" And I make the listIntegrations call but it returns a 200 and without listing the integrations: {"integrations":[],"meta":{}} In addition, channel and tags are required so I enter the values: channel: Telegram tags: id: (Telegram identification number) Can you help me with what I'm doing wrong in the call?

Hi - not sure if this is the right place to post this but I have a question. For agents that are created and deployed, is the conversation data used in anyway to train the source LLMs and can this be configured. For example, if I am using an Open AI 4o model within my workflow, is the information the bot receives by users used and stored by either bot press or open Ai in anyway to train public models.

I need to train my bot on about 7000 website pages but it doesnt seem to be able to handle so many site pages. How can I train it on a large website?

I am currently facing problems building my nextJS React application with

@botpress/webchat@3.2.12

The error I am getting while building the app is as follows:

/node_modules/@botpress/webchat/dist/index.js:23718:1
Module not found: Invalid generator object. Asset Modules Plugin has been initialized using a generator object that does not match the API schema.
 - generator has an unknown property 'filename'. These properties are valid:
   object { binary?, dataUrl? }
   -> Generator options for asset/inline modules.
  23716 | }), jY = {
  23717 |   // Optimized OGG file (4.4KB instead of 124KB WAV)
> 23718 |   chatMessageNotification: new URL("data:audio/ogg;base64

There seems to be no documentation on how to build this or what kind of build system is required. I also noticed in the distributed webchat backend that the source code still contains an import to a

style.css

which is not common in a ready to use component package. There is also no documentation anywhere on this. Unfortunately the

@botpress/webchat

also doesn't seem to be open source the repository is pointing to an unreachable location in github. So there is also no easy way to look into this myself. Did anyone else face a similar issue?

Hi, I setup Botpress for a client, they love it, and now they are selling their company and need the email address switched over to a new account. Can you help me switch my accounts current email address to theirs?

Hey there, I'm currently struggeling with adding a FAQ-first feature to my autonomous nodes. The idea is to : - Always search the FAQ knowledge base for things that could slightly affect the response - Always search a second knowledge base that has the "real" data I need these KBs to be seperate, because there might be FAQs like Q:"when doese the skiing resort open?" A:"skiing resort will open on the 04.12.2025" And somebody asks for the lift services. So in the regular RAG it won't show up because it might not match with high enough relevance. Another example could be a QA about a blocked road or something similar. I tried adding 2 search knowledge cards with the different KBs but the LLM never uses both tools, however hard I try with the prompts (also card prompts). Is there a best practice on how to achieve that?

I'm currently working on the bot and I'm having a problem: whenever I test the bot from an emulator it works perfectly, but when I try it from WhatsApp, Telegram, or WebChat it doesn't work.

I have a WhatsApp bot that handles order bookings from stores and restaurants. Therefore, I have an API link containing restaurant information in JSON format. Each object contains some information; for example, a restaurant has things like its name and a link to its menu. The challenge is that the entire restaurant list is contained within a single link, and each restaurant has its own data, such as the menu link. What I want is to create a bot that, if a customer requests a burger from a specific restaurant and specifies their order, will retrieve that information with its details according to my desired format. I've tried many methods to implement this, but I haven't been able to. (Note: I have an API key. I want the bot to retrieve the menu link when the restaurant is called, then retrieve that link to access the menu and answer the customer's queries.) The most difficult aspect I encountered was the input and output commands. I couldn't understand them and tried to have them written by an AI, but sometimes I get results, though the output is often in the form of code like

div a href

. I watched a YouTube video explaining the action, but it wasn't very detailed. i spend more than three days i was working in this. @loud-crowd-60573

I'm trying to use the following code to start a proactive twilio conversation (basically get a conversationId): console.log('Main webhook payload:', event.payload.body) user.customerName = event.payload.body.name user.customerPhone = event.payload.body.phone const result = await actions.twilio.startConversation({ conversation: { userPhone: user.customerPhone, activePhone: env.twilio_number } }) console.log('Generated convId object:', result) event.conversationId = result.conversationId The error received in the logs is: Error while executing integration action: An unexpected error occurred in the integration. Bot owners: Check logs for more informations. What am I doing wrong? If I try to use the Start Proactive Conversation card, I get a slightly different error that says: Error while executing integration action: Could not create conversation: missing channel, channelId or userId. Do I need to create a user using the twilio card? My intent is to start a new conversation with the received context data from the webhook.

???? https://cdn.discordapp.com/attachments/1438436821007597618/1438436821490208768/Screenshot_2025-11-13_at_08.53.53.png?ex=6916e02f&is=69158eaf&hm=15e32057be120069f51cb8a34754cbd6b60d9628f19a9f065407e0cf43e72a43&

[google-ai] Google AI error: {"error":{"code":429,"message":"You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits. To monitor your current usage, head to: https://ai.dev/usage?tab=rate-limit. \n* Quota exceeded for metric: generativelanguage.googleapis.com/generate_requests_per_model_per_day, limit: 0","status":"RESOURCE_EXHAUSTED","details":[{"@type":"type.googleapis.com/google.rpc.Help","links":[{"description":"Learn more about Gemini API quotas","url":"https://ai.google.dev/gemini-api/docs/rate-limits"}]},{"@type":"type.googleapis.com/google.rpc.QuotaFailure","violations":[{"quotaMetric":"generativelanguage.googleapis.com/generate_requests_per_model_per_day","quotaId":"GenerateRequestsPerDayPerProjectPerModel"}]}]}} Is this error message my fault? I only sent a test message with Execute Code. There is no other traffic in the chatbot.

Hey botpress-team, In the Home tab of the studio there is usually a field to edit the general instructions for the chatbot right? I've seen and edited it but it doesn't show up anymore: https://cdn.discordapp.com/attachments/1438207044820795544/1438207045114400999/image.png?ex=69160a30&is=6914b8b0&hm=2d36c735adbc4d9f5e85535213f4f361e01aa07eaf69c461eeed8ea4e6fc4c6e&

Hi Botpress team, I'm trying to build a bot on your platform since a couple weeks and I found a couple issues in the Botpress Studio: Your software is feature-rich and promising but the editing experience is sometimes nerve-wrecking. 1. Backspace deletes entire node without warning It happened to me multiple times that I was working on an autonomous node's instructions. Due to some lag / issue the instructions window lost focus and instead the node gained focus and was immediately deleted because I guess the last input I gave was a backspace. In most cases I was able to recover the node but just now I lost 2 hours of work because the Ctrl+Z wouldn't work anymore. 2. Studio freezes and shows full black screen It happened to me also multiple times already that the studio freezes completely and I see in the Console that message. Only a page refresh solves the issue and some edits were lost. Console: vendor-7bcd6c2.js:50852 Error: Minified React error #300; visit https://reactjs.org/docs/error-decoder.html?invariant=300 for the full message or use the non-minified dev environment for full errors and additional helpful warnings. at Xh$4 (vendor-7bcd6c2.js:64515:13) at dj$1 (vendor-7bcd6c2.js:65218:42) at Wk$5 (vendor-7bcd6c2.js:67316:88) at Vk$1 (vendor-7bcd6c2.js:67018:13) at Uk$5 (vendor-7bcd6c2.js:67009:7) at Jk$1 (vendor-7bcd6c2.js:66996:9) at Ok$4 (vendor-7bcd6c2.js:66759:82) at Fk$4 (vendor-7bcd6c2.js:66815:30) at jg$1 (vendor-7bcd6c2.js:63725:17) at vendor-7bcd6c2.js:66653:24 3. Window "updated" / "refreshes" by itself Once in a while the botpress studio rerenders itself completely and therefore loosing focus of the current editable field. I think it's a react state change issue you are having there. Also these re-renders make the editing experience quite a balancing act. I started to write all prompts and instructions in local files again, because editing live is too dangerous.

Hi Botpress team, quick sanity check on AI Spend. Plan: Pay-as-you-go Workspace: Digital Palestine by SSA Period: last 30 days Usage: 12 sessions, 63 bot msgs, 33 user msgs, 7 users Dashboard: AI Spend shows $6.47 of $25 used (screenshot attached) This feels high for a few light tests. Logs show most turns at ~5k–7k tokens costing ~$0.012 on gpt-4.1, but I also see spikes around $0.12 that look like a higher-tier call or multi-iteration. Questions: 1) Is this spend normal for this volume? 2) How do I hard-lock the bot to a single low-cost model, e.g., 4o-mini or 4.1-mini? 3) How can I disable improvement iterations and any dual-model fallback in Autonomous nodes? 4) Best way to cap cost per turn and avoid long reasoning chains? 5) Any caching or KB lookup settings to reduce repeated tokens? Thanks!

How can i still have a fast replying bot with these many pages. i feel like the bots get super slow after 50+ which is understandable. Maybe its possible to compromise the sites to make them a small description of the sites and upload them as files. Anyone has any experience with this?`let me know

hello, i was trying to import JSON of restored bot state into my bot but i could find only import but that doesnt work. Nothing happens, im not sure how to import this JSON. Any help please ? Thank you very much

I'm hoping this is a softball question for someone. I'm brand new to the platform. I've got the AirTable integration set up and it shows up with available actions for cards. But I'm not able to figure out how to use its records as a knowledge source. Should it show up like Notion does? Or do I have to integrate it with a Botpress table? I'm trying to set this up for a client to be able to administer the knowledge within AirTable, as they are comfortable with that platform. Thanks for any help you can provide!

As the title says... I click the 'EDIT (Search)' function on the left side, below 'Bot Settings'... and NOTHING. Does NOT work. I've restarted my PC, browser, and logged out and back in. SAME. 'ctrl /' does NOT work either. Please advise/fix.

Hi guys, So ive been heavily testing my bot today (webchat), and now it will barely respond, it takes ages and especially triggers. i keep getting this in my logs:

Error sending outgoing message {
  integration: 'webchat',
  messageType: 'text',
  payload: '{"type":"text","text":"Applying settings..."}',
  error: TimeoutError: Sending message took more than 10s
      at Timeout._onTimeout (/var/task/customer_code.js:159:8932)
      at listOnTimeout (node:internal/timers:581:17)
      at process.processTimers (node:internal/timers:519:7)
}

is any one else experiencing this latency in their bots today? https://cdn.discordapp.com/attachments/1437814309903143012/1437814310192807936/Screenshot_2025-11-11_at_14.40.08.png?ex=69149c6c&is=69134aec&hm=1c3646e2fcd976285ab7324c50a2e547b70b6b980533aa59711bce8eab4b821e&