Công thức
Tính tổng, giảm giá hoặc chọn câu trả lời theo điều kiện. Khi nào viết công thức trong tin nhắn, khi nào dùng hành động Tính toán.
Trên trang này
Công thức giúp bot tính toán và chọn giá trị. Ví dụ, nếu giá là 500, số lượng là 3, {{= price * qty}} cho kết quả 1500. Trước đó, bạn cần lưu price và qty vào tham số khách hàng hoặc dữ liệu tạm của phản ứng.
Với phép tính đơn giản, viết biểu thức ngay trong tin nhắn. Để xử lý danh sách, ngày hoặc hàm có tên tiếng Nga, dùng hành động Tính toán. GetMyBot có hai ngôn ngữ công thức khác cú pháp:
- Biểu thức: ngôn ngữ ngắn cho số học, so sánh và văn bản đơn giản. Dùng trong
{{= expression}}của tin nhắn, chế độ Công thức của hành động Tính toán và điều kiện của bảng quyết định. - Công thức mở rộng: gần với bảng tính, hỗ trợ danh sách, JSON, ngày, hàm băm,
LAMBDAvà tên hàm tiếng Nga. Dùng trong chế độ Công thức mở rộng của hành động Tính toán, kiểm tra câu trả lời bằng công thức và bộ thử công thức.
Công thức hoạt động ở đâu
| Vị trí | Ngôn ngữ |
|---|---|
{{= expression}} trong tin nhắn | Biểu thức |
Tính toán, chế độ Công thức (expr) | Biểu thức |
Tính toán, chế độ Bảng quyết định (rules) | Biểu thức trong điều kiện “khi”; “thì” và giá trị mặc định là văn bản thường có biến thay thế {{...}} |
Tính toán, chế độ Công thức mở rộng (formula) | Công thức mở rộng |
| Kiểm tra câu trả lời Khớp công thức | Công thức mở rộng |
Bộ thử công thức (test_formula) | Công thức mở rộng |
Hành động Tính toán
Mỗi hành động chọn đúng một trong ba chế độ:
- Công thức (
expr): một biểu thức. - Bảng quyết định (
rules+default): danh sách quy tắc “khi → thì”. Giá trị của quy tắc đúng đầu tiên được trả về; nếu không có, dùng giá trị mặc định. - Công thức mở rộng (
formula): công thức bằng ngôn ngữ đầy đủ.
Chọn nơi lưu kết quả: dữ liệu tạm của phản ứng ctx (Lưu vào ctx, save_to_ctx) hoặc hồ sơ khách hàng (Lưu vào tham số, save_to_param). Có thể chọn cả hai nhưng phải chọn ít nhất một. Nếu lưu vào ctx dưới khóa discount, dùng {{ctx.discount}} để chèn kết quả.
Giới hạn: biểu thức, điều kiện và giá trị quy tắc tối đa 4.096 byte; công thức mở rộng tối đa 16.384 byte; bảng quyết định tối đa 64 quy tắc. Kích thước tính bằng byte, nên một chữ Cyrillic chiếm 2 byte.
Ví dụ cấu hình hành động với công thức mở rộng:
{"type":"compute","params":{"formula":"IF({total} > 1000; \"sỉ\"; \"lẻ\")","save_to_ctx":"segment"}}
Biểu thức
Cú pháp
- Toán tử: số học
+ - * / %, so sánh== != < > <= >=, logic&& || !, chọn theo điều kiệncondition ? yes : no, dấu ngoặc( ). - Giá trị viết trực tiếp: số (
42,3.14), văn bản trong dấu nháy đôi hoặc đơn, logic (true,false). - Dữ liệu: viết tên không có ngoặc nhọn, lấy từ tham số người đăng ký hoặc
ctx:price * qty,ctx.total,param.total. Tên không biết cho chuỗi rỗng. - Gọi hàm:
name(arg1, arg2), các đối số cách nhau bằng dấu phẩy.
Hàm
Biểu thức chỉ có các hàm viết chữ thường sau: len, upper, lower, trim, concat, round, floor, ceil, abs, min, max. min và max nhận đúng hai đối số; concat nhận số lượng bất kỳ. len đếm ký tự theo cách người đọc nhìn thấy: chữ có dấu, cờ hoặc emoji ghép như gia đình 👨👩👧👦 đều là một ký tự.
Biểu thức không có tên hàm tiếng Nga. Nếu {{= }} chứa hàm không biết, toàn bộ cấu trúc sẽ còn nguyên trong tin nhắn.
Công thức mở rộng
Cú pháp công thức mở rộng
- Đối số cách nhau bằng dấu chấm phẩy:
IF({total} > 1000; "sỉ"; "lẻ"). - Toán tử: số học
+ - * /, nối chuỗi&, so sánh= != <> < > <= >=(so sánh bằng chỉ dùng một dấu=). Logic dùng hàmAND,OR,NOT. - Chuỗi dùng dấu nháy đôi hoặc đơn. Hai dấu
""trong chuỗi không biểu thị dấu nháy. Nếu cần dấu nháy trong văn bản, dùng hai loại nháy khác nhau, chẳng hạn"<a href='tg://user?id=" & r.user_id & "'>hồ sơ</a>". - Dữ liệu nằm trong một cặp ngoặc nhọn:
{key}lấy từctx;{text}hoặc{answer}là tin nhận được;{user:key}là tham số người đăng ký;{global:key}là tham số chung của bot. - LAMBDA:
LAMBDA(r; expression)mô tả cách xử lý từng phần tử choFILTER,FOREACH,ARRAYFIND,REDUCE. Đọc trường JSON bằng dấu chấm nhưr.user_id. - Kết quả được chuyển thành văn bản. Để giữ danh sách, dùng
TOJSON, rồi dùngFROMJSONtrong công thức sau. - Tên hàm không phân biệt chữ hoa/thường và có tên tương đương tiếng Nga.
Hàm của công thức mở rộng
Danh sách dưới đây dùng tên tiếng Anh chuẩn. Một số hàm có tên tiếng Nga tương đương, như SUM (СУММ), ROUND (ОКРУГЛ), IF (ЕСЛИ), LEN (ДЛСТР).
Toán học
SUM (СУММ), AVERAGE (СРЗНАЧ), MAX (МАКС), MIN (МИН), MOD (ОСТАТ), POW (СТЕПЕНЬ), SQRT (КОРЕНЬ), PI (ПИ), ROUND (ОКРУГЛ), CEIL (ОКРВВЕРХ), FLOOR (ОКРВНИЗ), TRUNC (ОТБР), ABS, RANDBETWEEN (СЛУЧМЕЖДУ).
Văn bản
LEN (ДЛСТР), LEFT (ЛЕВСИМВ), RIGHT (ПРАВСИМВ), MID (ПСТР), LOWER (СТРОЧН), UPPER (ПРОПИСН), UPPERFIRST (ПРОПИСНПЕРВ), REPEAT (ПОВТОР), CONCAT (СЦЕПИТЬ), SUBSTITUTE (ПОДСТАВИТЬ), FIND (НАЙТИ), SEARCH (ПОИСК), FIELD (ПОЛЕ), TRIM, LTRIM, RTRIM, PADLEFT, PADRIGHT, SPLIT, JOIN, STARTSWITH, ENDSWITH, CONTAINS, NL.
Logic
IF (ЕСЛИ), AND (И), OR (ИЛИ), NOT (НЕ), EMPTY, ISNUMBER (ЕЧИСЛО), COALESCE.
Danh sách
SORT, RSORT, UNIQUE, FILTER, FOREACH, REDUCE, INDEX, SLICE, COUNTA (СЧЁТЗ), COUNTUNIQUE, ARRAYADD, ARRAYREMOVE, ARRAYREPLACE, ARRAYFIND, PAIRUP (СОСТАВИТЬПАРЫ).
PAIRUP(items; idField; seed [; tagsField]) ghép người tham gia thành cặp cho hoạt động “random coffee”. Nếu số người lẻ, một nhóm có ba người. Hàm cố tách những người có cùng nhãn, nhập dưới dạng chuỗi "|a|b|" hoặc mảng, sang các nhóm khác nhau. Cùng seed và dữ liệu đầu vào cho cùng kết quả. Giới hạn: tối đa 10.000 người và 64 nhãn mỗi người (xem Giới hạn nền tảng). Với danh sách lớn có nhiều nhãn trùng, không phải lúc nào cũng tránh được mọi cặp trùng nhãn, nhưng tất cả người vẫn được xếp nhóm. Hành động Tìm bản ghi đọc tối đa 10.000 dòng mỗi lần; kết quả công thức mở rộng tối đa 4 MB.
Ngày và giờ
TODAY (СЕГОДНЯ), NOW (ТДАТА), DATEADD, DATESUB, DATEDIF (РАЗНДАТ), DATEFORMAT, DATEVALUE, WEEKDAY (ДЕНЬНЕД).
JSON
TOJSON, FROMJSON, JSONPATH, JP, JSONOBJECT, JSONARRAY, KEYS, VALUES.
Mật mã và mã hóa
HASH, TOBASE64, FROMBASE64, FROMJWT, FROMJWK.
Tham số
PARAMID, PARAMREPLACE, PARAMREMOVE.
Ví dụ
Biểu thức trong tin nhắn:
- Tổng đơn hàng:
{{= price * qty}}. - Một phần ba tổng, làm tròn:
{{= round(total / 3)}}. - Chọn theo điều kiện:
{{= param.total > 1000 ? "sỉ" : "lẻ"}}. - Nối văn bản:
{{= concat("Đơn hàng №", ctx.order_id)}}.
Công thức mở rộng trong hành động Tính toán:
- Giảm giá 10%:
ОКРУГЛ({user:total} * 0.9). - Số phần tử của danh sách trong
ctx:СЧЁТЗ(FROMJSON({items})). - Sắp xếp bản ghi theo một thứ tự giả ngẫu nhiên nhưng ổn định. Hành động Tìm bản ghi đã lưu danh sách vào
ctx.rows; thứ tự chỉ đổi khi “salt” đổi:
{"type":"compute","params":{"formula":"TOJSON(SORT(FOREACH(FROMJSON({rows}); LAMBDA(r; HASH(\"sha256\"; r.user_id & \"-salt\") & \"|\" & r.user_id))))","save_to_ctx":"order"}}
Khi kiểm tra câu trả lời bằng công thức, chuỗi rỗng nghĩa là câu trả lời được chấp nhận; văn bản khác là lỗi hiển thị cho người dùng. Ví dụ: IF(ISNUMBER({answer}); ""; "Vui lòng nhập số").
Kiểm tra công thức
Bộ thử chỉ kiểm tra công thức mở rộng và trả kết quả hoặc lỗi cú pháp mà không lưu dữ liệu:
- Trong trình chỉnh sửa, ở phần Khớp công thức để kiểm tra câu trả lời, nhập Câu trả lời mẫu rồi nhấn Kiểm tra.
- Qua API:
POST /api/bots/{botID}/reactions/test-formulavới{"formula":"…","sample_text":"…"}. - Qua MCP: công cụ
test_formulavớibot_id,formula,sample.
Câu trả lời gồm ok (đã tính được), result, error và matches (true nếu kết quả rỗng, nghĩa là câu trả lời mẫu đạt).
Công thức được tính trong ngữ cảnh rỗng: ctx, tham số người đăng ký và tham số chung đều rỗng, nên {key} và {user:key} cho chuỗi rỗng. Chỉ có văn bản mẫu qua {text}, {answer} hoặc {received_message}. Bộ thử không kiểm tra biểu thức {{= }}, chế độ Công thức hoặc bảng quyết định.
Bước tiếp theo
- Thay thế và công thức — biến
{{...}}, ngữ cảnhctxvà tham số. - Hành động — hành động «Tính toán» và bảng quyết định.
- Tin nhắn và nút — công thức trong văn bản và template nút.
- Bộ sưu tập và dữ liệu — dữ liệu để áp dụng công thức.
- Giới hạn nền tảng: kích thước công thức và bảng quyết định.