Réactions : les bases
Apprenez au bot à répondre à une commande, à un bouton ou à un autre événement. Création, ordre de priorité et enchaînement des réactions.
Sur cette page
Une réaction définit une règle de comportement du bot. Par exemple : « Si une personne écrit /price, lui envoyer les tarifs », ou « Après son paiement, lui attribuer l'étiquette Payé et ouvrir l'accès ».
Dans Réactions, choisissez l'événement, les conditions éventuelles et les actions. Le bot examine les règles de haut en bas et exécute la première qui convient. Placez donc les règles précises avant une réponse générale à tous les messages.
Composition d'une réaction
Pour envoyer les tarifs, il suffit de choisir la commande /price et d'ajouter un message. Les autres réglages servent à limiter la règle à certaines personnes ou conversations. L'éditeur comprend quatre sections :
| Section | Question à laquelle elle répond | Exemple |
|---|---|---|
| Déclencheur | Quand démarrer : texte, commande, média, bouton, événement ou horaire | La personne écrit /price |
| Dans les chats | Où la réaction fonctionne : conversation privée, appel au bot dans un groupe, chats précis ; l'état de l'utilisateur compte aussi | Seulement en privé |
| Conditions | Que vérifier en plus : étiquettes, paramètres, délai, nombre de messages | La personne porte l'étiquette « Payé » |
| Actions | Que faire : envoyer un message, changer les étiquettes, enregistrer des données, appeler l'IA | Envoyer les tarifs |
Création et modification
Cliquez sur Créer une réaction ou ouvrez-en une. En haut de l'éditeur se trouvent le nom obligatoire, le numéro #N, la description et le commutateur Active. Choisissez à gauche Déclencheur / Dans les chats / Conditions / Actions, puis remplissez le formulaire au centre. À droite, l'aperçu Telegram montre les blocs du message, les boutons et le menu. Cliquez sur Enregistrer.
Une réaction enregistrée affiche aussi ses statistiques : nombre d'exécutions, graphique et derniers événements.
Historique des modifications et restauration
Dans une réaction enregistrée, ouvrez Change history. Vous y trouverez les 20 dernières modifications, leur date, leur auteur, leur origine et les différences « Avant / Après ». Vous pouvez restaurer l'état antérieur à une modification choisie : examinez d'abord les différences, puis confirmez.
La restauration remplace les changements non enregistrés et figure elle-même dans l'historique. Elle rétablit les réglages de la réaction, mais n'annule ni les messages déjà envoyés ni les données déjà modifiées. Si quelqu'un a modifié la réaction pendant votre consultation, actualisez les différences.
Exercice et explication pas à pas.
Ordre et priorité
Sans recherche, filtre ni dossier sélectionné, faites glisser les réactions pour définir leur ordre manuel. Cet ordre fixe la priorité : pour un événement, la première réaction qui convient s'exécute, puis la recherche s'arrête. Pour laisser les suivantes s'exécuter aussi, ajoutez l'action Réaction suivante (goto_next).
Recherche, filtres et regroupement
Au-dessus de la liste, vous pouvez rechercher par nom ou numéro et appliquer ces filtres :
- État : toutes les réactions, seulement les actives ou seulement les inactives.
- Créée du / au : jours calendaires dans votre fuseau horaire, bornes comprises.
- Ordre : manuel (ordre utilisé par le bot), plus récentes d'abord ou plus anciennes d'abord.
- Regroupement : par jour ou par mois de création, uniquement avec un ordre chronologique. Activer le regroupement en ordre manuel passe à « Plus récentes d'abord » ; un ordre chronologique déjà choisi est conservé. Revenir à l'ordre manuel désactive le regroupement.
Les filtres portent sur toutes les réactions, pas seulement sur la page affichée. Ils se combinent avec la recherche et les dossiers ; un compteur indique le nombre de résultats. Les choix figurent dans l'URL : vous pouvez actualiser la page, partager le lien ou revenir avec « Retour ». Réinitialiser les filtres efface la recherche, les filtres, l'ordre et le regroupement, mais conserve le dossier sélectionné.
Le filtrage et l'ordre d'affichage ne changent pas l'ordre réel dans lequel le bot examine les réactions.
Activation et désactivation
Le commutateur de la liste, ou Active dans l'éditeur, active ou désactive la réaction sans la supprimer. Une réaction inactive est ignorée.
Duplication et suppression
Sur chaque ligne, Dupliquer crée une copie et Supprimer retire la réaction. La duplication est pratique pour créer une règle voisine avec quelques différences.
Import et export
Exporter dans l'éditeur télécharge la réaction en JSON. Importer dans la liste la recharge. Vous pouvez ainsi déplacer une réaction entre bots et conserver des versions hors de la plateforme.
Diffusion d'une réaction
L'icône d'envoi sur la ligne d'une réaction l'adresse à tous les abonnés actifs du bot. Vous pouvez limiter l'audience par étiquettes. C'est utile pour les annonces et notifications. Voir Diffusions.
Enchaînements et dialogues
Par exemple, une première réaction présente le catalogue ; un bouton lance une deuxième réaction avec une fiche produit ; celle-ci demande l'adresse de livraison. Plusieurs mécanismes permettent ces transitions :
- Réaction en chaîne (
chain) : lance une autre réaction pendant l'exécution. - Réaction suivante (
goto_next) : passe à la prochaine réaction applicable dans la liste. - Étapes de dialogue : un bloc de message peut attendre une réponse et en vérifier le format. Voir Messages et boutons.
- Branche « sinon » : si les conditions ne sont pas remplies, lance la réaction indiquée dans « Conditions ».
- Choisir l'étape suivante (
branch_result) : traite séparément une recherche vide, unique, multiple ou incomplète. - Choisir selon la valeur (
branch_value) : par exemple, confirmer pourupdatedou demander de relire l'état pourconflict. - Résultat de l'action : passe à une réaction distincte selon la réussite, le conflit, l'absence d'enregistrement ou l'erreur, si l'action le permet. Choisir les branches.
- Appeler un bloc (
call_block) : transmet des entrées à un calcul commun et récupère ses sorties déclarées. Bibliothèque de blocs et versions.
Pour travailler sur des données, vous pouvez enchaîner Rechercher dans une collection → Choisir l'étape suivante → Boutons → Trouver les enregistrements liés. Pour une liste venant d'un service externe, utilisez Transformer une liste → Groupes et agrégats. Donnez un nom au résultat de chaque action et sélectionnez-le dans l'action suivante.
Les exercices pratiques présentent ces deux chaînes avec des cours et des demandes.
Utilisez le sélecteur de données des étapes précédentes au lieu de mémoriser les chemins. Avant d'enregistrer, testez le brouillon courant avec des données d'exemple et comparez les branches et messages prévus. Après l'enregistrement, parcourez aussi le trajet réel dans le bot et le canal connecté, où les actions s'exécutent réellement.
Pour aller plus loin
- Déclencheurs : tous les types d'événements.
- Conditions et chats : filtres et périmètre.
- Actions : liste complète des actions.
- Messages et boutons : construire les réponses.