Inputs ====== Input blocks collect information from the user — text, numbers, dates, choices, files, and more. Each input block captures the user's response and stores it in a variable for use later in the flow. ---- .. _chatbot-ref-text-input: Text ---- Collects a free-text response from the user. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Placeholder - Hint text shown inside the input field. * - Button label - Label on the submit button. * - Long text - When enabled, shows a multi-line textarea instead of a single-line input. * - Attachments - When enabled, allows the user to upload files alongside the text response. * - Save attachments in variable - Variable to store uploaded file references. * - Attachment visibility - Who can see the uploaded attachments. * - Variable - Variable where the user's text response is stored. ---- .. _chatbot-ref-number-input: Number ------ Collects a numeric value from the user. Validates that the response is a number. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Min - Minimum accepted value. * - Max - Maximum accepted value. * - Step - Increment step for numeric controls. * - Placeholder - Hint text shown inside the input. * - Button label - Label on the submit button. * - Variable - Variable where the numeric response is stored. ---- .. _chatbot-ref-email-input: Email ----- Collects an email address from the user. Validates the format before proceeding. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Placeholder - Hint text shown inside the input. * - Button label - Label on the submit button. * - Retry message - Message shown when the email format is invalid. * - Variable - Variable where the email address is stored. ---- .. _chatbot-ref-website-input: Website ------- Collects a URL from the user. Validates the URL format before proceeding. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Placeholder - Hint text shown inside the input. * - Button label - Label on the submit button. * - Retry message - Message shown when the URL format is invalid. * - Variable - Variable where the URL is stored. ---- .. _chatbot-ref-date-input: Date ---- Presents a date picker and collects a date (and optionally a time) from the user. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Has time - When enabled, includes a time selector alongside the date picker. * - Is range - When enabled, allows the user to select a date range (from/to). * - Format - Date format string for the stored value. * - Min - Earliest selectable date. * - Max - Latest selectable date. * - Button label - Label on the confirm button. * - From label - Label for the start date in range mode. * - To label - Label for the end date in range mode. * - Variable - Variable where the selected date(s) are stored. ---- .. _chatbot-ref-phone-input: Phone ----- Collects a phone number from the user. Includes a country code selector. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Placeholder - Hint text shown inside the input. * - Button label - Label on the submit button. * - Default country code - Pre-selected country code (e.g., ``+1`` for US). * - Retry message - Message shown when the phone format is invalid. * - Variable - Variable where the phone number is stored. ---- .. _chatbot-ref-buttons-input: Buttons ------- Presents a set of clickable buttons for single or multiple-choice selection. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Options (items) - List of button labels. Each item can have a display condition. * - Multiple choice - When enabled, the user can select more than one option. * - Button label - Label on the confirm button (shown in multiple-choice mode). * - Dynamic variable - Variable containing a list of options to generate buttons dynamically at runtime. * - Searchable - When enabled, adds a search field above the buttons. * - Search placeholder - Hint text for the search input. * - Variable - Variable where the selected option(s) are stored. ---- .. _chatbot-ref-picture-choice: Picture Choice -------------- Presents image-based options for single or multiple-choice selection. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Options (items) - Each item has a picture URL, title, and description. Items can have display conditions. * - Multiple choice - When enabled, the user can select more than one option. * - Button label - Label on the confirm button in multiple-choice mode. * - Dynamic items - When enabled, populates items from variables at runtime (titles, descriptions, picture URLs). * - Searchable - When enabled, adds a search field. * - Variable - Variable where the selected option(s) are stored. ---- .. _chatbot-ref-rating-input: Rating ------ Collects a numeric rating from the user via stars or a number scale. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Button type - ``Icons`` (star icons) or ``Numbers`` (numeric scale). * - Length - Number of rating options (e.g., 5 for a 5-star scale). * - Starts at - Starting value of the scale (typically 0 or 1). * - Left label - Label displayed at the low end of the scale. * - Right label - Label displayed at the high end of the scale. * - Button label - Label on the submit button. * - Custom icon - When enabled, uses a custom SVG icon instead of the default star. * - One-click submit - When enabled, selecting a rating submits immediately without a confirm button. * - Variable - Variable where the rating value is stored. ---- .. _chatbot-ref-file-input: File ---- Allows the user to upload one or more files. **Configuration** .. list-table:: :widths: 30 70 :header-rows: 1 * - Field - Description * - Required - When enabled, the user must upload at least one file before proceeding. * - Multiple allowed - When enabled, the user can upload more than one file. * - Placeholder label - Hint text on the upload area. * - Button label - Label on the upload/confirm button. * - Clear label - Label on the remove-selection button. * - Skip label - Label on the skip button (shown when **Required** is off). * - Success label (single) - Confirmation message shown after one file is uploaded. * - Success label (multiple) - Confirmation message shown after multiple files are uploaded. * - Visibility - Who can see the uploaded files. * - Variable - Variable where file references are stored.