> 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/otros/comentario.md).

# Comentario

### Visión General

El **Componente de Comentario Interno** (identificado en la interfaz por el título técnico `Comentario`) es un nodo utilitario enfocado exclusivamente en la documentación, organización gráfica y gobernanza de flujos. A diferencia de los nodos de mensajería, este componente **no interactúa y no es visible para el cliente final**. Su función principal es servir de apoyo visual para que desarrolladores y gestores inserten notas técnicas, descripciones de reglas de negocio, avisos de pendientes o mapeo de jornadas dentro del propio canvas de automatización.

### Parámetros de Configuración

La parametrización del bloque gestiona el formato textual y la identidad visual de la nota en el editor:

* **Comentario:** Editor de texto enriquecido (*texto enriquecido*) donde el administrador escribe la anotación, explicación o documentación deseada. Disponibiliza una barra de herramientas nativa con opciones como: negrita, cursiva, tachado, líneas horizontales, encabezados, enlaces, bloques de cita, inserción de fragmentos de código (`bloques de código`), tablas y listas ordenadas.<br>
* **Vista previa:** Área dinámica que renderiza en tiempo real el texto formateado en el editor, mostrando exactamente cómo quedará expuesta la anotación para el equipo en el mapa de diseño.<br>
* **Color:** Barra selectora de tonalidad cromática (mostrada en morado en la imagen). Permite cambiar el color de resaltado del contenedor o del encabezado del nodo en el mapa de flujos.<br>

### Constructor Visual

La interfaz gráfica está optimizada para la legibilidad y la organización espacial dentro del mapa de automatización:

* **Editor de texto enriquecido autónomo:** El constructor ofrece herramientas completas de formato de nivel de procesador de texto para que datos complejos (como listas de pendientes de API) puedan documentarse de manera estructurada y limpia.<br>
* **Nodo sin conectores de línea:** En el editor gráfico de flujos, este componente actúa como un bloque flotante aislado. **No posee puertos físicos de entrada ni de salida**, pues no forma parte de la cadena transaccional del contacto. Se coloca libremente junto a los nodos de acción para explicar lo que realiza esa rama específica del bot.<br>

### Operadores especiales

Las propiedades lógicas de este componente gestionan la indexación puramente estática y el control visual de proyectos:

* **Organización por código de colores (Color-Coding System):** La propiedad del campo *Color* permite que los equipos ágiles creen patrones de moderación visuales rápidos en el canvas (ej.: usar bloques *Rojos* para documentar errores conocidos, *Verdes* para indicar reglas de negocio homologadas o *Amarillos* para tareas pendientes).<br>
* **Procesamiento estático sin impacto en la infraestructura:** El motor de automatización ignora por completo este componente durante la ejecución del recorrido de un cliente en tiempo real. El nodo no consume memoria transaccional, no genera latencia y no procesa variables dinámicas de alcance.<br>

### Ejemplos Prácticos

La tabla de abajo muestra escenarios clásicos de cómo configurar y distribuir los bloques de comentario para documentar una automatización profesional:

| **Color del bloque seleccionado** | **Contenido formateado en el comentario**                                                                                                                                              | **Objetivo de la nota en el canvas**                                      | **Caso de Uso Práctico**                                                                                                               |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Morado**                        | <p><code>### Regla de distribución de leads</code><br><br><br><br>- <strong>Sector 1:</strong> Ventas al por menor<br><br><br><br>- <strong>Sector 2:</strong> Ventas al por mayor</p> | Explicar los criterios de un bloque condicional Switch Case cercano.      | Dejar en evidencia para los nuevos administradores qué parámetros matemáticos guían la división de sectores del bot.                   |
| **Rojo**                          | `> ⚠️ **ATENCIÓN:** El token de API de abajo expira cada 90 días. Próximo cambio: 15/09/2026.`                                                                                         | Emitir avisos críticos de infraestructura o mantenimiento para el equipo. | Fijar una alerta visual roja junto a un componente de Code o Webhook para recordar al equipo de soporte las actualizaciones de claves. |
| **Gris**                          | `*Flujo construido por el desarrollador Carlos en junio/2026. Versión 2.4.*`                                                                                                           | Identificar la autoría, el historial de cambios y la versión del script.  | Mantener un encabezado estático en la parte superior del flujo que funcione como un diario de a bordo del proyecto de automatización.  |


---

# 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/otros/comentario.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.