Rumus
Hitung total atau diskon dan pilih jawaban sesuai syarat. Ketahui kapan memakai rumus dalam pesan dan kapan memakai tindakan Perhitungan.
Di halaman ini
Rumus membantu bot menghitung dan memilih nilai. Misalnya, jika harga 500 dan jumlah barang 3, {{= price * qty}} menghasilkan 1500. Simpan nilai price dan qty lebih dahulu pada parameter pelanggan atau data sementara reaksi.
Untuk hitungan sederhana, tulis rumus langsung di pesan. Untuk daftar, tanggal, atau fungsi dengan nama Rusia, gunakan tindakan Perhitungan. GetMyBot memiliki dua bahasa rumus dengan aturan penulisan berbeda:
- Ekspresi: untuk hitungan, perbandingan, dan teks sederhana. Dipakai dalam
{{= ekspresi}}pada pesan, mode Rumus pada tindakan Perhitungan, dan syarat dalam tabel keputusan. - Rumus lanjutan: mirip rumus spreadsheet, mendukung daftar, JSON, tanggal, hash,
LAMBDA, dan nama fungsi Rusia. Dipakai dalam mode Rumus lanjutan, pemeriksaan jawaban berdasarkan rumus, dan alat uji rumus.
Tempat rumus dapat dipakai
| Tempat | Bahasa rumus |
|---|---|
{{= ekspresi}} di dalam pesan | Ekspresi. |
Perhitungan, mode Rumus (expr) | Ekspresi. |
Perhitungan, mode Tabel keputusan (rules) | Ekspresi untuk syarat jika; hasil maka dan nilai bawaan berupa teks biasa dengan {{...}}. |
Perhitungan, mode Rumus lanjutan (formula) | Rumus lanjutan. |
| Pemeriksaan jawaban Sesuai rumus | Rumus lanjutan. |
Uji rumus (test_formula) | Rumus lanjutan. |
Tindakan Perhitungan
Pilih tepat satu dari tiga mode:
- Rumus (
expr): satu ekspresi. - Tabel keputusan (
rules+default): daftar aturan jika → maka. Hasil aturan pertama yang syaratnya benar digunakan; jika tidak ada, nilai bawaan digunakan. - Rumus lanjutan (
formula): rumus dengan bahasa lengkap.
Pilih tempat menyimpan hasil: data sementara reaksi (ctx, kolom save_to_ctx) atau parameter pada profil pelanggan (save_to_param). Anda dapat memilih keduanya, tetapi setidaknya satu harus diisi. Hasil dengan kunci discount dalam ctx dapat digunakan sebagai {{ctx.discount}}.
Panjang ekspresi, syarat, dan hasil aturan dibatasi 4.096 byte; rumus lanjutan 16.384 byte; jumlah aturan paling banyak 64. Batas dihitung dalam byte, sehingga satu huruf Rusia biasanya memakai dua byte.
Contoh tindakan dengan rumus lanjutan:
{"type":"compute","params":{"formula":"IF({total} > 1000; \"grosir\"; \"eceran\")","save_to_ctx":"segment"}}
Ekspresi
Cara menulis ekspresi
- Operator: hitungan
+ - * / %, perbandingan== != < > <= >=, logika&& || !, pilihansyarat ? ya : tidak, serta tanda kurung( ). - Nilai tetap: angka (
42,3.14), teks ("halo"atau'halo'), dantrueataufalse. - Data: tulis nama tanpa kurung kurawal. GetMyBot mencarinya di parameter pelanggan dan
ctx, misalnyaprice * qty,ctx.total, atauparam.total. Nama yang tidak ada menghasilkan teks kosong. - Fungsi: tulis
nama(argumen1, argumen2)dengan koma di antara argumen.
Fungsi ekspresi
Hanya fungsi berikut yang tersedia, dan namanya harus memakai huruf kecil: len, upper, lower, trim, concat, round, floor, ceil, abs, min, max. min dan max menerima tepat dua argumen; concat menerima berapa pun. len dan LEN pada rumus lanjutan menghitung karakter sebagaimana terlihat oleh pembaca. Misalnya, huruf dengan tanda aksen atau emoji keluarga 👨👩👧👦 dihitung sebagai satu karakter.
Ekspresi tidak memiliki nama fungsi Rusia. Jika {{= }} berisi fungsi yang tidak dikenal, rumus tetap terlihat di teks tanpa dihitung.
Rumus lanjutan
Cara menulis rumus lanjutan
- Pisahkan argumen dengan titik koma:
IF({total} > 1000; "grosir"; "eceran"). - Operator: hitungan
+ - * /, gabungan teks&, dan perbandingan= != <> < > <= >=. Tanda sama dengan hanya satu=. Gunakan fungsiAND,OR, danNOTuntuk logika. - Teks dapat memakai tanda kutip tunggal atau ganda. Dua tanda kutip ganda berturut-turut tidak menyisipkan tanda kutip. Jika teks membutuhkan tanda kutip di dalamnya, gunakan jenis tanda kutip lainnya, misalnya
"<a href='tg://user?id=" & r.user_id & "'>profil</a>". - Data memakai satu pasang kurung kurawal:
{kunci}mengambil data darictx;{text}atau{answer}mengambil pesan masuk;{user:kunci}mengambil parameter pelanggan;{global:kunci}mengambil parameter global bot. LAMBDA(r; ekspresi)menjelaskan cara memproses setiap anggota daftar untukFILTER,FOREACH,ARRAYFIND, danREDUCE. Kolom objek JSON dibaca melalui titik, misalnyar.user_id.- Hasil rumus diubah menjadi teks. Untuk menyimpan daftar, gunakan
TOJSON, lalu baca kembali dalam rumus berikutnya denganFROMJSON. - Nama fungsi tidak membedakan huruf besar dan kecil serta mendukung nama Rusia yang tercantum di bawah.
Fungsi rumus lanjutan
Nama utama fungsi menggunakan bahasa Inggris. Nama Rusia dalam tanda kurung juga dapat digunakan. Fungsi ini hanya tersedia dalam rumus lanjutan.
Matematika
SUM (СУММ), AVERAGE (СРЗНАЧ), MAX (МАКС), MIN (МИН), MOD (ОСТАТ), POW (СТЕПЕНЬ), SQRT (КОРЕНЬ), PI (ПИ), ROUND (ОКРУГЛ), CEIL (ОКРВВЕРХ), FLOOR (ОКРВНИЗ), TRUNC (ОТБР), ABS, RANDBETWEEN (СЛУЧМЕЖДУ).
Teks
LEN (ДЛСТР), LEFT (ЛЕВСИМВ), RIGHT (ПРАВСИМВ), MID (ПСТР), LOWER (СТРОЧН), UPPER (ПРОПИСН), UPPERFIRST (ПРОПИСНПЕРВ), REPEAT (ПОВТОР), CONCAT (СЦЕПИТЬ), SUBSTITUTE (ПОДСТАВИТЬ), FIND (НАЙТИ), SEARCH (ПОИСК), FIELD (ПОЛЕ), TRIM, LTRIM, RTRIM, PADLEFT, PADRIGHT, SPLIT, JOIN, STARTSWITH, ENDSWITH, CONTAINS, NL.
Logika
IF (ЕСЛИ), AND (И), OR (ИЛИ), NOT (НЕ), EMPTY, ISNUMBER (ЕЧИСЛО), COALESCE.
Daftar
SORT, RSORT, UNIQUE, FILTER, FOREACH, REDUCE, INDEX, SLICE, COUNTA (СЧЁТЗ), COUNTUNIQUE, ARRAYADD, ARRAYREMOVE, ARRAYREPLACE, ARRAYFIND, PAIRUP (СОСТАВИТЬПАРЫ).
PAIRUP(items; idField; seed [; tagsField]) membagi peserta ke dalam pasangan untuk acara perkenalan. Jika jumlah peserta ganjil, satu grup berisi tiga orang. Fungsi berusaha memisahkan peserta dengan tag yang sama, baik tag berupa teks "|a|b|" maupun daftar. Dengan seed dan data masukan yang sama, hasilnya tetap sama. Batasnya 10.000 peserta dan 64 tag per peserta. Jika banyak peserta memiliki tag yang sama, pemisahan sempurna mungkin tidak tercapai, tetapi semua peserta tetap masuk grup. Tindakan Cari data membaca hingga 10.000 baris sekali jalan; hasil rumus lanjutan dibatasi 4 MB.
Tanggal dan waktu
TODAY (СЕГОДНЯ), NOW (ТДАТА), DATEADD, DATESUB, DATEDIF (РАЗНДАТ), DATEFORMAT, DATEVALUE, WEEKDAY (ДЕНЬНЕД).
JSON
TOJSON, FROMJSON, JSONPATH, JP, JSONOBJECT, JSONARRAY, KEYS, VALUES.
Kriptografi dan pengodean
HASH (ХЭШ), TOBASE64, FROMBASE64, FROMJWT, FROMJWK.
Parameter
PARAMID, PARAMREPLACE, PARAMREMOVE.
Contoh
Ekspresi dalam pesan:
- Total pesanan:
{{= price * qty}}. - Sepertiga total, dibulatkan:
{{= round(total / 3)}}. - Pilihan menurut jumlah:
{{= param.total > 1000 ? "grosir" : "eceran"}}. - Menggabungkan teks:
{{= concat("Pesanan No. ", ctx.order_id)}}.
Rumus lanjutan dalam tindakan Perhitungan:
- Diskon 10%:
ОКРУГЛ({user:total} * 0.9). - Jumlah anggota daftar dari
ctx:СЧЁТЗ(FROMJSON({items})). - Urutan acak yang tetap untuk baris yang disimpan tindakan Cari data sebagai
rowsdictx. Hasil tetap sama sampai nilaisaltdiubah:
{"type":"compute","params":{"formula":"TOJSON(SORT(FOREACH(FROMJSON({rows}); LAMBDA(r; HASH(\"sha256\"; r.user_id & \"-salt\") & \"|\" & r.user_id))))","save_to_ctx":"order"}}
Untuk pemeriksaan jawaban Sesuai rumus, rumus menghasilkan teks kesalahan jika jawaban salah, atau hasil kosong jika diterima. Contoh: IF(ISNUMBER({answer}); ""; "Masukkan angka").
Menguji rumus
Alat uji hanya memeriksa rumus lanjutan dan menampilkan hasil atau kesalahan penulisannya. Alat ini tidak menyimpan perubahan:
- Di editor, masukkan contoh pada kolom Contoh jawaban dalam pemeriksaan Sesuai rumus, lalu klik Periksa.
- Melalui API, kirim
POST /api/bots/{botID}/reactions/test-formuladengan{"formula": "…", "sample_text": "…"}. - Melalui MCP, gunakan
test_formuladenganbot_id,formula, dansample.
Respons berisi ok (rumus berhasil dihitung), result, error, dan matches. Nilai matches adalah true jika hasil kosong, artinya jawaban akan lolos pemeriksaan.
Pengujian memakai konteks kosong. ctx, parameter pelanggan, dan parameter global tidak tersedia; {kunci} dan {user:kunci} menjadi teks kosong. Hanya contoh pesan yang tersedia melalui {text}, {answer}, atau {received_message}. Ekspresi {{= }}, mode Rumus, dan tabel keputusan tidak dapat diuji melalui alat ini.
Langkah berikutnya
- Variabel dan rumus:
{{...}},ctx, dan parameter. - Tindakan: tindakan Perhitungan dan tabel keputusan.
- Pesan dan tombol: rumus dalam pesan dan pemeriksaan jawaban.
- Koleksi dan data: sumber data untuk rumus.
- Batas platform: batas panjang rumus dan jumlah aturan.