Formules
Calculer un montant ou une remise et choisir une réponse : expression dans un texte ou action Calcul pour les formules avancées.
Sur cette page
Les formules permettent au bot de calculer ou de choisir une valeur. Si price vaut 500 et qty vaut 3, {{= price * qty}} donne 1500. Enregistrez d’abord ces valeurs dans les paramètres du client ou les données temporaires de la réaction.
Pour un calcul simple, écrivez l’expression dans le message. Pour traiter des listes, dates ou fonctions aux noms russes, utilisez l’action Calcul. GetMyBot possède deux langages de formule aux syntaxes différentes :
- Expressions : langage court pour l’arithmétique, les comparaisons et les chaînes simples. Il fonctionne dans
{{= expression}}dans le texte, dans le mode Formule de l’action Calcul et dans les conditions d’un tableau de décision. - Formule avancée : proche d’un tableur, elle traite listes, JSON, dates, empreintes de texte,
LAMBDAet noms russes de fonctions. Elle fonctionne dans le mode Formule avancée de Calcul, dans la vérification des réponses par formule et dans le testeur.
Où les formules fonctionnent
| Emplacement | Langage |
|---|---|
{{= expression}} dans un message | Expressions |
Calcul, mode Formule (expr) | Expressions |
Calcul, mode Tableau de décision (rules) | Expressions dans les conditions « quand » ; les valeurs « alors » et par défaut sont du texte avec substitutions {{...}} |
Calcul, mode Formule avancée (formula) | Formule avancée |
| Vérification de réponse Correspond à une formule | Formule avancée |
Testeur test_formula | Formule avancée |
Action Calcul
Choisissez un seul des trois modes de l’action :
- Formule (
expr) : une expression. - Tableau de décision (
rulesetdefault) : règles « quand → alors ». La première condition vraie fournit sa valeur, sinon la valeur par défaut. - Formule avancée (
formula) : expression dans le langage complet.
Indiquez où conserver le résultat : dans les données temporaires de la réaction, ctx (champ Enregistrer dans ctx, save_to_ctx), ou dans la fiche client (champ Enregistrer dans un paramètre, save_to_param). Les deux sont possibles, mais au moins l’un est obligatoire. La valeur discount conservée dans ctx s’insère ensuite par {{ctx.discount}}.
Limites : expression, condition ou valeur de règle jusqu’à 4 096 octets ; formule avancée jusqu’à 16 384 octets ; au plus 64 règles. Ce sont des octets : une lettre cyrillique en prend deux.
Exemple avec une formule avancée :
{"type":"compute","params":{"formula":"IF({total} > 1000; \"grossiste\"; \"détail\")","save_to_ctx":"segment"}}
Expressions
Syntaxe
- Opérateurs :
+ - * / %, comparaisons== != < > <= >=, logique&& || !, conditioncondition ? oui : nonet parenthèses. - Valeurs littérales : nombres
42ou3.14, chaînes"bonjour"ou'bonjour', booléenstrueetfalse. - Données : nom sans accolades, recherché dans les paramètres de l’abonné et
ctx, par exempleprice * qty,ctx.totalouparam.total. Un nom inconnu donne une chaîne vide. - Fonction :
nom(argument1, argument2), arguments séparés par des virgules.
Fonctions
Seules ces fonctions sont disponibles, en minuscules : len, upper, lower, trim, concat, round, floor, ceil, abs, min, max. min et max prennent exactement deux arguments ; concat peut en prendre autant que nécessaire. len et le LEN du langage avancé comptent les caractères visibles : une lettre accentuée composée, un drapeau ou l’emoji familial 👨👩👧👦 compte pour un caractère.
Il n’y a pas d’alias russe dans les expressions. Une fonction inconnue dans {{= }} laisse la construction inchangée dans le texte.
Formule avancée
Syntaxe
- Les arguments sont séparés par un point-virgule :
IF({total} > 1000; "grossiste"; "détail"). - Opérateurs :
+ - * /, concaténation&, comparaisons= != <> < > <= >=; l’égalité utilise un seul=. La logique passe parAND,ORetNOT. - Les chaînes sont entre guillemets doubles ou simples.
""ne représente pas un guillemet intérieur. Pour inclure des guillemets dans du texte, comme un attribut HTML, choisissez l’autre sorte :"<a href='tg://user?id=" & r.user_id & "'>profil</a>". - Les données utilisent une paire d’accolades :
{clé}litctx,{text}ou{answer}le message reçu,{user:clé}un paramètre d’abonné,{global:clé}un paramètre global du bot. - LAMBDA :
LAMBDA(r; expression)définit le calcul appliqué à chaque élément d’une liste parFILTER,FOREACH,ARRAYFINDouREDUCE. Les champs JSON se lisent avec un point :r.user_id. - Le résultat devient du texte. Pour conserver une liste, utilisez
TOJSON; dans la formule suivante, relisez-la avecFROMJSON. - Les noms de fonctions ignorent la casse et reconnaissent les alias russes.
Fonctions disponibles
Les noms ci-dessous sont canoniques et anglais ; l’alias russe figure entre parenthèses lorsqu’il existe. Ces fonctions appartiennent uniquement au langage avancé.
Mathématiques
SUM (СУММ), AVERAGE (СРЗНАЧ), MAX (МАКС), MIN (МИН), MOD (ОСТАТ), POW (СТЕПЕНЬ), SQRT (КОРЕНЬ), PI (ПИ), ROUND (ОКРУГЛ), CEIL (ОКРВВЕРХ), FLOOR (ОКРВНИЗ), TRUNC (ОТБР), ABS, RANDBETWEEN (СЛУЧМЕЖДУ).
Texte
LEN (ДЛСТР), LEFT (ЛЕВСИМВ), RIGHT (ПРАВСИМВ), MID (ПСТР), LOWER (СТРОЧН), UPPER (ПРОПИСН), UPPERFIRST (ПРОПИСНПЕРВ), REPEAT (ПОВТОР), CONCAT (СЦЕПИТЬ), SUBSTITUTE (ПОДСТАВИТЬ), FIND (НАЙТИ), SEARCH (ПОИСК), FIELD (ПОЛЕ), TRIM, LTRIM, RTRIM, PADLEFT, PADRIGHT, SPLIT, JOIN, STARTSWITH, ENDSWITH, CONTAINS, NL.
Logique
IF (ЕСЛИ), AND (И), OR (ИЛИ), NOT (НЕ), EMPTY, ISNUMBER (ЕЧИСЛО), COALESCE.
Listes
SORT, RSORT, UNIQUE, FILTER, FOREACH, REDUCE, INDEX, SLICE, COUNTA (СЧЁТЗ), COUNTUNIQUE, ARRAYADD, ARRAYREMOVE, ARRAYREPLACE, ARRAYFIND, PAIRUP (СОСТАВИТЬПАРЫ).
PAIRUP(items; idField; seed [; tagsField]) répartit les participants en paires pour un « café aléatoire ». Avec un nombre impair, un groupe compte trois personnes. La fonction essaie de séparer les personnes portant des tags communs, sous forme de chaîne "|a|b|" ou de tableau. Le même seed et les mêmes données produisent la même répartition. Limites : 10 000 personnes et 64 tags par personne. Quand de nombreuses personnes partagent des tags, tous les conflits ne peuvent pas forcément être évités, mais tous les participants sont placés. Trouver des enregistrements peut lire 10 000 lignes à la fois ; le résultat d’une formule avancée peut atteindre 4 Mo.
Dates et heures
TODAY (СЕГОДНЯ), NOW (ТДАТА), DATEADD, DATESUB, DATEDIF (РАЗНДАТ), DATEFORMAT, DATEVALUE, WEEKDAY (ДЕНЬНЕД).
JSON
TOJSON, FROMJSON, JSONPATH, JP, JSONOBJECT, JSONARRAY, KEYS, VALUES.
Cryptographie et encodage
HASH (ХЭШ), TOBASE64, FROMBASE64, FROMJWT, FROMJWK.
Paramètres
PARAMID, PARAMREPLACE, PARAMREMOVE.
Exemples
Expressions dans un message :
- Total :
{{= price * qty}}. - Tiers du montant, arrondi :
{{= round(total / 3)}}. - Condition :
{{= param.total > 1000 ? "grossiste" : "détail"}}. - Texte composé :
{{= concat("Commande n°", ctx.order_id)}}.
Formule avancée dans Calcul :
- Remise de 10 % :
ОКРУГЛ({user:total} * 0.9). - Nombre d’éléments de
ctx:СЧЁТЗ(FROMJSON({items})). - Ordre pseudoaléatoire stable de lignes placées dans
ctx.rowspar Trouver des enregistrements : il ne change pas entre exécutions tant que le « sel » reste le même.
{"type":"compute","params":{"formula":"TOJSON(SORT(FOREACH(FROMJSON({rows}); LAMBDA(r; HASH(\"sha256\"; r.user_id & \"-salt\") & \"|\" & r.user_id))))","save_to_ctx":"order"}}
La vérification de réponse Correspond à une formule attend une erreur textuelle ; une chaîne vide signifie que la réponse est acceptée. Exemple : IF(ISNUMBER({answer}); ""; "Saisissez un nombre").
Tester une formule
Le testeur évalue une formule avancée et renvoie le résultat ou une erreur de syntaxe, sans enregistrer quoi que ce soit :
- dans l’éditeur : sous Correspond à une formule, saisissez un Exemple de réponse, puis cliquez sur Vérifier ;
- par API :
POST /api/bots/{botID}/reactions/test-formulaavec{"formula": "…", "sample_text": "…"}; - par MCP : outil
test_formulaavecbot_id,formulaetsample.
La réponse contient ok, result, error et matches, vrai si le résultat est vide et que la réponse aurait passé la vérification.
Le calcul s’effectue dans un contexte vide : ctx, les paramètres d’abonné et les paramètres globaux sont vides. {clé} et {user:clé} renvoient donc une chaîne vide. Seul le texte d’exemple est disponible sous {text}, {answer} ou {received_message}. Le testeur ne vérifie ni {{= }}, ni le mode Formule, ni les tableaux de décision.
Pour aller plus loin
- Substitutions et formules :
{{...}},ctxet paramètres. - Actions : Calcul et tableaux de décision.
- Messages et boutons : formules et vérification des réponses.
- Collections et données : données traitées.
- Limites de la plateforme : tailles des formules et tableaux de décision.