Événement Telegram

Catalogue des nœuds Déclencheurs
Sur cette page

Recevoir les événements du bot par webhook : messages, commandes, boutons, paiements et membres.

Utilisation et spécificités

L’action utilise le token du bot ; le déclencheur utilise un secret webhook distinct. Publiez puis configurez le webhook HTTPS du bot. chat_id désigne la conversation cible. Le mode personnalisé expose les méthodes Bot API et leurs paramètres.

Type technique : telegram_trigger. Runtime : nodulz.

Identifiants et prérequis

  • Webhook Telegram (integration / telegram_webhook). Secret de 1 à 256 caractères (lettres, chiffres, _ et -). Utiliser le même identifiant dans le trigger et l’action setWebhook.

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre Type Par défaut Valeurs / limites
rateLimitEnabled boolean - -
rateLimitMax number - -; > 0
rateLimitWindowMs number - -; > 0
allowedIps array - -; max 256
blockedIps array - -; max 256
credentialId string "" -
events array [] -
chatId string "" -
command string "" -
testPayload string "" -

Aide de configuration

events
Événements
Vide : tous les événements reçus. Configurer aussi allowed_updates dans setWebhook : chat_member, message_reaction et message_reaction_count demandent une sélection explicite et les droits Telegram adaptés.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json
{
  "credentialId": "",
  "events": [],
  "chatId": "",
  "command": "",
  "testPayload": ""
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.