Skip to main content

Set variables

The Set variables action creates or modifies variables during a conversation. Use variables to store information, track state, and personalize responses.

How to set a variable​

  1. Open your dialog in the editor
  2. Add a Set variables action to your flow
  3. Enter the variable name (key)
  4. Set the value (text, number, or reference to another variable)
  5. Save your changes
Set variable example

Variable types​

TypeExampleUse case
Text"premium"User preferences, status flags
Number42Counters, quantities, scores
BooleantrueFeature flags, confirmation states
Reference{{$user.email}}Copy value from another variable

Common use cases​

Track conversation state​

variable: $step_completed
value: "payment"

Store user preferences​

variable: $preferred_language
value: "Spanish"

Copy from user context​

variable: $customer_email
value: {{$user.email}}

Best practices​

  • Use descriptive names - Choose clear names like order_total instead of val1
  • Keep scope in mind - Variables persist for the entire conversation
  • Initialize values - Set default values to avoid undefined references
  • Document your variables - Maintain a list of variables used in your dialogs

Accessing variables​

After setting a variable, access it in:

  • Text responses: Hello, {{$customer_name}}!
  • Conditions: Check if $customer_tier equals "premium"
  • Webhooks: Include variables in request payloads
  • URL responses: https://example.com?user={{$user.user_id}}

Next steps​