Hello! I have completed my bot flow, but the Publish button remains grayed out and unclickable. The emulator / preview does not work as expected either. I have checked the nodes for errors, but cannot find what is blocking the publication. How can I resolve this? Attached is my studio screenshot. https://cdn.discordapp.com/attachments/1569599516598865961/1569599516900860007/4a255b3e-ce8d-4e48-a223-c756f5908f5d.jpg?ex=6af40af6&is=6af2b976&hm=6bc17f532b4adae394b3d8078c7991f731562930d6e5b29247654dfe60dbdb6e&

Hi! I'm using Botpress with the official WhatsApp integration and WhatsApp Business App coexistence. I need my bot to automatically stop replying to a specific customer when a human agent sends a message from the WhatsApp Business mobile app. The "Message Echo Received" trigger is enabled, but its payload appears empty. How can I identify the customer conversation associated with this event and set a conversation variable to pause the bot only for that customer? Is this supported natively, or does it require a custom integration?

My objective is to send an image to a user on WhatsApp. There are two images in my flow, one uploaded static welcome image, and another image URL passed through as a workflow variable. This was working as expected previously up until the 08th of October 2026. The problem is that neither images are currently rendering in WhatsApp when leveraging the Botpress WhatsApp integration. Image rendering fails silently and is not captured in the logs. I have tested sending images to the WhatsApp API directly via a execute code card. This works successfully - I receive a 200 response and the image renders in WhatsApp as expected. I have uninstalled the WhatsApp integration, and then reinstalled. I am able to have a text based conversation as expected, but images do not render at the key points in the journey. For context, I am using version 4.18.5 of the WhatsApp API and have configured the integration manually (not connected via OAuth).

My bot has a live OAuth WhatsApp connection (one production number, ~1 year of customer conversations, cannot be disconnected). I want to ADD my existing WhatsApp Business app number via Meta Coexistence. I've verified your "Connect with OAuth" launches Embedded Signup with featureType: whatsapp_business_app_onboarding — great. But on a bot that already has a connection, that button does nothing (no popup, no network request). Question: if I onboard the second number into the SAME WhatsApp Business Account the existing connection already uses, will the integration see both numbers (e.g. after hitting the refresh icon on the connection)? The config has a "Default Bot Phone Number ID" field, which suggests multi-number support. Does inbound from both numbers route to the bot? If not, what's the recommended way to add a second number without disconnecting the first? Thanks!

Hello Botpress Community, I'm developing GONOGO, an AI-powered decision-support product for infrastructure and EPC companies, using Botpress. I'm facing an issue with the official Google Sheets integration (v2.1.10) in my published bot. 1. What I've configured: - Google Sheets API enabled in Google Cloud. - Google Cloud Service Account created. - Target spreadsheet shared with the Service Account as Editor. - Spreadsheet ID, Service Account email and complete private key entered in the manual configuration. 2. The problem: When I click "Save Configuration", the button briefly dims but nothing happens. No confirmation or error appears, and the integration remains at "Needs setup". The OAuth method also fails with this message: "The API developer key is invalid." The issue persists in Chrome and Incognito mode. 3. My questions: - Is this a known issue with integration v2.1.10? - Is there a workaround for saving the Service Account configuration? - Is the integration fully supported on the Free plan? Any technical guidance would be greatly appreciated. Thank you!

Hello Botpress Community! I'm building an educational AI assistant using Botpress Viber on the Free plan. My goal: Create an assistant that supports parents of children with feeding difficulties, maintaining separate and private conversation histories for each family. The problem: During Preview testing, I created two fictional scenarios: - Session 1: A child who frequently coughs when drinking water and has difficulty swallowing. - Session 2: A different child who refuses carrots. Even after starting a new session, the assistant incorrectly mentioned the swallowing difficulties from Session 1 as if they belonged to the child in Session 2. What I've already tried: - Updated global memory instructions. - Added safety rules preventing information from being mixed between cases. - Started a new Preview session. - Reviewed the agent's Playbook and knowledge base. The problem still occurred. My questions: 1. Does Viber Preview reuse the same user identity or persistent memory across sessions? 2. How can I disable or isolate persistent memory during testing? 3. How can I ensure that different parents have completely separate memories? 4. Can I maintain separate records for two children belonging to the same parent? 5. Are these features available on the Free plan? I'm using Botpress Viber in the web editor. The agent is still unpublished. Any guidance would be greatly appreciated. Thank you!

