DocumentationWorkflowsApps et services

Telegram node

Envoie des messages texte via ton bot Telegram et répond aux clics sur les boutons inline, dans les chats privés, groupes, canaux et sujets de forum. Découvre sa configuration, les entrées et sorties, le test et la résolution des erreurs.

9 min de lectureMis à jour le

Fonction du node

Envoie des messages texte via ton bot Telegram et répond aux clics sur les boutons inline, dans les chats privés, groupes, canaux et sujets de forum.

Utilise Telegram comme étape clairement définie dans un workflow anymize.

  • Traite 1 entrée.
  • Fournit 1 sortie aux étapes suivantes.
  • S'exécute comme une étape normale du workflow.

Configurer le node

  1. 01Ouvre un workflow et ajoute Telegram depuis le catalogue.
  2. 02Enregistre les identifiants dans Secrets des workflows et choisis-les dans le champ « Bot Telegram ».
  3. 03Renseigne les champs requis et associe les valeurs des étapes précédentes.
  4. 04Teste le node avec un petit jeu de données et vérifie sa sortie.
  5. 05Relie la sortie réussie et active le workflow après un test complet.

Actions et modes

Choisis la fonction voulue dans Opération. Le panneau affiche ensuite les paramètres utiles.

  • Envoyer un message
  • Répondre au clic sur le bouton

Paramètres

ChampSignificationZone
Bot TelegramChoisis le token du bot dans les secrets du workflow. Il reste chiffré et n’est jamais stocké dans le workflow.Protégé
OpérationEnvoie un message ou confirme un clic sur un bouton inline.Standard
ID du chat ou @canalChat de destination. Utilise @nomducanal pour un canal ; les chats privés et groupes utilisent leur ID numérique.Standard
MessageTexte du message. Telegram accepte jusqu’à 4096 caractères après analyse.Standard
FormatageFormat Telegram facultatif. Les caractères spéciaux MarkdownV2 doivent être échappés selon les règles Telegram.Standard
ID du sujet de forumFacultatif. Envoie le message dans un sujet précis d’un supergroupe.Standard
Répondre à l’ID du messageChamp pratique facultatif, fusionné dans reply_parameters.message_id au format de l’API Telegram.Standard
Envoyer silencieusementEnvoie sans son de notification. Le message reste visible.Standard
Empêcher le transfert et l’enregistrementProtège le contenu contre le transfert et l’enregistrement local lorsque Telegram le permet.Standard
Aperçu du lienObjet LinkPreviewOptions Telegram facultatif avec autocomplétion JSON depuis les nœuds précédents.Standard
Paramètres de réponseObjet ReplyParameters facultatif, fusionné avec le champ pratique d’ID de message.Standard
Boutons ou clavier personnaliséObjet JSON InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove ou ForceReply facultatif.Standard
ID de requête callbackObligatoire. Utilise callback_query.id du déclencheur Telegram. Telegram affiche un indicateur de chargement sur le bouton jusqu’à la confirmation.Standard
Texte de notificationNotification facultative de 0 à 200 caractères. Sans texte, seul l’indicateur de chargement est arrêté.Standard
Afficher comme alerteAffiche la notification dans une boîte de dialogue plutôt qu’en haut de l’écran.Standard
URL de callbackFacultatif. Ouvre une URL HTTPS dans Telegram ; les URL de jeu fonctionnent uniquement avec les boutons callback_game.Standard
Durée du cache (secondes)Facultatif. Durée pendant laquelle les clients Telegram peuvent mettre le résultat en cache. La valeur par défaut est 0.Standard
Exécuter une fois par élémentDésactivé (par défaut) : le node s'exécute une fois pour tout l'input. Activé : s'il reçoit plusieurs éléments (par ex. de « Séparer la liste »), il s'exécute une fois PAR élément, et {{ $json }} correspond alors à cet élément. C'est ainsi que tu traites une liste de fichiers entrée par entrée.Standard
Si un élément échoue« Ignorer » écrit un champ `error` pour l'élément en échec et poursuit avec les autres, au lieu de perdre toute l'exécution à cause d'un seul fichier illisible.Standard
Pause entre les éléments (millisecondes)Attente avant chaque exécution sauf la première. 1000 = 1 seconde par élément. Utile si le service distant te limite. Maximum 300000 (5 minutes).Standard

Entrées et sorties

EntréeSignificationType
ID du chatConfigure cette valeur dans le panneau du node.text
MessageConfigure cette valeur dans le panneau du node.text
ID du sujetConfigure cette valeur dans le panneau du node.number
Répondre àConfigure cette valeur dans le panneau du node.number
BoutonsConfigure cette valeur dans le panneau du node.json
ID de requête callbackConfigure cette valeur dans le panneau du node.text
Notification de callbackConfigure cette valeur dans le panneau du node.text
Afficher comme alerteConfigure cette valeur dans le panneau du node.boolean
URL de callbackConfigure cette valeur dans le panneau du node.text
Durée du cacheConfigure cette valeur dans le panneau du node.number
SortieSignificationType
RéussiConfigure cette valeur dans le panneau du node.boolean
ID du messageConfigure cette valeur dans le panneau du node.number
ID du chatConfigure cette valeur dans le panneau du node.text
Envoyé àConfigure cette valeur dans le panneau du node.number
Message TelegramRéponse Message complète de l’API Telegram Bot.json
Callback traitéVrai lorsque Telegram a accepté la réponse au clic sur le bouton.boolean
ID de requête callback traitéConfigure cette valeur dans le panneau du node.text

Ce node peut traiter les listes élément par élément. La gestion des erreurs et la pause se trouvent dans les paramètres avancés.

Exemple et test

Envoyer un statut avec un bouton inline : commence avec un petit jeu de données reconnaissable. Vérifie la sortie et utilise uniquement les champs présents.

Exemple de test

{
  "chat_id": "-1001234567890",
  "text": "<b>Deployment abgeschlossen</b>\nVersion 2.4.0 ist live.",
  "parse_mode": "HTML",
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Dashboard öffnen",
          "url": "https://example.com/status"
        }
      ]
    ]
  }
}

Accès et sécurité

Les identifiants se trouvent dans un secret de workflow que tu choisis dans le champ « Bot Telegram ». Le workflow ne contient que le nom du secret, jamais la clé elle-même.

Si tu as aussi une connexion Telegram sous Connecteurs, son réglage « Actions autorisées » s'applique aussi à ce node, même s'il travaille avec un secret de workflow, et il est vérifié à chaque exécution. Chaque action de ce node modifie quelque chose et demande « Autoriser les modifications ».

Les clés et identifiants ont leur place dans les Secrets des workflows ou dans tes comptes connectés. Ne les colle jamais en texte clair dans les champs, les données de test ou les descriptions.

Résoudre les erreurs

  • Aucune sortie : vérifie la dernière exécution et les champs fournis par le node précédent.
  • Variable vide : ouvre la sortie précédente et utilise un nom de champ réellement présent.
  • Action bloquée : passe « Actions autorisées » de la connexion sous Connecteurs sur « Autoriser les modifications ».
  • Liste traitée une seule fois : active l'exécution par élément.