Variables

​

Understanding Variables

• User responses from user blocks (text, email, choices, etc.)
• External data from integrations (APIs, databases, etc.)
• System values (timestamps, user IDs, random values, etc.)
• Calculated values from custom scripts or logic blocks

​

Accessing Variables

• View all variables: See every variable declared in your bot.
• Search variables: Use the search bar to quickly find specific variables.
• Create new variables: Click the plus icon or type a new name to create variables.
• Insert variables: Click the variable and it will be inserted into the field.
• Edit variables: Click the edit icon to modify variable properties.
• Delete variables: Click the delete icon to remove the variable.

​

Creating Variables

​

From Input Blocks

1. Add an user block (Text Input, Email, Buttons, etc.)
2. Open the block settings
3. Select “Save answer in a variable”
4. Choose an existing variable or type a new name to create one
5. User responses will automatically be stored in the variable

​

From Variables Panel

1. Open Variables tab in the Flow editor sidebar
2. Type a new variable name in the search box
3. Click “Create variable” when prompted
4. Configure variable properties in the edit modal

​

Using Set Variable Block

1. Drag a Set Variable block onto the canvas
2. Choose or create a variable to modify
3. Select the value type:
   • Custom: Text or JavaScript expressions
   • System variables: Access built-in system values
   • List operations: Append, pop, or manipulate arrays
   • Data mapping: Transform data from other variables

​

System Variables

​

Available System Variables

​

Date and Time

• {{system_today}}: Current date (YYYY-MM-DD format)
• {{system_now}}: Current date and time (ISO 8601 format)
• {{system_yesterday}}: Previous day’s date
• {{system_tomorrow}}: Next day’s date
• {{system_momentOfTheDay}}: Time-based greeting value: morning, afternoon, evening, or night

Today's date is {{system_today}}
Current timestamp: {{system_now}}

​

Session Information

• {{system_randomId}}: Unique random identifier (CUID algorithm)
• {{Conversation}}: Complete conversation transcript including all messages exchanged

Session ID: {{system_randomId}}

​

Environment Context

• {{system_platform}}: Platform identifier (web or whatsapp)
• {{system_device}}: Device type (mobile or desktop)

You're using QuickBot on {{system_platform}}

​

WhatsApp-Specific Variables

• {{system_whatsapp_number}}: User’s WhatsApp phone number
• {{system_whatsapp_name}}: User’s WhatsApp contact name

Hello {{system_whatsapp_name}}, your number is {{system_whatsapp_number}}

​

Using System Variables

Good {{system_momentOfTheDay}}, welcome to our bot!

{{Conversation}}

{{=new Date({{system_now}}).toLocaleDateString()=}}

If {{system_platform}} equals "whatsapp"

​

System Variable Characteristics

• Read-only: System variables are automatically populated and cannot be manually modified
• Always available: No need to create or initialize them
• Real-time: Values are computed at runtime based on the current context
• Not saved in results: Most system variables are not persisted in the results table by default
• No initialization required: Ready to use immediately without any setup

​

Using Variables in Your Bot

​

Basic Variable Syntax

{{varName}}

​

Inline Variable Formatting

{{={{varName}}.toUpperCase()=}}

• Uppercase: {{={{Name}}.toUpperCase()=}}
• Lowercase: {{={{Name}}.toLowerCase()=}}
• First item of list: {{={{Items}}[0]=}} or {{={{Items}}.at(0)=}}
• Last item of list: {{={{Items}}.at(-1)=}}
• List length: {{={{Items}}.length=}}
• Date formatting: {{=new Date({{Date}}).toLocaleDateString()=}}

​

Variable Types and Operations

• String: Single text values
• Array: Lists of text values
• Mixed: Automatically converted to string representation

​

Variable Properties

​

Save in Results

• Enabled: Variable values appear as columns in results
• Disabled: Variables are used internally but not exported
• Use case: Enable for important data, disable for temporary calculations

​

Secret Variables

• Secret variables are not saved in results
• Cannot be exported or viewed in the results panel
• Ideal for: API keys, personal data, temporary tokens
• Visual indicator: Lock icon appears next to secret variables

​

Advanced Variable Concepts

​

Prefilled Variables

https://quick.bot/my-bot?Email=john@gmail.com&First%20name=John

QuickBot.initBubble({
  botId: 'your-bot-id',
  prefilledVariables: {
    Email: 'john@gmail.com',
    'First Name': 'John',
    'User ID': '12345',
  },
})

​

Save variables in results

• Marketing: UTM parameters, campaign IDs
• User context: Session IDs, referrer information
• System data: Timestamps, environment variables
• Analytics: Custom event tracking, user segments

• Track marketing campaign effectiveness
• Store user authentication data
• Maintain session context across conversations
• Collect analytics without user input

​

Variable Validation and Types

// ✅ Recommended
'Hello World'[('option1', 'option2')] // String // String array
;('123') // Number as string
;('true') // Boolean as string

// These are automatically converted
123 → '123'
true → 'true'
{ name: 'John' } → '{"name":"John"}'

// Store complex objects as JSON strings
Use: {{=JSON.stringify({name: 'John', age: 30})=}}

// Parse back to objects when needed
Use: {{=JSON.parse({{User Data}}).name=}}

​

Variable Best Practices

​

Naming Conventions

• Use descriptive names: “User Email” instead of “email”
• Be consistent: Use the same case style throughout
• Avoid special characters: Stick to letters, numbers, and spaces
• Group related variables: “Address Line 1”, “Address Line 2”

​

Organization

• Delete unused variables to keep your bot clean
• Use secret variables for sensitive data
• Enable “Save in Results” only for variables you need to export
• Group variables logically in your variable names

​

Performance

• Avoid deeply nested objects in variables
• Use arrays efficiently with proper indexing
• Clean up temporary variables when no longer needed
• Test variable transformations to ensure correct output

​

Troubleshooting Variables

​

Common Issues

• Check variable name spelling and case
• Ensure variable has been created and assigned a value
• Verify variable syntax: {{varName}}

• Test JavaScript expressions in Set Variable block first
• Check for typos in transformation code
• Ensure proper escape characters for special content

• Enable “Save in Results” in variable properties
• Check that variable isn’t marked as secret
• Verify variable has collected values from users