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
- 01Ouvre un workflow et ajoute Telegram depuis le catalogue.
- 02Enregistre les identifiants dans Secrets des workflows et choisis-les dans le champ « Bot Telegram ».
- 03Renseigne les champs requis et associe les valeurs des étapes précédentes.
- 04Teste le node avec un petit jeu de données et vérifie sa sortie.
- 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
| Champ | Signification | Zone |
|---|---|---|
| Bot Telegram | Choisis le token du bot dans les secrets du workflow. Il reste chiffré et n’est jamais stocké dans le workflow. | Protégé |
| Opération | Envoie un message ou confirme un clic sur un bouton inline. | Standard |
| ID du chat ou @canal | Chat de destination. Utilise @nomducanal pour un canal ; les chats privés et groupes utilisent leur ID numérique. | Standard |
| Message | Texte du message. Telegram accepte jusqu’à 4096 caractères après analyse. | Standard |
| Formatage | Format Telegram facultatif. Les caractères spéciaux MarkdownV2 doivent être échappés selon les règles Telegram. | Standard |
| ID du sujet de forum | Facultatif. Envoie le message dans un sujet précis d’un supergroupe. | Standard |
| Répondre à l’ID du message | Champ pratique facultatif, fusionné dans reply_parameters.message_id au format de l’API Telegram. | Standard |
| Envoyer silencieusement | Envoie sans son de notification. Le message reste visible. | Standard |
| Empêcher le transfert et l’enregistrement | Protège le contenu contre le transfert et l’enregistrement local lorsque Telegram le permet. | Standard |
| Aperçu du lien | Objet LinkPreviewOptions Telegram facultatif avec autocomplétion JSON depuis les nœuds précédents. | Standard |
| Paramètres de réponse | Objet 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 callback | Obligatoire. Utilise callback_query.id du déclencheur Telegram. Telegram affiche un indicateur de chargement sur le bouton jusqu’à la confirmation. | Standard |
| Texte de notification | Notification facultative de 0 à 200 caractères. Sans texte, seul l’indicateur de chargement est arrêté. | Standard |
| Afficher comme alerte | Affiche la notification dans une boîte de dialogue plutôt qu’en haut de l’écran. | Standard |
| URL de callback | Facultatif. 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ément | Dé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ée | Signification | Type |
|---|---|---|
| ID du chat | Configure cette valeur dans le panneau du node. | text |
| Message | Configure cette valeur dans le panneau du node. | text |
| ID du sujet | Configure cette valeur dans le panneau du node. | number |
| Répondre à | Configure cette valeur dans le panneau du node. | number |
| Boutons | Configure cette valeur dans le panneau du node. | json |
| ID de requête callback | Configure cette valeur dans le panneau du node. | text |
| Notification de callback | Configure cette valeur dans le panneau du node. | text |
| Afficher comme alerte | Configure cette valeur dans le panneau du node. | boolean |
| URL de callback | Configure cette valeur dans le panneau du node. | text |
| Durée du cache | Configure cette valeur dans le panneau du node. | number |
| Sortie | Signification | Type |
|---|---|---|
| Réussi | Configure cette valeur dans le panneau du node. | boolean |
| ID du message | Configure cette valeur dans le panneau du node. | number |
| ID du chat | Configure cette valeur dans le panneau du node. | text |
| Envoyé à | Configure cette valeur dans le panneau du node. | number |
| Message Telegram | Ré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.