Hello Botpress community! I'm configuring a WhatsApp customer support chatbot for my company, FASTNET TELECOM, using Botpress Studio and Botpress Desk. The bot successfully transfers customers to human agents, and agents can reply through Botpress Desk. However, I need help with two issues: 1. When a human agent closes a ticket in Botpress Desk, an automatic customer satisfaction survey appears on WhatsApp, asking customers to rate their experience (positive, neutral, or negative). How can I completely disable this survey? 2. Some automatic Botpress Desk messages are sent to WhatsApp customers in English, including the human handoff notification and the conversation closure notification. How can I change these system messages to Brazilian Portuguese (pt-BR)? I have already checked the Botpress Desk settings and Brand Voice settings, but I couldn't find an option to disable the survey. I want to keep the existing human handoff functionality and manual ticket closure working normally. Thank you for your help!

Title: File Storage 99.7/100 MB on old bot, but same content on a new bot only uses ~35 MB Hi everyone, I’m on the free plan and ran into a storage issue I can’t explain: My old bot’s File Storage shows 99.7 / 100 MB, but Vector Storage is only 8.4 MB. The Default Knowledge Base has 17 items (15 uploaded files + 2 web sync sources) totaling roughly 8.6 MB by file size. I never allowed users to upload files; the bot only sends a form link. I noticed the File Storage jumps up every time I click Publish (I published about 5 times today, see the audit log). When I moved the exact same knowledge content into a new bot, it only used ~35 MB. Questions: What is counted in File Storage besides Knowledge Base files? Does Publish keep old versions or processed copies that count toward storage? How can I clean up the leftover data in the old bot without deleting it? I can share screenshots of the Knowledge Bases page and the audit log if needed. Thanks!

Hi everyone! I’m building a Telegram bot in Botpress Vibe that identifies mushrooms from photos using Google Gemini 3.1 Flash-Lite via a custom HTTP tool. The problem: The integration works intermittently. • At 23:49 on November 3, the tool successfully analyzed a Telegram photo. • At 23:52, the same photo triggered three failed HTTP tool calls. • Botpress Logs show execution_error, Tool: http_uzhojl — failed, and an internal agent runtime error. • The Gemini API works when tested directly with curl (HTTP 200). • I’m using Botpress Free and the Gemini API free tier. My questions: 1. How can I see the actual HTTP status code and error response for a failed tool call? 2. Could this be caused by image URL accessibility, the HTTP tool, or Gemini API errors? 3. What is the recommended way to handle intermittent HTTP failures? I’ve attached screenshots of the logs. Thank you for your help!

Hello Botpress Community, I need technical assistance with my AI agent, CONSULTOR OEA IA. I uploaded a PDF document named "Res 015 -OEA Exportadores.pdf", containing Colombia's Resolution 000015 of 2016. The document appears in my knowledge base and is marked as indexed. However, when I use the search_knowledge tool, it cannot retrieve any information from this document. I tested searches such as: - Resolución 000015 de 2016 - Artículo 4 - Controles de acceso físico Instead of retrieving the OEA document, the search returns unrelated Botpress Viber documentation. The PDF contains selectable text, so it is not simply a scanned document. Could someone help me verify: 1. Whether this document is actually included in the knowledge base used by my agent. 2. Whether its text was correctly extracted and indexed. 3. Why the search returns unrelated Viber documentation. 4. Whether it is possible to safely reindex only this document. IMPORTANT: Please do not recommend deleting or rebuilding my agent. I want to preserve my existing agent, playbooks, instructions, and all uploaded documents. Thank you for your help.

I used botpress years ago. I'm getting charged every month for Always on. Every time I come in and turn OFF always on, only to get charged AGAIN next month. I came today to finally DELETE my account but I can't cause I can't delete the old workspaces. Please someone from support just help make this right. I can't self-serve

Hi, i have been having a error in wordpress regarding the embed script of the botpress in ahrefs it is giving not accessible error while i understand it, is there any way i can fix it?

Hi everyone! 👋 I'm a BS Information Technology student from Pakistan, currently learning AI Engineering and Full-Stack Development. My main interests are: - Agentic AI and AI Agents - Python, Flask and FastAPI - React and Tailwind CSS - LLMs, RAG and LangChain I'm currently building an AI-powered Job Agent using Python, Flask and Ollama. I'm looking forward to: - Collaborating on AI projects - Participating in hackathons - Contributing to open-source projects - Connecting with developers and finding internship opportunities. Happy to connect and learn together! 🚀

Hi Botpress team, Does Botpress offer Meta Partner-Led Business Verification through its official WhatsApp integration, including on the Free plan? The goal is to display an approved business name instead of the phone number in customers’ chat lists, without customers saving the number. Is this available for a small holiday rental operated by a private individual without business registration? If so, which documents are accepted and how can the process be started? Otherwise, what route does Botpress support for this situation? Thanks for clarifying.

