> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/composants-telegram/message-telegram.md). # Message Telegram ### 1. Vue d’ensemble Le composant d’envoi de message Telegram (identifié dans l’interface comme `telegram_message`) est un nœud d’action sortant axé sur la transmission de contenu. Sa fonction principale est d’injecter des e-mails, des alertes, des textes informatifs ou des fichiers multimédias directement dans le chat privé de l’utilisateur qui interagit avec le bot Telegram. Il est utilisé pour guider des conversations de manière linéaire, diffuser des supports marketing ou émettre des avis de transaction sans retenir l’utilisateur dans des validations de réponse. ### 2. Paramètres de configuration Le paramétrage du bloc définit les directives du format et le contenu de la bulle de message que le client recevra : * Type de message : Menu déroulant utilisé pour choisir la catégorie de payload que le robot transmettra. Les options mappées incluent : * `Texte`: Messages composés uniquement de chaînes de texte brut, prenant en charge un formatage simple des emojis et des liens. * `Audio`: Envoi de fichiers sonores ou de messages vocaux dans des formats compatibles avec Telegram. * `Image`: Envoi de médias graphiques, de bannières d’entreprise ou de photos promotionnelles (PNG, JPG). * `Vidéo`: Partage de fichiers audiovisuels consultables nativement dans le lecteur de l’application (MP4). * Message (\* Champ obligatoire si Texte) : Le corps principal du texte qui sera envoyé au client dans le chat. * URL du fichier (\* Obligatoire pour les médias) : Disponible lorsque les options `Image`, `Audio` ou `Vidéo`. Permet de coller l’adresse HTTP/HTTPS publique du fichier ou d’effectuer le chargement via le bouton de téléversement. ### 3. Constructeur visuel L’interface graphique adapte ses champs de façon conditionnelle selon l’option choisie dans le paramètre *Type de message*: * Mise en page de texte simplifiée : En travaillant en mode `Texte`, l’interface n’isole que la zone de saisie *Message*, exige le remplissage du contenu (`*`) pour que le nœud puisse être enregistré. * Mise en page multimédia avancée : En passant en mode `Image`, la zone de texte longue est remplacée par le champ *URL du fichier* et le bouton violet de téléversement, qui permet de glisser des fichiers directement depuis l’ordinateur de l’administrateur du flux vers les serveurs de la plateforme. ### 4. Opérateurs spéciaux Les propriétés logiques de ce composant gèrent l’interpolation de chaînes dynamiques et le traitement de la livraison asynchrone : * Interpolation de balises par doubles accolades : Le champ *Message* est entièrement compatible avec l’insertion de métadonnées enregistrées dans le contact à l’aide de la syntaxe `{{...}}`. Cela permet de personnaliser les notifications actives de manière individualisée (ex. : « Votre facture arrive à échéance demain, `{{nome}}`!"). * Traitement asynchrone sans état d’attente : Contrairement au nœud de question Telegram, ce composant ne génère aucune pause d’exécution dans le parcours. Le moteur de la plateforme envoie la requête de publication aux serveurs de l’API Telegram et libère immédiatement le contact vers le bloc suivant connecté au nœud. ### 5. Exemples pratiques Le tableau ci-dessous présente des scénarios classiques d’utilisation de ce composant pour alimenter des flux de conversation sur Telegram : | **Type de message sélectionné** | **URL du fichier / Téléversement** | **Contenu configuré (Message)** | **Cas d’utilisation pratique** | | ------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `Texte` | *Aucun* | "Bienvenue sur le canal officiel d’assistance ! 🤖" | Déclencher une salutation initiale instantanée dès que le contact active le bot via un déclencheur entrant. | | `Image` | *Téléversement de comprovante.png* | *Aucun* | Afficher une infographie explicative présentant les étapes d’un produit juste après que le prospect a choisi une option de menu. | | `Texte` | *Aucun* | "Veuillez patienter un instant, `{{nome}}`. Nous transférons votre prise en charge vers la file d’attente du service de `{{setor_escolhido}}`..." | Afficher un avis de transition dynamique avant de déclencher le composant de transfert à un agent humain. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/composants-telegram/message-telegram.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.