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écouvrez 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.
Utilisez 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
- 01Ouvrez un workflow et ajoutez Telegram depuis le catalogue.
- 02Renseignez les champs requis et associez les valeurs des étapes précédentes.
- 03Testez le node avec un petit jeu de données et vérifiez sa sortie.
- 04Reliez la sortie réussie et activez le workflow après un test complet.
Actions et modes
Choisissez 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 | Configurez cette valeur dans le panneau du node. | text |
| Message | Configurez cette valeur dans le panneau du node. | text |
| ID du sujet | Configurez cette valeur dans le panneau du node. | number |
| Répondre à | Configurez cette valeur dans le panneau du node. | number |
| Boutons | Configurez cette valeur dans le panneau du node. | json |
| ID de requête callback | Configurez cette valeur dans le panneau du node. | text |
| Notification de callback | Configurez cette valeur dans le panneau du node. | text |
| Afficher comme alerte | Configurez cette valeur dans le panneau du node. | boolean |
| URL de callback | Configurez cette valeur dans le panneau du node. | text |
| Durée du cache | Configurez cette valeur dans le panneau du node. | number |
| Sortie | Signification | Type |
|---|---|---|
| Réussi | Configurez cette valeur dans le panneau du node. | boolean |
| ID du message | Configurez cette valeur dans le panneau du node. | number |
| ID du chat | Configurez cette valeur dans le panneau du node. | text |
| Envoyé à | Configurez 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é | Configurez 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: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez 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é
Avant l'activation, vérifiez les données reçues par cette étape et le contenu de sa sortie.
Stockez les clés et identifiants dans le gestionnaire protégé. Ne les insérez jamais dans les champs, données de test ou descriptions.
Résoudre les erreurs
- Aucune sortie: vérifiez la dernière exécution et les champs fournis par le node précédent.
- Variable vide: ouvrez la sortie précédente et utilisez un nom de champ réellement présent.
- Liste traitée une seule fois: activez l'exécution par élément.