> 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-whatsapp/entrante.md).

# Entrante

### Visión General

El **Disparador de Mensajes Entrantes de WhatsApp** es un nodo de entrada (*disparador entrante*) basado en eventos de comunicación. Su función principal es escuchar canales de comunicación activos y disparar un flujo de automatización o chatbot instantáneamente en el momento en que un cliente envía un nuevo mensaje.

**Regla de Retención de Atención:** El disparador cuenta con una inteligencia nativa de control de estado. Solo iniciará la automatización si el cliente en cuestión **no tiene ninguna atención humana ni ticket ya abierto** en el sistema. Si el cliente ya está siendo atendido por un operador, los mensajes enviados por él seguirán directamente en la pantalla del agente, ignorando este disparador para evitar interrupciones o bucles en la conversación humana.

### Parámetros de Configuración

La parametrización del disparador vincula la automatización a la línea telefónica oficial o canal de comunicación de la empresa mediante el siguiente criterio:

* **Canal:** Menú desplegable utilizado para seleccionar qué número de teléfono o API oficial de WhatsApp será monitoreado por este flujo específico. El componente realiza un barrido de las cuentas integradas en el panel de la plataforma para mostrarlas en el selector.<br>

### Constructor Visual

La interfaz gráfica está diseñada para un acoplamiento rápido y seguro, aislando el punto inicial del recorrido:

* **Selectores de Instancias Homologadas:** El menú desplegable muestra los alias de las conexiones y sus respectivos números internacionales de teléfono (ej: `Nombre de la Conexión (+55 11 99999-9999)`), permitiendo asociar fácilmente el número de producción o de pruebas a la automatizació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 la energía que inicia su ejecución proviene exclusivamente de un estímulo externo (el mensaje enviado por el usuario final).<br>

### Operadores especiales

Las propiedades lógicas de este componente manejan control de sesiones, inyección de datos de registro y tratamiento de medios:

* **Inyección de Payload de Contacto (Datos Nativos):** En cuanto se recibe el mensaje activador, el motor del disparador captura automáticamente los datos públicos disponibles en el perfil de WhatsApp del cliente, como el **Número de Teléfono** y el **Nombre para mostrar** (*PushName*), poniendo estas variables a disposición de inmediato para los siguientes bloques del flujo.<br>
* **Apertura de Ventana de Sesión (Ventana de 24 horas):** La activación exitosa de este componente valida y abre la ventana de conversación de la API de WhatsApp. Esto garantiza que los bloques de mensajes posteriores de la automatización puedan enviar textos, medios y botones interactivos sin costes de plantillas preaprobadas (mensajes de sesión).<br>

### Ejemplos Prácticos

La tabla a continuación muestra escenarios clásicos de cómo se comporta este disparador de acuerdo con el estado actual del usuario en el sistema:

| **Canal Seleccionado**           | **Estado del Cliente en el Sistema**                       | **Acción del Cliente**             | **Comportamiento del Disparador**                                                                                                |
| -------------------------------- | ---------------------------------------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **WhatsApp Comercial Principal** | Sin atenciones activas (Nuevo o Finalizado).               | Envió un "¡Hola, buenas tardes!".  | **Dispara el flujo:** El disparador captura el contacto e inicia el menú del chatbot de autoservicio.                            |
| **WhatsApp Soporte Técnico**     | En atención con el Operador Carlos.                        | Envió una foto del comprobante.    | **Ignora el disparador:** La imagen va directamente a la pantalla de Carlos; la automatización no interfiere en la conversación. |
| **WhatsApp Ventas Matriz**       | En espera en la cola de espera del departamento comercial. | Envió "Quiero hablar con alguien". | **Ignora el disparador:** El contacto permanece en la cola de espera del panel humano, manteniendo la prioridad de llegada.      |


---

# 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-whatsapp/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.
