Expressions

Where you write expressions#

An expression is a one-line formula, like in a spreadsheet. You write them in:

• Set variables: each row's value, for example trim(@full_name).
• Switch: the value to route on, and Condition cases such as value > 100.
• Filter: Expression conditions, which must be true or false.

The editor checks what you type as you go. Looks good means it can be read; otherwise it says what's wrong and at which character.

The building blocks#

The text forms {{@city}} and {{#order.id}} work too, so you can paste a variable from a message.

Operators#

Functions can also be written after a value: @city.lower() is the same as lower(@city).

Test an expression#

1. 1

   Open the test

   Under the expression, click Test expression.

2. 2

   Add sample values

   In Sample variables, write one per line: @age = 31, #tour = {"name": "Jaffa"}. If the expression reads fine, click Add the variables this expression uses to list them for you.

3. 3

   Pin the time (optional)

   For date functions, add a line like now = 2026-10-16T09:00+03:00. Include your time-zone offset: without it the time is read as UTC.

4. 4

   Run it

   Click Run. The Result shows the value and its type: text, number, true / false, date, list or object. In a Switch condition, also fill in Switch value to test with.

Tests never send messages or alerts, so try as many values as you like, including empty and wrong answers.

Functions: Text#

Click Functions under any expression to see this list and insert a function at the cursor.

Functions: Convert#

Functions: Numbers#

Functions: Empty values#

Functions: Lists and objects#

In these examples #items is [{"sku": "TSHIRT-M", "qty": 2}, {"sku": "CAP", "qty": 1}] and #tours is [{"name": "Jaffa", "price": 80}, {"name": "Galilee", "price": 150}].

In filter() and map(), item is the current item and index its position (from 0). They chain: #tours.filter(item.price > 100).map(item.name) gives ["Galilee"]. byLang() falls back to the second language (default EN) when a version is missing or empty.

Functions: Dates and holidays#

Dates use Israel time (Asia/Jerusalem) unless you pass a time zone. Date answers such as 13/10/2026 work directly in date functions. A date shows as DD/MM/YYYY HH:mm, or DD/MM/YYYY at midnight.

Opening hours for isOpenAt and isOpenNow are an object by day: {"Sunday": "09:00 - 18:00", "Thursday": "09:00-13:00, 16:00-20:00", "Saturday": "closed"}. Use English or Hebrew day names; several ranges with commas; a range past midnight like "20:00 - 02:00" works; a missing day is closed.

Date formats use DD, MM, YYYY, YY, HH, mm and ss in any order with any separators.

Example#

A restaurant decides how to answer a booking request. In a Filter Expression condition:

!isIsraeliHoliday(parseDate(@visit_date)) && dayOfWeek(parseDate(@visit_date)) != 7 && number(@guests) <= 12

Test it with @visit_date = 16/10/2026 and @guests = 4: the result is true, so the customer goes to the booking path. With @guests = 20 it's false, and they're offered a call with the manager instead.

Common mistakes#

When an expression fails while a customer is chatting, the bot doesn't stop: Set variables leaves the value empty, Filter treats the condition as false, and Switch follows Default. You get an alert so you can fix it.