DocumentationWorkflowsDéclencheurs
Telegram · Nouvelle mise à jour node
Démarre le workflow pour les nouveaux messages, commandes, publications de canal ou clics sur des boutons reçus par ton bot Telegram. Le webhook sécurisé est configuré automatiquement en Production. Découvrez sa configuration, les entrées et sorties, le test et la résolution des erreurs.
7 min de lectureMis à jour le
Fonction du node
Démarre le workflow pour les nouveaux messages, commandes, publications de canal ou clics sur des boutons reçus par ton bot Telegram. Le webhook sécurisé est configuré automatiquement en Production.
Utilisez Telegram · Nouvelle mise à jour comme étape clairement définie dans un workflow anymize.
- Démarre une nouvelle exécution du workflow.
- Fournit 1 sortie aux étapes suivantes.
- S'exécute comme une étape normale du workflow.
Configurer le node
- 01Ouvrez un workflow et ajoutez Telegram · Nouvelle mise à jour 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
Telegram · Nouvelle mise à jour remplit une fonction précise. Ses paramètres apparaissent lorsque vous sélectionnez le node.
Paramètres
| Champ | Signification | Zone |
|---|---|---|
| Bot Telegram | Choisis le token du bot dans les secrets du workflow. @BotFather le fournit directement ; aucune app OAuth à enregistrer. | Protégé |
| Types de mise à jour | Liste JSON des mises à jour Telegram autorisées à démarrer ce workflow. Laisse vide ou utilise [] pour la sélection par défaut de Telegram. | Standard |
| Commande du bot uniquement | Facultatif. Démarre uniquement si le texte commence par cette commande. Inclus le / initial. | Standard |
| ID de chat uniquement | Facultatif. Limite le déclencheur à un chat privé, un groupe ou un canal. | Standard |
| Ignorer les messages des autres bots | Évite les boucles entre bots. Les mises à jour sans expéditeur ne sont pas concernées. | Standard |
Entrées et sorties
| Entrée | Signification | Type |
|---|---|---|
| Standard | Ce déclencheur ne nécessite aucune entrée. | JSON |
| Sortie | Signification | Type |
|---|---|---|
| Type d’événement | Type de mise à jour Telegram détecté, par exemple message ou callback_query. | text |
| ID de mise à jour | Configurez cette valeur dans le panneau du node. | number |
| ID du chat | Configurez cette valeur dans le panneau du node. | text |
| ID du message | Configurez cette valeur dans le panneau du node. | number |
| ID du sujet | Configurez cette valeur dans le panneau du node. | number |
| Texte | Configurez cette valeur dans le panneau du node. | text |
| Légende du média | Configurez cette valeur dans le panneau du node. | text |
| Expéditeur | Utilisateur ou bot Telegram à l’origine de la mise à jour. | json |
| Chat | Chat, groupe ou canal Telegram de cette mise à jour. | json |
| Clic sur un bouton | Callback Query complète lors du clic sur un bouton inline. | json |
| Données du callback | Valeur data du bouton inline cliqué. | text |
| Mise à jour brute | Mise à jour Telegram complète, sans perte d’information. | json |
Exemple et test
Exemple de message Telegram entrant: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez uniquement les champs présents.
Exemple de test
{
"event_type": "message",
"update_id": 836521004,
"chat_id": "-1001234567890",
"message_id": 42,
"message_thread_id": null,
"text": "/status Produktion",
"caption": null,
"from": {
"id": 118922110,
"is_bot": false,
"first_name": "Mara",
"username": "mara_ops"
},
"chat": {
"id": -1001234567890,
"title": "Operations",
"type": "supergroup"
},
"callback_query": null,
"data": null,
"update": {
"update_id": 836521004
}
}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.
- Le workflow ne démarre pas: activez-le et vérifiez le mode du déclencheur.