Message Telegram

Envoie des messages et des pièces jointes par l’intermédiaire d’un bot.

Rôle

Informe des utilisateurs ou groupes Telegram des résultats des flux, des approbations ou d’autres événements. Le texte et le destinataire peuvent être fixes ou générés à partir des champs du tableau.

Entrées et sorties

Une destination avec in et success/failure ; le bot configuré effectue la livraison pendant l’écriture.

Paramètres

Le paramètre	Réglages et valeurs	Options et limites
`role`	Rôle du bloc : une source lit les données ; une destination écrit le résultat.	Par défaut : `target`
`connection_id`	La connexion enregistrée par laquelle le bloc accède au système.	Par défaut : `empty` Jusqu’à 64 caractères
`recipient_type`	Type de destinataire : private, group ou auto pour une interprétation automatique compatible.	Options : `auto`, `private`, `group` Par défaut : `auto`
`chats`	Identifiants de conversation ou modèle déterminant le destinataire à partir des données.	Par défaut : `empty` Jusqu’à 4 000 caractères
`text`	Texte du message ; jusqu’à 4 096 caractères dans la configuration.	Par défaut : `empty` Jusqu’à 4 096 caractères
`parse_mode`	none pour du texte brut ou html pour la mise en forme prise en charge.	Options : `none`, `html` Par défaut : `none`
`silent`	Envoie sans notification sonore.	Par défaut : `disabled`
`attachments`	Pièces jointes du Gestionnaire de fichiers, d’un dossier ou du champ « Fichier joint » des paramètres d’exécution.	Nombre : 0–10
`time_zone`	Fuseau horaire pour les substitutions de date et d’heure système.	Par défaut : `Europe/Kyiv` Jusqu’à 64 caractères

Modèles et nombre de messages

La substitution {{Назва поля}} utilise la valeur de la ligne actuelle. Balises système : {{$date}}, {{$time}}, {{$datetime}}, {{$flow}}, {{$rows}}, {{$row}}, {{$table}}.

Si un modèle de destinataire, d’objet ou de corps contient un champ de ligne ou {{$row}}, un message distinct est créé pour chaque ligne. Sinon, un seul message est créé pour toutes les données d’entrée.
{{$table}} est disponible uniquement dans le corps du message. Il inclut jusqu’à 1 000 lignes et une indication du reste.
Tous les champs utilisés dans les balises doivent exister dans l’entrée ; TEMPLATE_FIELD_MISSING est détecté pendant la préparation.
Les dates et heures utilisent le time_zone indiqué. Les valeurs des données sont échappées pour les messages mis en forme.

Configuration étape par étape

Créez une connexion au bot et vérifiez l’accès au destinataire voulu.
Sélectionnez le type de destinataire et la conversation dans l’interface disponible, ou indiquez un identifiant pris en charge.
Rédigez le message et insérez les balises. Vérifiez combien de messages seront générés.
Ajoutez les pièces jointes et silent si nécessaire ; définissez le fuseau horaire.
Vérifiez la mise en forme et la préparation, puis lancez la livraison.

Règles et diagnostics

Le bot doit être accessible au destinataire et disposer des autorisations requises dans le groupe ; le bloc n’accorde pas lui-même ces autorisations.
Jusqu’à 10 sources de pièces jointes. Les sources en double sont interdites.
Le HTML doit respecter le sous-ensemble autorisé par Telegram ; des balises invalides ou non fermées provoquent TELEGRAM_MARKUP. L’éditeur aide à créer une mise en forme compatible.
Un grand tableau peut produire de nombreuses parties de message ; pour des données volumineuses, un fichier joint ou un bref résumé est plus pratique.
Après un envoi partiel, vérifiez le journal avant de réessayer afin d’éviter les doublons.
Une entrée active vide ne crée aucun message : EMPTY_STAGE. Jusqu’à 10 000 messages sont autorisés par bloc et par exécution ; au-delà, filtrez ou répartissez les données.
La perte de la réponse pendant un envoi externe est traitée comme un résultat incertain : le système ne renvoie pas automatiquement ce message.
Après substitution, le texte est automatiquement réparti en parties de 4 096 caractères maximum, en conservant un HTML valide. Un fichier individuel est limité à 50 Mo ; un dossier joint ajoute jusqu’à 20 fichiers.

Exemple de configuration

Pour une notification unique, définissez une conversation de groupe fixe et le texte « Flux {{$flow}} terminé. {{$rows}} lignes traitées, {{$datetime}} ». Aucun champ de ligne n’est utilisé ; un seul récapitulatif est donc généré.