What it does
Instructs the agent to ask a specific question, naturally woven into the conversational response.
When to use it
Whenever you need to collect a specific piece of information from the visitor.
Can combine with
@show_options
@mention_specifically
@recommend
Syntax
@ask_question: "Your question here"
Examples
Basic usage:
1. @ask_question: "What is your name?" 2. @ask_question: "What is your company email address?"
Combined with options:
1. @ask_question: "What is your company size?" @show_options["1-50", "51-200", "201+"]
Combined with specific mention:
1. @mention_specifically: "I'd love to learn more about your needs." @ask_question: "What challenges are you facing?"
Tips
- Keep questions clear and focused on one piece of information
- Use conversational language
- Combine with
@show_optionsfor structured responses
- Prefer this over
@show_contact_formfor better user experience
Common Patterns
Sequential information collection:
1. @ask_question: "What is your name?" 2. @ask_question: "What is your email?" 3. @ask_question: "What is your company?" 4. @stop_playbook
Qualification question:
1. @ask_question: "Do you have a budget allocated?" @show_options["Yes", "No"] - If "Yes", proceed to Step 2. - If "No", proceed to Step 5.
Learn More
- Getting Started with Playbooks - Overview and all tools
- Core Concepts & Structure - Understanding playbook structure
- Complete Playbook Examples - See examples in context
- Best Practices & Tips - Expert guidance