Ajout de boutons callback dans Telegram

Dans Telegram, un bouton callback envoie une requête à un bot lorsqu’on clique dessus. La réponse du bot apparaît dans une fenêtre contextuelle.

Avec la requête, le bot reçoit des informations sur la personne qui a cliqué. Il peut donc répondre différemment à chaque utilisateur, par exemple en insérant son nom dans la réponse.

FLOWIN permet d’ajouter automatiquement des boutons callback aux messages transférés, d’y déplacer une partie du texte, de copier des boutons existants et de recueillir des statistiques de clics.

À quoi servent les boutons callback

Un bouton callback permet de masquer des détails importants d’un message. Dans un canal consacré à l’investissement, vous pouvez par exemple laisser l’idée de transaction et le nom de l’action dans le texte, et n’afficher le prix d’achat ou de vente, le stop-loss et le take-profit qu’après un clic. Si quelqu’un copie automatiquement le texte seul, ces conditions ne figureront pas dans la copie.

Pour obtenir le signal complet, il faut cliquer sur le bouton. FLOWIN enregistre le clic et les statistiques indiquent qui a consulté les détails et à quel moment. Cela aide à repérer les personnes qui collectent automatiquement votre contenu. La réponse elle-même peut aussi être copiée : le bouton complique donc la copie, sans l’empêcher.

Génération d’un bouton callback

En mode « Génération », FLOWIN ajoute un nouveau bouton au message transféré. Vous définissez son libellé et choisissez ce qui s’affichera après un clic : une réponse rédigée à l’avance ou un extrait du message lui-même.

Pour effectuer ce réglage, il vous faut un transfert activé en mode « Copie ». Choisissez comme compte expéditeur un bot connecté par token, car seuls les bots peuvent envoyer des messages avec des boutons callback.

Prenons l’exemple d’un signal sur l’action d’une entreprise fictive. Nous allons déplacer les conditions de la transaction de la ligne « Détails » vers le bouton « En savoir plus » :

0. Ouvrez @flow_in_bot, envoyez la commande /start et appuyez sur « Tableau de bord ».

   

1. Ouvrez « Menu » → « Boutons » → « Boutons callback ». Cliquez sur « Créer », puis choisissez « Génération ».

   

   

2. Dans le champ « Libellé », saisissez « En savoir plus ». Dans le champ « Contenu », insérez <regexp>(?<=Détails : ).*$</regexp>. Ce motif sélectionne le texte situé après « Détails : ». Cliquez sur « Créer ».

   

3. Cliquez sur « Appliquer » pour le bouton créé. Dans la fenêtre « Sélection des transferts », cochez le transfert souhaité, puis cliquez sur « Enregistrer ».

   

   

4. Envoyez l’exemple dans la conversation source. Dans la conversation de destination, des points de suspension remplaceront les conditions de la transaction. Cliquez sur « En savoir plus » : le prix d’achat, le stop-loss et le take-profit s’afficheront.

   

   

   

Copie des boutons callback d’origine

Le mode « Copie » sert lorsque le message d’origine possède déjà un bouton callback. FLOWIN lit sa réponse et ajoute au message transféré un bouton avec le même libellé et le même texte.

Pour copier les boutons, il faut également un transfert en mode « Copie » dont le compte expéditeur est un bot connecté par token. C’est le compte d’écoute, celui qui lit les messages de la conversation source, qui cliquera sur le bouton d’origine. Vérifiez que le bouton lui répond par du texte.

1. Ouvrez « Menu » → « Transferts », puis cliquez sur « Réglages » pour le transfert souhaité.

   

   

2. Dans la fenêtre des réglages, ouvrez l’onglet « Boutons ». Dans le bloc « Lecture des boutons », activez « Boutons callback », puis cliquez sur « Enregistrer ».

   

3. Ouvrez « Menu » → « Boutons » → « Boutons callback ». Cliquez sur « Créer », puis choisissez « Copie ».

   

   

4. Dans la fenêtre qui s’ouvre, cliquez sur « Créer ».

   

5. Cliquez sur « Appliquer » pour la configuration créée. Dans « Sélection des transferts », cochez le transfert pour lequel la lecture des boutons est activée, puis cliquez sur « Enregistrer ».

   

   

6. Envoyez un nouveau signal accompagné d’un bouton dans la conversation source. Dans la conversation de destination, ouvrez le bouton copié : son libellé et les conditions de la transaction doivent correspondre à ceux d’origine.

   

   

Comment modifier un bouton callback

Pour modifier un bouton déjà créé, ouvrez la liste « Boutons callback ».

1. Cliquez sur « Modifier » pour le bouton souhaité.

   

2. Modifiez les champs souhaités, puis cliquez sur « Enregistrer ». Vérifiez les nouvelles données dans la liste.

   

   

Réglages des boutons callback

