Base de connaissances GetMyBot

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, LAMBDA et 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

EmplacementLangage
{{= expression}} dans un messageExpressions
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 formuleFormule avancée
Testeur test_formulaFormule avancée

Action Calcul

Choisissez un seul des trois modes de l’action :

  • Formule (expr) : une expression.
  • Tableau de décision (rules et default) : 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 && || !, condition condition ? oui : non et parenthèses.
  • Valeurs littérales : nombres 42 ou 3.14, chaînes "bonjour" ou 'bonjour', booléens true et false.
  • Données : nom sans accolades, recherché dans les paramètres de l’abonné et ctx, par exemple price * qty, ctx.total ou param.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 par AND, OR et NOT.
  • 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é} lit ctx, {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 par FILTER, FOREACH, ARRAYFIND ou REDUCE. 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 avec FROMJSON.
  • 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.rows par 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-formula avec {"formula": "…", "sample_text": "…"} ;
  • par MCP : outil test_formula avec bot_id, formula et sample.

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