Telegram
Maintenu par OrkyvoVersion 1.0.1Toutes les offres sauf DevOps2 actions · 1 déclencheur
Envoyez des messages et des documents avec votre bot, et réagissez aux messages reçus.
Connectez un bot Telegram créé avec @BotFather pour envoyer des notifications, des confirmations ou des documents à un chat, un groupe ou un canal, et démarrer un workflow à chaque message reçu par le bot (appel vérifié par un secret, doublons ignorés).
Opérations
| Opération | Type | Description |
|---|---|---|
| Envoyer un messageeffet externe : demande une confirmation avant une exécution manuelle | action | Envoie un message texte à un chat, un groupe ou un canal. |
| Envoyer un documenteffet externe : demande une confirmation avant une exécution manuelle | action | Envoie un fichier (PDF, image, archive…) à partir de son URL publique ou de son file_id Telegram. |
| À réception d'un message | déclencheur | Démarre le workflow à chaque message reçu par le bot. Appels vérifiés par un secret, doublons ignorés. |
Connexion
Token fourni par @BotFather lors de la création du bot (commande /newbot).
Documentation
Prérequis
- Dans Telegram, ouvrez une conversation avec @BotFather, envoyez
/newbotet suivez les étapes. - Copiez le token fourni (format
123456789:AA…) : il donne un contrôle complet du bot, gardez-le secret. - Pour écrire à une personne, celle-ci doit d'abord envoyer un message au bot (Telegram l'impose). Pour un groupe, ajoutez le bot au groupe ; pour un canal, nommez-le administrateur.
Trouver l'identifiant d'un chat
Utilisez le déclencheur « À réception d'un message » : l'identifiant est dans message.chat.id. Les groupes et canaux ont un identifiant négatif (-100…). Un canal public accepte aussi @nom_du_canal.
Déclencheur « À réception d'un message »
- À la publication du workflow, Orkyvo appelle
setWebhookavec l'URL du workflow et un secret aléatoire ; chaque appel de Telegram est vérifié avec ce secret (en-têteX-Telegram-Bot-Api-Secret-Token). - Un bot n'a qu'une seule URL de webhook : il ne peut déclencher qu'un workflow actif à la fois, et la publication remplace toute URL configurée ailleurs (un autre service utilisant ce bot cessera de recevoir les messages).
- Telegram exige une URL publique en HTTPS : publiez depuis votre serveur de production. En local, utilisez le déclencheur manuel avec l'exemple fourni.
- À la désactivation, le webhook est retiré (
deleteWebhook). - Chaque mise à jour (
update_id) ne déclenche qu'une exécution, même si Telegram la renvoie.
Mise en forme
- Texte brut : recommandé si le message contient des données externes.
- HTML :
<b>gras</b>,<i>italique</i>,<a href="https://…">lien</a>,<code>code</code>. - MarkdownV2 : les caractères spéciaux doivent être échappés.
Limites
- Message : 4 096 caractères. Légende de document : 1 024 caractères.
- Documents par URL : 20 Mo maximum (téléchargés par Telegram). L'envoi de fichiers binaires depuis un workflow n'est pas pris en charge : utilisez une URL ou un file_id.
- Telegram limite le débit (environ 30 messages par seconde, 20 par minute dans un même groupe).