Réactions : les bases

Une réaction est le bloc de construction principal d'un bot : une règle qui décrit quand se déclencher, dans quelles conditions et quoi faire. Un bot est une liste ordonnée de réactions ; pour chaque événement entrant, la plateforme parcourt la liste de haut en bas et applique la première réaction correspondante. La section se trouve dans le menu de gauche : Réactions.

Composition d'une réaction

Une réaction comporte quatre parties (onglets de l'éditeur) :

  • Déclencheur — l'événement auquel la réaction répond : texte, commande, média, appui sur un bouton, événement système, planification, etc. Voir Déclencheurs.
  • Dans les chats — où la réaction s'applique : chat privé, groupes avec mention du bot, chats spécifiques ; ainsi que des filtres sur l'état de l'utilisateur.
  • Conditions — filtres supplémentaires (tags, paramètres, heure, nombre de messages, etc.). Voir Conditions et chats.
  • Actions — ce que le bot effectue lors du déclenchement : envoyer un message, ajouter des tags, écrire dans une collection, appeler l'IA, etc. Voir Actions.

Création et édition

Cliquez sur Créer une réaction (ou ouvrez une réaction existante). En en-tête de l'éditeur : nom (obligatoire), numéro #N, description et bouton Actif. À gauche — navigation entre les sections Déclencheur / Dans les chats / Conditions / Actions, au centre — le formulaire, à droite — l'aperçu Telegram qui montre comment le message apparaîtra avec les blocs, le clavier et les menus. Enregistrez via le bouton Enregistrer.

Pour une réaction déjà enregistrée, l'éditeur affiche un panneau de statistiques : nombre de déclenchements, graphique et derniers événements.

Ordre et priorité

Les réactions dans la liste sont déplaçables par glisser-déposer — l'ordre détermine la priorité. Pour un événement donné, la première réaction correspondante se déclenche, puis le parcours s'arrête. Pour continuer le parcours et permettre aux réactions suivantes de se déclencher, ajoutez l'action Réaction suivante (goto_next).

Activation et désactivation

Le bouton dans la ligne de liste (ou Actif dans l'éditeur) active ou désactive une réaction sans la supprimer. Les réactions désactivées sont ignorées lors du parcours.

Duplication et suppression

La ligne de liste propose des boutons Dupliquer (crée une copie) et Supprimer. La duplication est utile pour créer une réaction similaire avec de légères différences.

Import et export

Une réaction peut être exportée en JSON (bouton Exporter dans l'éditeur) et réimportée (Importer dans la liste). Cela permet de transférer des réactions entre bots et de conserver des versions en dehors de la plateforme.

Diffusion d'une réaction

Le bouton Diffusion dans la ligne de réaction (icône « envoyer ») envoie cette réaction à tous les abonnés actifs du bot — pratique pour les annonces et les notifications. L'audience peut être restreinte par tags. Pour en savoir plus — Diffusions.

Enchaînements et dialogues

Plusieurs réactions permettent de construire des scénarios :

  • Réaction en chaîne (chain) — une action qui lance une autre réaction en cours d'exécution.
  • Réaction suivante (goto_next) — passe le contrôle à la prochaine réaction correspondante dans la liste.
  • Étapes de dialogue — un bloc de message peut attendre la réponse de l'utilisateur (avec vérification du format), mettant le scénario en pause. Voir Messages et boutons.
  • Branche « sinon » — si les conditions de la réaction ne sont pas remplies, il est possible de lancer une autre réaction (champ dans la section « Conditions »).

Et ensuite