Goal: Connect my Botpress agent to WhatsApp so it answers customers. Problem: WhatsApp channel shows "Connected" (OAuth, Configuration Complete) and the bot is Published. In Meta WhatsApp Manager, number +880 1620-301167 shows Status: Connected (display name: Dash Wear Wholesale). When I message the number from another phone, the message is delivered (double tick) and the chat shows "This business uses a secure service from Meta", but no conversation appears in Monitor > Conversations (filter Channel: WhatsApp) and the bot never replies. It has been over 10 hours since connecting. What I tried: disconnected and reconnected via OAuth, enabled the channel toggle, published, tested from a different number, waited several hours. Could someone check the webhook subscription for my WhatsApp number? Thank you.

Hi Botpress team. I’m building a Viber agent in a Free workspace to email a lead summary after a visitor consents. Its HTTP Request tool should POST JSON to Resend’s /emails endpoint with bearer authentication and Content-Type: application/json. In Preview, the agent invokes the tool, but the activity says 'Tool execution did not complete.' Botpress Logs say 'The agent runtime hit an internal error' about 20 ms after invocation. Resend shows no incoming request or API key activity. I reproduced this with a static, valid JSON body, so the failure does not appear to depend on generated lead content or template variables. The tool is enabled in the draft, and these changes have not been published. Should a Viber HTTP Request tool execute in Preview on the Free plan? Is there a supported way to determine why dispatch fails before the outbound request? I can share the runtime reference and tool ID privately with Botpress support.

Hi! I’m building a Telegram bot using Botpress Vibe and Playbooks, without programming. Goal: identify each driver by their actual Telegram user ID, check for an existing record in Google Sheets, and add a registration row if none exists. Telegram is connected and the bot responds. In an actual Telegram conversation, the registration Playbook collects and confirms the test driver’s details, but then says it cannot access a trusted Telegram user ID. No registration is saved. I have added instructions to use the ID from the Telegram integration, but Vibe says it cannot inspect or configure the event-to-Playbook mapping. I have not verified Google Sheets read/write operations yet. How can a Vibe Playbook access the actual Telegram sender’s user ID? Is there a supported no-code method? Please provide exact steps for Vibe, or confirm whether Studio or custom code is required. I found event.tags.user[‘telegram:id’] in the Telegram documentation, but I don’t know whether it is accessible in Vibe. Thank you!

Dear everyone, I'm having an issue with my WhatsApp bot. After receiving a few questions from a customer, the bot hands the conversation over to a human agent. However, after the handoff, the bot never responds to that customer's number again. It only shows the thinking/loading indicator but never sends any replies (please see the attached screenshot). I've tried the following steps to resolve the issue: 1. Asked the customer to clear/delete the chat. 2. Cleared/deleted the chat from my WhatsApp Business account. 3. Closed the ticket in Botpress Desk. Unfortunately, none of these steps have resolved the issue. Has anyone experienced a similar problem or knows how to fix it? Any help would be greatly appreciated. Thank you!

Hi Botpress team. My WhatsApp integration (OAuth connection) shows "Connected" and my phone number is "Connected" in WhatsApp Manager (a real SIM from Peru, not a Meta test number). Messenger and Webchat work fine with the same bot, but incoming WhatsApp messages never reach Botpress. What I see: - WhatsApp shows two ticks (delivered) when I message the number from another phone. - Nothing appears in Monitor > Conversations, Inspect > Events or Inspect > Logs (only botready and botpublished system events). What I already tried: - Re-authorized the OAuth connection (Oct 24, ~10:45 p.m., Lima UTC-5). - Removed the other partners (Make and ManyChat) from my Meta Business portfolio. Before that, the same number appeared under three messaging accounts, and Make got error 131070 ("another app is controlling this thread") when sending from this number. - In Meta Conversation routing, "Customer sends a message" was assigned to Make. I changed all rows to Botpress. - Republished the bot (Oct 25, 11:41 a.m.). - Test messages: Oct 24 at 9:31 p.m., 10:32 p.m., 10:50 p.m. and Oct 25 at 11:44 a.m. Bot ID: 215a59aa-ae4e-428a-a49b-4b283f2508d9 Phone number ID: 1448867871633656 WhatsApp Business Account ID: 4108451959459846 Could you check whether my WABA is subscribed to your webhook and whether incoming events for this phone number ID reach Botpress? Screenshots attached.

Hi Botpress team. I’m unable to access my account. A fresh browser and CLI login both return “identity is disabled” (401). Could you help investigate and restore access? Please let me know how I can share account details and verify ownership privately.

I buit my agent as a chatbot for our event. After it was published, everthing went well, except we found an outdated information in one of our files uploaded. So I DELETE the old file and upload a new one. But then I couldnt find the "Publish" button anymore, which is supposed to locate in the top right corner. I've tried using the new search engine, zooming out my screen 80-90%, clearing my cookie, or private browsing. But none of them worked. So the chatbot just keep answering with the wrong information. Since my event is coming up, and the chatbot link is already sent out to our customers. Is there anyone could help fix this issue. Thanks a lot.

