> 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/entrant.md).
# Entrant
### Vue d'ensemble
Le **Déclencheur de messages entrants Telegram** est un nœud d'entrée (*déclencheur entrant*) basé sur des événements de communication par messagerie. Sa fonction principale est d’écouter un bot Telegram spécifique et de déclencher instantanément un flux d’automatisation ou un chatbot au moment précis où un utilisateur envoie un nouveau message ou interagit avec le bot pour la première fois (commande `/start`).
**Règle de maintien de la prise en charge :** Tout comme dans les canaux WhatsApp et Facebook, le déclencheur dispose d’une intelligence intégrée de contrôle d’état. Il ne lancera l’automatisation que si le contact **n'a pas de prise en charge humaine ni de ticket ouvert** dans le système. Si la conversation est déjà sous la responsabilité d’un opérateur, les messages envoyés par l’utilisateur seront dirigés directement vers l’écran de chat de l’agent, en ignorant ce déclencheur afin d’éviter les doublons ou les interférences dans la conversation humaine.
### Paramètres de configuration
La paramétrisation du déclencheur lie l’automatisation au compte officiel du bot sur la plateforme selon le critère suivant :
* **Canal :** Menu déroulant utilisé pour sélectionner quel bot Telegram intégré à la plateforme sera surveillé par ce flux spécifique. Il liste tous les bots qui ont été connectés via le jeton API fourni par le *BotFather*.
### Constructeur visuel
L’interface graphique est conçue pour être épurée, en isolant le point de départ initial de l’automatisation :
* **Recherche textuelle d’instances :** Le menu déroulant dispose d’un champ de recherche interne (*Tapez votre recherche ici*) pour retrouver rapidement le bon bot dans les workspaces qui gèrent plusieurs comptes et robots de service client.
* **Nœud initial sans entrée :** Dans l’éditeur graphique de flux, ce composant se place à l’extrémité initiale gauche de l’écran. Il ne possède pas de connecteurs d’entrée, car son exécution est déclenchée exclusivement par un stimulus externe (le message envoyé par l’utilisateur final au bot).
### Opérateurs spéciaux
Les propriétés logiques de ce composant gèrent la capture des identités de profil et le contrôle des variables natives de l’écosystème Telegram :
* **Injection de charge utile du profil (métadonnées Telegram) :** Dès que l’utilisateur envoie le message déclencheur, le moteur du déclencheur capture les données rendues publiquement disponibles par l’API Telegram, telles que le **ID de l’utilisateur (Chat ID)**, le **nom d’utilisateur** (nom d’utilisateur commençant par `@`), le **Prénom** (*Prénom*) et le **Nom de famille** (*Nom de famille*), en mettant ces variables immédiatement à disposition pour une utilisation dans les blocs suivants.
* **Ouverture d’une fenêtre de communication sans restrictions :** Contrairement à d’autres canaux basés sur des recharges ou des modèles approuvés (HSM), l’activation du déclencheur Telegram ouvre un canal de communication libre. L’automatisation peut répondre à l’utilisateur avec des blocs de messages de n’importe quel format et sans limite de durée de session, à condition que le bot n’ait pas été bloqué par l’utilisateur.
### Exemples pratiques
Le tableau ci-dessous présente des scénarios de comportement du déclencheur selon l’état actuel de l’utilisateur dans le système :
| **Bot sélectionné (canal)** | **Statut de l'utilisateur dans le panneau** | **Action de l’utilisateur dans Telegram** | **Comportement du déclencheur** |
| ------------------------------- | ------------------------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **@Bot\_Atendimento\_Ficticio** | Aucun ticket ouvert. | A cliqué sur « Commencer » ou a envoyé un « Bonjour ». | **Déclenche le flux :** Le déclencheur capture le contact et lance le menu du chatbot en libre-service. |
| **@Bot\_Suporte\_Ficticio** | En assistance avec l’opérateur Daniel. | A envoyé un fichier journal ou un message texte. | **Ignore le déclencheur :** Le contenu arrive directement sur l’écran de Daniel ; l’automatisation n’interfère pas dans la conversation. |
| **@Bot\_Atendimento\_Ficticio** | En attente dans la file d'attente générale. | A envoyé le message « J’ai besoin d’aide ». | **Ignore le déclencheur :** Le contact reste dans la file d'attente du tableau de bord humain, en conservant la priorité d'arrivée initiale. |
---
# 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/entrant.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.