En mode « Génération », les cinq champs décrits ci-dessous sont disponibles. En mode « Copie », seuls « Couleur » et « Description » peuvent être modifiés, car le libellé et le contenu proviennent du bouton d’origine.

Libellé

Indiquez le texte qui apparaîtra sur le bouton, par exemple « En savoir plus ». Ce champ est obligatoire.

Vous pouvez utiliser des balises méta pour insérer les données du message. Par exemple, <src-chat-name> insère le nom de la conversation source.

Couleur

Choisissez l’une des quatre options : « Par défaut », « Bleu », « Rouge », « Vert ». Avec « Par défaut », un nouveau bouton prend la couleur standard de Telegram, tandis qu’un bouton copié conserve sa couleur d’origine.

Contenu

Ce champ définit la réponse que le lecteur verra après avoir cliqué sur le bouton. Il doit être rempli : rédigez une réponse ou indiquez un motif pour rechercher un extrait dans le message.

Pour déplacer une partie du message dans le bouton, placez le motif de recherche entre les balises <regexp>…</regexp>. Le motif utilisé par défaut est <regexp>\s.{20,180}$</regexp> : il sélectionne entre 20 et 180 caractères à la fin du message, après un espace ou un saut de ligne. Si la réponse est vide, FLOWIN n’ajoute pas de bouton.

Si vous rédigez une réponse en texte simple, sans <regexp>, le contenu du message reste inchangé. Vous pouvez ajouter à la réponse les balises méta <clicker-name> et <clicker-id>. FLOWIN les remplacera par le nom et l’ID Telegram de la personne qui a cliqué. Par exemple, Bonjour, <clicker-name> ! deviendra une salutation contenant le nom du lecteur.

Texte de remplacement

Ce texte apparaîtra dans le message à la place de l’extrait déplacé dans le bouton. Par défaut, il est remplacé par des points de suspension .... Si vous laissez le champ vide, l’extrait sera supprimé sans être remplacé. Ce réglage ne modifie pas le message si « Contenu » contient une réponse rédigée à l’avance, sans motif de recherche.

Description

Vous pouvez noter ici à quoi sert la configuration du bouton. Ce champ peut rester vide : il n’influe pas sur le fonctionnement du bouton.

Comment choisir les messages auxquels ajouter le bouton

Pour ajouter le bouton uniquement à certains messages, associez-lui un filtre, par exemple sur le mot « actions ». Les messages sans ce mot seront transférés, mais sans bouton. Si vous associez ce filtre au transfert lui-même, les messages ne contenant pas « actions » ne seront pas envoyés. Le réglage est expliqué dans le guide sur les filtres.

Autres actions sur les boutons

À côté de chaque configuration dans la liste « Boutons callback », le menu « Plus » propose les actions suivantes :

• « Appliquer » ouvre la sélection des transferts dans lesquels le bouton sera utilisé.
• « Dupliquer » crée une copie de la configuration.
• « Sélectionner un projet » ajoute le bouton à un projet.
• « Supprimer » supprime la configuration.

Vous pouvez consulter les transferts déjà sélectionnés via « Transferts [1] ». Le nombre entre crochets indique combien il y en a. Dans cette fenêtre, vous pouvez ajouter des transferts ou retirer ceux où le bouton n’est plus nécessaire.

Comment consulter les statistiques de clics

Les statistiques montrent qui clique sur vos boutons et combien de temps après la publication. Elles sont regroupées par conversation de destination et incluent les boutons de tous les transferts vers cette conversation.

1. Ouvrez « Transferts » dans le menu du tableau de bord. Sur le transfert souhaité, cliquez sur l’élément « Boutons callback », qui indique le nombre de configurations associées.

   

2. Dans la liste « Derniers 10 boutons », choisissez 10, 20 ou 30. Les statistiques par utilisateur s’afficheront : nom, ID Telegram et clics.

   

Comment lire les indicateurs :

• La colonne « clics » indique le nombre de boutons différents sur lesquels l’utilisateur a cliqué. Par exemple, 3/5 signifie qu’il a cliqué sur 3 boutons sur 5. Cliquer plusieurs fois sur le même bouton n’augmente pas ce nombre.
• « moyenne » et « médiane » indiquent le délai habituel avant le premier clic. La médiane est moins influencée par quelques clics particulièrement tardifs.
• « minimum » et « maximum » indiquent le délai le plus court et le plus long avant le premier clic.
• Dans la rangée de boutons, ceux sur lesquels l’utilisateur a cliqué sont mis en couleur. Le numéro indique l’ordre du premier clic, et le nombre entre parenthèses indique combien de fois il a cliqué sur ce bouton.

Si un utilisateur ouvre presque tous les nouveaux signaux avec le même délai très court, il est possible qu’il les collecte automatiquement. Comparez ses heures de clic avec l’apparition de vos signaux dans un autre canal. Des clics rapides ne prouvent pas, à eux seuls, qu’il copie votre contenu.