Bot Prompts

overview bot prompts are a core category of interactive elements in the flow builder designed for two way communication, specifically to request and collect information from the user while "bot messages" are for displaying information, prompts are for gathering it they pause the conversation flow and wait for the user to provide an input, which can then be validated and stored in a variable for later use these elements are critical for building any transactional or data driven chatbot they allow you to capture essential details like a user's name, book an appointment by asking for a date, or collect documents for a verification process the platform offers a wide range of specialized prompts, from simple text inputs to complex, multi field forms and channel specific interactive menus the available bot prompt types include basic inputs text, name, phone, email, pan, aadhaar media uploads file, video recording interactive choices quick replies, confirmation, choices, whatsapp list complex data collection form, calendar, location, range slider channel specific whatsapp catalogue, whatsapp flows, whatsapp payments advanced custom validator using prompts effectively is the key to creating interactive, personalized, and functional conversational journeys how to use bot prompts bot prompts are added as elements inside a node on the flow builder canvas once added, a configuration panel appears where you define the prompt's behavior 2 1 adding a bot prompt on the flow builder canvas, click the + icon on a node to add a new step from the element menu, select the prompts category choose the specific type of prompt you need (e g , name, form, calendar) 2 2 common configuration settings most prompts share a set of common configuration options enter default response the question or instruction the bot shows to the user (e g , "please enter your email address ") enter response if validation fails the error message the user sees if they provide invalid input (e g , "that doesn't look like a valid email please try again ") maximum attempts allowed the number of times a user can retry after a validation failure before the flow takes a different path action after maximum failed attempts if the user fails all attempts, you can configure the flow to end flow , restart flow , or go to another step store response in a variable this is the most crucial step you must select or create a variable to save the user's input this allows you to use the collected data later in the flow (e g , to personalize a message or send to an api) 2 3 details for specific prompt types basic input prompts (name, phone, email, pan, aadhaar) these prompts are for collecting specific text based information they each come with pre built validation to ensure the user's input matches the expected format the phone prompt also allows you to set a default country code media prompts (file, video recording) file prompt asks the user to upload a file you can specify the supported file types video recording prompt allows the user to either record a video directly in the chat or upload an existing video file interactive prompts quick replies presents the user with a set of buttons each button can be configured to trigger a different flow, redirect to a link, or jump to another step in the current flow this is used for guiding the user's journey confirmation shows a message with two configurable buttons for positive (e g , "yes, confirm") and negative (e g , "no, cancel") responses each button can be linked to a different next step in the flow choices asks the user to select from a list of options presented as radio buttons (single select), checkboxes (multi select), or a dropdown list (single select) complex data collection form a powerful element for creating multi field forms you can add multiple fields, each with its own input type (text, choices, calendar, file upload, etc ), label, and validator this is ideal for lead generation or detailed data collection calendar displays a date and/or timepicker for the user to select a specific date, a date range, a time, or a time range location prompts the user to share their location you can add validations to accept locations only from specific countries or pincodes common use cases user registration use a series of name , email , and phone prompts to collect user details, storing each in a variable customer feedback survey use a choices prompt with radio buttons for a rating (1 5) and a text prompt for open ended comments scheduling a demo use the calendar prompt to let the user pick a preferred date and time document submission use the file prompt to ask users to upload a required document, like an id card for verification best practices always validate input use the built in validators for prompts like email and phone to ensure you collect clean, usable data provide clear instructions in your "default response," be very clear about what you need from the user (e g , "please enter your 10 digit pan number ") handle errors gracefully write helpful and friendly "validation fails" messages instead of just "invalid input," say "oops, that doesn't look like a valid date please use the mm/dd/yyyy format " use quick replies to guide users instead of open ended text prompts, use quick replies or choices whenever possible this reduces user effort and prevents misunderstanding common mistakes forgetting to store the response the most common mistake is configuring a prompt without assigning a variable to store the user's answer if you don't store it, the data is immediately lost not setting a failure path failing to configure the "action after maximum failed attempts" can leave the user stuck in a loop if they can't provide valid input making forms too long a form with 10+ fields can be intimidating in a chat interface break down long data collection processes into a series of smaller, individual prompts to make it feel more conversational using the wrong prompt type don't use a text prompt when a choices or quick reply prompt would be more efficient and user friendly match the prompt type to the kind of data you need