Bot Builder
Bot Builder is the Salesforce Einstein Bot configuration UI, where admins design conversational chatbots that engage customers across Web Chat, Messaging, WhatsApp, Facebook Messenger, and other channels.
Definition
Bot Builder is the Salesforce Einstein Bot configuration UI, where admins design conversational chatbots that engage customers across Web Chat, Messaging, WhatsApp, Facebook Messenger, and other channels. The builder is a drag-and-drop canvas with Dialogs (conversation steps), Intents (what the customer is asking), Entities (data the bot extracts), and Actions (what the bot does in response, including invoking flows or Apex). It is the configuration layer above the Einstein Bot runtime engine.
Bot Builder sits inside the Setup, Einstein Bots area. Each bot has Dialog flows that branch on customer input, hand off to live agents when conversations exceed bot scope, and call Salesforce Flow or Apex actions to query records, create cases, or update customer data. The output of Bot Builder is a Bot Version, which can be activated, deactivated, or rolled back. Multiple Bot Versions can exist per bot, allowing A/B testing or staged rollouts. The classic Bot Builder has been largely superseded by the Enhanced Bot Builder, which adds NLP improvements, multi-language support, and the new Conversation Repair feature.
How Bot Builder lets admins design conversational flows without writing dialog code
Dialogs and the conversation graph
A Dialog is one step or topic in a bot conversation. The Welcome Dialog greets the customer, the Identity Dialog collects their name and account number, the Order Status Dialog looks up an order. Dialogs link to each other via Intent matching (the customer''s input determined the next Dialog) or explicit transitions. The bot is essentially a graph of Dialogs connected by Intents. Drawing the graph on paper before building in Bot Builder is the difference between a usable bot and a maze; design first, build second.
Intents and Natural Language Understanding
Intents are the categories of what a customer might be asking: Check Order Status, Reset Password, Speak to Agent, Ask About Pricing. Each Intent is trained with sample utterances (the customer messages that should map to this Intent). The NLU engine uses these examples to classify new customer input. Bot Builder displays Intent confidence scores; below a threshold (default 60%), the bot asks a clarifying question or falls back to the default Dialog. Tuning Intents and adding training utterances is the bulk of bot maintenance.
Entities and the data the bot extracts
Entities are typed data extracted from customer input. Order Number is an Entity (regex pattern). City is an Entity (predefined list). Date is an Entity (date parser). Bot Builder ships a library of standard Entities (Email, Number, Date, Phone) and admins can define custom ones. When a customer says "track order ABC123 shipped to Boston," the bot extracts Order Number = ABC123 and City = Boston. Entities populate Dialog variables that subsequent Dialogs can reference.
Actions and back-end integration
Actions are what the bot does between Dialogs. Standard Actions include Send Message (display text), Ask a Question (collect input), Wait (delay), Transfer to Agent (hand off to a human). Custom Actions invoke Salesforce Flow (declarative back-end logic) or Apex (programmatic). A typical flow Action queries the Salesforce Order object by Order Number and returns the order status, which the bot then formats into a response. The Flow integration is what turns the bot from a static FAQ machine into a dynamic agent.
Bot Versioning and the rollback safety net
Each bot has multiple Versions; only one is active at a time. Cloning the current version produces a new draft, where admins iterate on Dialogs, Intents, and Actions without affecting live conversations. Activate the new version to promote it; the old version becomes inactive but is preserved. If the new version breaks something, deactivate it and reactivate the prior version in minutes. This versioning model is what makes bot iteration safe; without it, every change is a production push.
Channels and where bots show up
One bot can serve multiple channels with channel-specific configurations. Web Chat embeds the bot on a public-facing website. Messaging serves SMS and in-app messaging. WhatsApp Business uses the WhatsApp API. Facebook Messenger uses the Meta Graph API. Channel-specific Dialogs handle quirks (WhatsApp does not support buttons the same way Web Chat does). Channel parity is rare; expect to maintain per-channel Dialog variations for any non-trivial bot.
Bot Builder Classic versus Enhanced Bot Builder
Salesforce ships two builder UIs. Bot Builder Classic is the original (around since 2018). Enhanced Bot Builder is the modern replacement, offering richer NLP, multi-language support, Conversation Repair (auto-detection of failed conversations and suggested fixes), and tighter Einstein GPT integration. Salesforce is actively migrating customers to Enhanced Bot Builder; new bots should default to Enhanced. The two builders are not interchangeable; you pick one per bot at creation and cannot switch later.
Building an Einstein Bot in Bot Builder from blank canvas to active version
The pattern: design the conversation on paper, build Dialogs in Bot Builder, train Intents with sample utterances, wire up Actions, test, activate. Plan two to four weeks for a non-trivial bot rollout.
- Enable Einstein Bots
Setup, Einstein Bots, Settings. Toggle Enable Einstein Bots on. Accept the terms; the feature activates. New Bot button appears.
- Create a new bot
Click New Bot. Pick Enhanced Bot Builder (modern) or Classic. Configure name, language, channels, and the initial welcome dialog. The bot is created with a starter set of dialogs (Welcome, End Conversation, Transfer to Agent).
- Build dialogs and intents
Add a Dialog for each conversation topic. Configure the Dialog''s Intent with sample utterances ("track my order," "where is my package," "order status"). Connect Dialogs with transition rules. Use the Test panel to simulate conversations as you build.
- Add Actions and Flow integration
Inside each Dialog, add Actions: Send Message, Ask a Question, Call a Flow. For back-end lookups (order status, customer data), call a Salesforce Flow that queries the right records. Return values are bot variables, available to subsequent Dialogs.
- Test and activate
Use the Bot Builder Test panel to walk through every conversation path. Check fallback dialogs and agent handoffs. Activate the bot version. Deploy to one channel first, monitor for a release cycle, then expand to other channels.
Enhanced Bot Builder (modern, recommended) or Classic. Pick at bot creation; you cannot switch later without rebuilding.
English, Spanish, French, German, Portuguese, Japanese, and more. Enhanced Bot Builder supports multi-language; Classic requires separate bots per language.
Web Chat, Messaging, WhatsApp Business, Facebook Messenger, Apple Business Chat. Configure channel-specific dialog overrides for the channels with custom quirks.
Confidence score below which the bot asks for clarification. Default 60%. Raise for high-stakes use cases (account changes); lower for low-stakes (FAQ).
- Bot Builder Classic and Enhanced Bot Builder are separate products. You pick at bot creation; switching later means rebuilding.
- NLP improvements depend on training utterances. A bot with 5 utterances per Intent will misclassify constantly; aim for 20-50 utterances per Intent before activation.
- Multi-channel bots require channel-specific Dialog variations. WhatsApp, SMS, and Web Chat differ in button support, message length, and media handling.
- Bot Versioning is per-bot. Channel deployments use the active version; deactivating a version mid-conversation can leave running conversations in limbo.
- Flow Actions inside a bot run synchronously. Slow flows make the bot feel laggy; bulkify any record queries and avoid long-running Apex.
Trust & references
Cross-checked against the following references.
- Einstein Bots OverviewSalesforce Help
- Build a Bot with Bot BuilderSalesforce Help
Straight from the source - Salesforce's reference material on Bot Builder.
- Enhanced Bot Builder OverviewSalesforce Help
- Train Bot IntentsSalesforce Help
About the Author
Dipojjal Chakrabarti is a B2C Solution Architect with 29 Salesforce certifications and over 13 years in the Salesforce ecosystem. He runs salesforcedictionary.com to help admins, developers, architects, and cert/interview candidates sharpen their fundamentals. More about Dipojjal.
Test your knowledge
Q1. What is Bot Builder?
Q2. Which of these can you configure in Bot Builder?
Q3. Why use the Bot Builder preview feature?
Discussion
Loading discussion…