We’re connecting a custom CRM to a published Botpress Viber agent using Instagram DMs and Botpress Desk. Objective Staff should take over and reply from our CRM while AI remains paused. AI should resume only when staff explicitly select “Return to AI.” What works - Instagram DMs reach the CRM and Botpress. - The AI responds successfully. - Asking for a human triggers escalation and creates a Desk ticket. - The ticket can be assigned to our existing staff member. Problem Calling the native

desk-hitl#startHitl

action returns:

{"nextAction":"wait"}

However, the original Instagram conversation has: - `desk-hitl#deskMode`:

"deflect"

- `desk-hitl#ticketId`: populated - `desk-hitl#hitlActive`: absent The installed plugin’s tag definition describes

hitlActive="true"

as the signal used to stop the bot replying during human handling. Our CRM therefore cannot confirm the pause and blocks staff sending. Already tested 1. Built-in escalation following a request for a human. 2. CRM-triggered native

startHitl

. 3. Assigning the Desk ticket to an existing staff member. 4. Native

stopHitl

, followed by a fresh

startHitl

cycle. The pause flag remains absent. We have not manually written pause tags or bypassed verification. For context, Meta delivers incoming messages to our CRM, which stores them and forwards eligible test messages to the Botpress Instagram webhook. This is currently limited to one consenting test conversation. Questions - What exactly does

nextAction: "wait"

mean? - Is

desk-hitl#hitlActive

the supported pause signal for a current Viber agent? - If another signal or API should be used, which one? - Is an additional setup step required for native pause and release when staff use an external CRM?

Hello Botpress Community! I'm using Botpress Vibe on the Free plan to build a virtual assistant for a massage therapy professional. Problem: The assistant works correctly in the internal Botpress preview. However, the public shareable Webchat v5.0 intermittently displays this error: "Failed to execute 'insertBefore' on 'Node': The node before which the new node is to be inserted is not a child of this node." The first response usually appears correctly. When I send another message, the Webchat sometimes crashes. After reopening the public chat link, the previous responses are displayed correctly, so the agent appears to be processing and saving them. What I've tested: - Google Chrome and Microsoft Edge. - Incognito/private browsing mode. - Different questions and menu options. - Internal preview, which works normally. - Republishing the agent after configuration changes. Environment: - Botpress Vibe/Build - Free plan - Public Webchat v5.0 shareable link - Windows desktop Expected behavior: The public chat should display each response without crashing or requiring a page refresh. Could someone help me identify the cause and recommend a fix? Thank you very much!

its not letting me change my email for botpress its currently haydenmccann54@gmail.com and i want to change it to mccann_hayden@yahoo.com

Hi! I'm using Botpress Vibe/Build on the Free plan. I've installed the official Google Sheets integration and connected my Google account via OAuth, and authorized my spreadsheet. Although issues keep persisting as its about to put it into the spreadsheet it fails and sends it to a human provider(Me) to help. Thank you.

Hello, I need help with Knowledge Search in Botpress Cloud (Build/Vibe). I’m building a Japanese-language assistant for staff to answer questions using uploaded workplace manuals. I uploaded the same manual in PDF, DOCX, and TXT formats. All three files show a green check mark in Knowledge > Files. However, the agent often cannot retrieve specific details from the manual. In the execution details for search_knowledge, I see: “Nothing in the knowledge base matched.” For example, the manual says to wash the backs and edges of plates because they may be greasy, and to place two sheets of paper on a tray when drying dishes. The agent sometimes answers the first detail but cannot find the second. I also tested removing a potentially conflicting FAQ, but the problem continued. My goal is to upload manuals and have the agent answer questions accurately from their contents without manually creating FAQs for every detail. Could you help me identify why Knowledge Search is not retrieving these passages and how to fix it?

Hello Botpress Support, My Telegram bot @TRANSLINK_uz_bot is connected in Botpress, and the Telegram channel is enabled. However, when I send messages to the bot on Telegram, it does not reply, and no new conversations appear in Monitor. The bot responds correctly in the Botpress Preview. I have published the agent and checked the Telegram channel configuration, where a webhook URL is displayed. Could you please check whether Telegram webhook updates are reaching my bot and whether there are any delivery or processing errors? Thank you.

Hi, my Botpress chatbot is successfully sending enquiry data to Google Sheets, but a Sheets error message still appears. The chatbot works on my laptop, users can type and complete the conversation, and the submitted data appears in the sheet. Could you help me identify why an error is showing despite the data being saved? I can provide a screenshot of the exact error and the relevant workflow settings. Thank you.

I'm sending an Authentication template with a "Copy code" button using Start Conversation. Meta returns error 131008: "Button at index 0 of type Url requires a parameter". What is the exact format of an item in "Template button parameters" (templateButtonParams) for the copy code button? A short example would help.

I wish to delete my account.