Aller au contenu principal

Noeud telegram

Le noeud telegram permet l'intégration avec l'API Telegram Bot. Grâce à lui, le flux peut envoyer des messages dans des chats et des canaux, afficher des boutons Inline, traiter les clics sur les boutons et montrer des notifications contextuelles à l'utilisateur.

Paramètres du noeud telegram​

Edit

1. botToken​

Le token de votre bot Telegram, obtenu auprès de @BotFather.

Prend en charge Mustache — le token peut être stocké dans une variable de flux et inséré via {{variable}}.

Exemple :

{{flow.telegramToken}}

2. chat_id​

L'identifiant du chat ou du canal dans lequel le message sera envoyé.

Prend en charge Mustache. Si le champ est laissé vide, le backend prendra automatiquement la valeur de msg.payload.message.chat.id — ce qui est pratique pour répondre à un message entrant de l'utilisateur.

Exemple :

{{payload.message.chat.id}}

3. text​

Le texte du message à envoyer.

Prend en charge Mustache — vous pouvez insérer dynamiquement des données de msg.

Exemple :

Votre commande n°{{payload.orderId}} a été validée avec succès !

4. parseMode​

Mode de formatage du texte du message. Options disponibles :

  • none — sans formatage, le texte est envoyé tel quel.
  • Markdown — Markdown de base de Telegram (v1).
  • MarkdownV2 — version étendue de Markdown avec prise en charge des spoilers et d'autres éléments.
  • HTML — balisage HTML (<b>, <i>, <code>, <a> etc.).

5. replyMarkup​

Constructeur de boutons Inline sous le message. Les boutons sont organisés en lignes : chaque ligne contient un ou plusieurs boutons.

Pour chaque bouton, les éléments suivants sont définis :

  • Texte — étiquette du bouton visible par l'utilisateur.
  • callback_data — valeur qui sera envoyée dans le webhook dans le champ msg.payload.callback_query.data lors du clic sur le bouton. Cette valeur permet de déterminer quel bouton a été cliqué et de diriger le flux vers la branche appropriée via un noeud Switch.

Exemple de structure :

Ligne 1 : [Confirmer | callback_data: confirm]  [Annuler | callback_data: cancel]
Ligne 2 : [Plus de détails | callback_data: details]

6. callbackQueryId​

Identifiant de la requête de rappel — nécessaire pour répondre au clic sur le bouton Inline.

Prend en charge Mustache. Si le champ est laissé vide, la valeur est automatiquement prise de msg.payload.callback_query.id.

Exemple :

{{payload.callback_query.id}}

7. showAlert​

Case à cocher. Détermine le type de notification lors de la réponse au clic sur le bouton :

  • Désactivé — un court toast-popup est affiché (disparaît automatiquement).
  • Activé — une fenêtre modale avec une notification est affichée, que l'utilisateur doit fermer manuellement.

8. notificationText​

Texte de la notification qui apparaîtra en réponse au clic sur le bouton Inline.

Le champ s'affiche dans le formulaire uniquement lorsque showAlert est activé.
Prend en charge Mustache.

Exemple :

Votre choix a été enregistré : {{payload.callback_query.data}}

Exemples d'utilisation​

Exemple 1 : Envoi d'un message pour une nouvelle commande​

Flux :

[events: order_created] ---> [telegram]

Paramètres du noeud :

  • botToken : {{flow.telegramToken}}
  • chat_id : {{flow.adminChatId}}
  • text : Nouvelle commande n°{{payload.order.id}} de {{payload.order.userName}}. Montant : {{payload.order.totalPrice}} rub.
  • parseMode : none

Résultat :
Lors de la création d'une nouvelle commande, le bot enverra une notification dans le chat de l'administrateur.

Exemple 2 : Message avec des boutons de confirmation​

Paramètres du noeud :

  • chatId : {{payload.message.chat.id}}
  • text : Confirmer la commande ?
  • replyMarkup : 
    Ligne 1 : [Oui, confirmer | confirm]  [Annuler | cancel]

Résultat :
L'utilisateur recevra un message avec deux boutons. Un clic sur un bouton enverra callback_data au webhook, où il pourra être traité par un noeud Switch.

Exemple 3 : Réponse au clic sur un bouton avec notification​

Flux :

[http in] ---> [switch: callback_data == "confirm"] ---> [telegram: réponse avec notification]

Paramètres du noeud :

  • callbackQueryId : (laisser vide — pris de msg.payload.callback_query.id)
  • showAlert : activé
  • notificationText : Commande confirmée !

Résultat :
L'utilisateur verra un popup contextuel avec le texte "Commande confirmée !", qu'il devra fermer manuellement.