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

  1. 01Ouvrez un workflow et ajoutez Telegram · Nouvelle mise à jour depuis le catalogue.
  2. 02Renseignez les champs requis et associez les valeurs des étapes précédentes.
  3. 03Testez le node avec un petit jeu de données et vérifiez sa sortie.
  4. 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

ChampSignificationZone
Bot TelegramChoisis le token du bot dans les secrets du workflow. @BotFather le fournit directement ; aucune app OAuth à enregistrer.Protégé
Types de mise à jourListe 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 uniquementFacultatif. Démarre uniquement si le texte commence par cette commande. Inclus le / initial.Standard
ID de chat uniquementFacultatif. 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éeSignificationType
StandardCe déclencheur ne nécessite aucune entrée.JSON
SortieSignificationType
Type d’événementType de mise à jour Telegram détecté, par exemple message ou callback_query.text
ID de mise à jourConfigurez cette valeur dans le panneau du node.number
ID du chatConfigurez cette valeur dans le panneau du node.text
ID du messageConfigurez cette valeur dans le panneau du node.number
ID du sujetConfigurez cette valeur dans le panneau du node.number
TexteConfigurez cette valeur dans le panneau du node.text
Légende du médiaConfigurez cette valeur dans le panneau du node.text
ExpéditeurUtilisateur ou bot Telegram à l’origine de la mise à jour.json
ChatChat, groupe ou canal Telegram de cette mise à jour.json
Clic sur un boutonCallback Query complète lors du clic sur un bouton inline.json
Données du callbackValeur data du bouton inline cliqué.text
Mise à jour bruteMise à 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.