Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Bot Dialog entry
How-to guide

How to design effective Bot Dialogs

Dialog design is most of the bot's value. Step structure, intent training, and variable capture all influence how the bot feels to customers.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 19, 2026

Dialog design is most of the bot's value. Step structure, intent training, and variable capture all influence how the bot feels to customers.

  1. Identify the intent the dialog handles

    Each dialog corresponds to a specific customer goal. Write the goal in plain language; vague intents lead to dialogs that overlap and confuse.

  2. Sketch the conversation flow

    Before opening Bot Builder, draft the conversation: bot greeting, what it asks, what it answers, what it does, what it confirms. The sketch becomes the dialog skeleton.

  3. Add intent training utterances

    Provide 20 or more example phrasings per intent. Real customer language varies more than designers expect; thin training data produces brittle intent recognition.

  4. Build steps inside the dialog

    Add Message, Question, Rule, Action, and Navigate steps in the order the conversation flows. Reuse common sub-dialogs through Navigate.

  5. Add Transfer to Agent fallback

    Every dialog should end (or branch) with Transfer to Agent for cases the bot cannot resolve. The fallback is the difference between graceful handoff and customer frustration.

Mandatory fields
Intentrequired

The customer goal that routes user input to this dialog.

Step Sequencerequired

The ordered Messages, Questions, Rules, Actions, and Navigate steps.

Variablesrequired

Context captured through Question steps and referenced later.

Bot Actionsrequired

The work-doing steps (Flow, Apex, lookup, transfer) inside the dialog.

Transfer to Agentrequired

The fallback escalation when the bot cannot resolve.

Gotchas
  • Monolithic dialogs become impossible to maintain. Break into small focused dialogs that compose through Navigate steps.
  • Weak intent training (5 utterances per intent) produces brittle recognition. Provide 20 or more example phrasings per intent.
  • Missing Transfer to Agent at the end of dialogs traps customers in dead-end conversations. Always design the escalation path.
  • Repeated Question steps for the same variable produce a clunky bot. Capture once, reuse the variable everywhere downstream.

See the full Bot Dialog entry

Bot Dialog includes the definition, worked example, deep dive, related terms, and a quiz.