Basis pengetahuan GetMyBot

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

TempatBahasa rumus
{{= ekspresi}} di dalam pesanEkspresi.
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 rumusRumus 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 && || !, pilihan syarat ? ya : tidak, serta tanda kurung ( ).
  • Nilai tetap: angka (42, 3.14), teks ("halo" atau 'halo'), dan true atau false.
  • Data: tulis nama tanpa kurung kurawal. GetMyBot mencarinya di parameter pelanggan dan ctx, misalnya price * qty, ctx.total, atau param.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 fungsi AND, OR, dan NOT untuk 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 dari ctx; {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 untuk FILTER, FOREACH, ARRAYFIND, dan REDUCE. Kolom objek JSON dibaca melalui titik, misalnya r.user_id.
  • Hasil rumus diubah menjadi teks. Untuk menyimpan daftar, gunakan TOJSON, lalu baca kembali dalam rumus berikutnya dengan FROMJSON.
  • 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 rows di ctx. Hasil tetap sama sampai nilai salt diubah:
{"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-formula dengan {"formula": "…", "sample_text": "…"}.
  • Melalui MCP, gunakan test_formula dengan bot_id, formula, dan sample.

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