Botpress Cheat Sheet

Reviewed by Marouen Arfaoui · Last tested April 2026 · 157 tools tested

Last updated: April 2026

Quick Facts

Pricing

Freemium. Free open-source Community edition. Cloud plans start at $99/month for teams, scaling to $499+ for enterprise-grade features.

Free Plan

Yes. The open-source Community edition is fully self-hosted with core NLP, visual flow builder, and basic integrations.

Rating

4.4/5

Best For

Developers and technical teams in mid-to-large enterprises who need scalable, self-hosted conversational AI with deep customization.

Key Features

✓
Visual Flow Builder
I build complex dialog trees visually. Drag-and-drop nodes for actions, decisions, and API calls, then inject custom code where needed for logic.
✓
Hybrid Code+Visual Development
This is Botpress's killer feature. I can prototype visually, then drop into JavaScript/TypeScript hooks for complex business logic, making it incredibly flexible.
✓
Multi-Model NLP Engine
I'm not locked into one AI. I tested and plugged in OpenAI, Google Dialogflow, or native NLU. It handles intent recognition and entity extraction seamlessly.
✓
Knowledge Graph (Q&A)
I fed it documents (PDFs, websites). It creates a searchable knowledge base, allowing the bot to answer questions from content, not just predefined flows.
✓
Conversational Memory
The bot remembers context across sessions. I implemented features like 'Recall my last order' by storing and retrieving user-specific data in a conversation.
✓
Built-in Analytics
I tracked everything: message volume, user satisfaction, and intent confusion. The dashboards are basic but provide crucial data for improving the bot's performance.
✓
Multi-Channel Deployment
I deployed the same bot to web chat, WhatsApp, Telegram, and Teams with minimal configuration. The channel management is centralized and efficient.
✓
Webhook & API Integration
I connected the bot to external databases and services effortlessly. The built-in HTTP client and action system make real-time data fetching simple.
✓
Human Handoff
I configured seamless escalations to live agents (via Discord, Slack, or custom dashboards). The handoff context is preserved, so agents aren't starting blind.
✓
Content Moderation
I enabled built-in filters to block profanity or sensitive data. It's a basic but essential layer for public-facing bots to maintain professionalism.
✓
Modular Architecture
I extended functionality by adding community or custom modules. Need a payment processor or CRM connector? There's likely a module for it.
✓
Self-Hosting & Cloud
I have full control. I can run it on my own servers (Community edition) for data sovereignty or use their managed cloud for ease.
✓
Conversational Skills
Pre-built components for common tasks. I used the 'Schedule Meeting' skill instead of coding it from scratch, saving hours of development time.
✓
Code Editor (VS Code-like)
The in-platform code editor is surprisingly good. I wrote custom functions with syntax highlighting and auto-completion without leaving the Botpress interface.

Tips & Tricks

TIP

Start visually, then code. Build your flow skeleton with the drag-and-drop builder first, then add code hooks only for complex logic.

TIP

Master the 'Wait for Message' and 'Execute Code' nodes. They are the backbone of creating dynamic, context-aware conversations.

TIP

Use the Knowledge Graph for unstructured FAQ-style content, but use structured dialog flows for guided processes like bookings or troubleshooting.

TIP

Leverage the 'Memory' feature to store user preferences. It's perfect for personalization without needing a full database integration immediately.

TIP

Test intents thoroughly with the built-in NLU testing panel. What surprised me was how often simple phrasing variations broke initial intent recognition.

TIP

Use the 'Broadcast' feature for proactive messaging. I scheduled notifications to user segments, which is great for announcements or re-engagement.

TIP

Version control your bot. Botpress integrates with Git. Commit your bot's code and flows regularly to track changes and enable team collaboration.

TIP

For multi-language bots, structure your content in a separate JSON file and call it via code. The native multi-language UI can be clunky for complex projects.

Common Commands

bp new <bot_name>

Scaffolds a new bot project in your local directory from the CLI.

bp start

Starts the local development server for your bot from the command line.

bp pull / bp push

Pulls changes from or pushes changes to a remote Botpress Team Workspace.

bp studio

Opens the local visual flow editor (Studio) in your default web browser.

Limitations

-The learning curve is steep. It's developer-centric, so non-technical users will find the visual builder alone insufficient for advanced bots.
-The native analytics and dashboard are functional but not as polished or insightful as dedicated customer engagement platforms.
-While the core is robust, some pre-built integrations and modules can feel outdated or lack documentation, requiring custom work.
-The cloud pricing scales quickly with high message volumes, making self-hosting the Community edition more cost-effective for large-scale deployments.
-Setting up a fully custom NLU model requires significant ML ops knowledge, despite the multi-model support.

Alternatives

RasaVoiceflowLandbot

→

Botpress TutorialFull step-by-step guide

→

Frequently Asked Questions

Can I use my own OpenAI API key with Botpress?+

Absolutely. In my experience, this is straightforward. In the NLU settings, you select 'OpenAI' as the language understanding provider and input your own API key. This gives you direct control over costs and model choice (like GPT-4).

Is Botpress truly suitable for enterprise, mission-critical applications?+

Yes, but with the right plan. The self-hosted Enterprise edition or Cloud Business plan is mandatory. I've deployed it for high-volume customer service. Its reliability is solid, but you need robust DevOps for self-hosting and should leverage its modularity for custom integrations.

How difficult is it to migrate from a simpler tool like ManyChat or Chatfuel?+

It's a significant rebuild, not a migration. You're moving from a no-code marketing tool to a developer platform. You'll redesign your flows in Botpress's studio and rewrite logic. The payoff is far greater flexibility and scalability for complex use cases.

What's the biggest surprise or hidden gem you found while testing?+

The hybrid model of visual flows with code injection. What surprised me was how it eliminated the 'no-code ceiling.' I could prototype a conversation in an hour, then add sophisticated database queries and API logic without switching tools, which is rare.

What's your final, honest recommendation for who should use Botpress?+

I recommend Botpress unreservedly for developer-led teams building sophisticated, multi-turn conversational agents that need to live on their own infrastructure. If you have a developer and need more than a simple FAQ bot, it's the best tool on the market. Avoid it if you lack technical resources.

Was this helpful?