> 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/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/componentes-de-telegram/entrante.md).

# Entrante

### Visión general

El **Disparador de Mensajes Entrantes de Telegram** es un nodo de entrada (*disparador de entrada*) basado en eventos de comunicación por mensajería. Su función principal es escuchar un bot específico de Telegram y disparar un flujo de automatización o chatbot instantáneamente en el momento en que un usuario envía un nuevo mensaje o interactúa con el bot por primera vez (comando `/start`).

**Regla de retención de atención:** Así como en los canales de WhatsApp y Facebook, el disparador posee una inteligencia integrada de control de estado. Solo iniciará la automatización si el contacto **no tenga una atención humana o un ticket abierto** en el sistema. Si la conversación ya está bajo la responsabilidad de un operador, los mensajes enviados por el usuario serán dirigidos directamente a la pantalla de chat del agente, ignorando este disparador para evitar duplicidad o interferencias en la conversación humana.

### Parámetros de configuración

La parametrización del disparador vincula la automatización a la cuenta oficial del bot en la plataforma mediante el siguiente criterio:

* **Canal:** Menú desplegable utilizado para seleccionar qué Bot de Telegram integrado en la plataforma será monitoreado por este flujo específico. Lista todos los bots que fueron conectados a través del token de API proporcionado por el *BotFather*.<br>

### Constructor visual

La interfaz gráfica está diseñada para ser minimalista, aislando el punto inicial de partida de la automatización:

* **Búsqueda Textual de Instancias:** El menú desplegable posee un campo de búsqueda interna (*Escribe aquí tu búsqueda*) para localizar rápidamente el bot correcto en workspaces que gestionan múltiples cuentas y robots de atención.<br>
* **Nodo inicial sin entrada:** En el editor gráfico de flujos, este componente se posiciona en el extremo inicial izquierdo de la pantalla. No posee conectores de entrada, pues su ejecución se dispara exclusivamente por un estímulo externo (el mensaje enviado por el usuario final al bot).<br>

### Operadores especiales

Las propiedades lógicas de este componente gestionan la captura de identidades de perfiles y el control de variables nativas del ecosistema de Telegram:

* **Inyección de Payload de Perfil (Metadatos de Telegram):** Tan pronto como el usuario envía el mensaje activador, el motor del disparador captura los datos proporcionados públicamente por la API de Telegram, como el **ID de Usuario (Chat ID)**, el **Nombre de usuario** (nombre de usuario iniciado por `@`), el **Nombre** (*Nombre*) y el **Apellido** (*Apellido*), poniendo estas variables inmediatamente a disposición para su uso en los próximos bloques.<br>
* **Apertura de Ventana de Comunicación sin Restricciones:** A diferencia de otros canales basados en recargas o plantillas aprobadas (HSM), la activación del disparador de Telegram abre un canal de comunicación libre. La automatización puede responder al usuario con bloques de mensajes de cualquier formato y sin límites de tiempo de sesión, siempre que el bot no haya sido bloqueado por el usuario.<br>

### Ejemplos prácticos

La tabla a continuación muestra escenarios de comportamiento del disparador de acuerdo con el estado actual del usuario en el sistema:

| **Bot Seleccionado (Canal)**    | **Estado del usuario en el panel**      | **Acción del Usuario en Telegram**               | **Comportamiento del disparador**                                                                                                      |
| ------------------------------- | --------------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| **@Bot\_Atendimento\_Ficticio** | Sin tickets abiertos.                   | Hizo clic en "Comenzar" o envió un "Hola".       | **Dispara el flujo:** El disparador captura el contacto e inicia el menú del chatbot de autoservicio.                                  |
| **@Bot\_Suporte\_Ficticio**     | En atención con el Operador Daniel.     | Envió un archivo de registro o mensaje de texto. | **Ignora el disparador:** El contenido llega directamente a la pantalla de Daniel; la automatización no interfiere en la conversación. |
| **@Bot\_Atendimento\_Ficticio** | Esperando en la cola de espera general. | Envió el mensaje "Necesito ayuda".               | **Ignora el disparador:** El contacto permanece en la cola de espera del panel humano, manteniendo la prioridad de llegada original.   |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/componentes-de-telegram/entrante.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.