> 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/hablla/configuraciones/cola-de-distribucion.md).
# Cola de distribución
Las **Colas de distribución** permiten automatizar la selección de un elemento entre un conjunto previamente configurado, utilizando reglas de distribución definidas por diferentes algoritmos.
Actualmente, este recurso puede utilizarse en **Flujos de automatización** dentro de tu workspace en Hablla, permitiendo seleccionar automáticamente un elemento de la cola durante la ejecución del flujo.
Estas colas pueden utilizarse en diversos escenarios dentro de Hablla, como la distribución de atenciones entre agentes, la definición automática del responsable de una tarjeta, el enrutamiento entre organizaciones, la selección de personas registradas o cualquier otro proceso que necesite elegir un elemento de forma automática y estandarizada.
Cada cola de distribución creada está compuesta por los siguientes componentes:
1. #### Conjunto de elementos de la cola
*El conjunto de elementos será **las opciones disponibles** para que el algoritmo de distribución pueda seleccionar uno de esos elementos.*
2. #### Algoritmo de distribución
*El algoritmo es responsable de determinar cuál será el siguiente elemento seleccionado cada vez que se utilice la cola.*
De esta forma, las Colas de distribución hacen que los procesos sean más flexibles, eliminan las distribuciones manuales y garantizan que la lógica de selección se aplique de forma consistente en toda tu operación.
## Qué es el Algoritmo de Desbordamiento
El **Algoritmo de Desbordamiento** es responsable de definir la lógica utilizada por el sistema para seleccionar el siguiente elemento de una cola. Siempre que una cola de distribución sea activada dentro de un flujo, el sistema analiza los elementos disponibles y utiliza el algoritmo configurado para determinar cuál de ellos será seleccionado en esa ejecución.
### Algoritmos de Desbordamiento
Actualmente, el **algoritmo de desbordamiento** cuenta con 6 opciones disponibles, siendo ellas: Cola secuencial, Menor cantidad de atenciones en el día, Menor cantidad de atenciones abiertas, Menor cantidad de atenciones abiertas con límite, Aleatorio y Peso por agentes. A continuación, explicamos un poco sobre cada una de ellas.
### Cola secuencial
La cola secuencial distribuye siguiendo una secuencia entre los elementos registrados en la cola. Por ejemplo, considerando una cola con las opciones:
1. Ana
2. Bruno
3. Carlos
Las ejecuciones se distribuirán siguiendo el orden:
```mermaid
---
config:
theme: base
themeVariables:
primaryColor: "#893fff"
primaryBorderColor: "#893fff"
primaryTextColor: "#FFFFFF"
lineColor: "#0057B8"
---
flowchart LR
A([Ana]) --> B([Bruno])
B --> C([Carlos])
C --> A
```
Este algoritmo se indica cuando se desea realizar una distribución uniforme siguiendo un orden continuo.
### Menor cantidad de atenciones en el día
Responsable de seleccionar al usuario que posea la **menor cantidad de atenciones recibidas en el día**. En este algoritmo, antes de realizar la distribución, Hablla compara la cantidad de atenciones que recibió cada usuario de la cola y selecciona a quien tenga el menor número.
Este modelo ayuda a equilibrar la distribución a lo largo del día.
### Menor cantidad de atenciones abiertas
Responsable de considerar la cantidad de **atenciones actualmente abiertas** con cada usuario. De este modo, la siguiente atención se dirige al usuario que tenga la menor cantidad de atenciones en curso en el momento en que se active la cola con este algoritmo.
Este algoritmo es útil para equilibrar la carga de trabajo actual del equipo.
### Menor cantidad de atenciones abiertas con límite
{% hint style="info" %}
**Importante:** este algoritmo funciona **solo para usuarios que utilizan un Permiso Personalizado con límite de atenciones definido**. Los usuarios que utilizan los permisos predeterminados de la plataforma no tendrán el límite de atenciones considerado durante la distribución.
{% endhint %}
Funciona de forma similar a la opción **Menor cantidad de atenciones abiertas**, pero también considera el **límite máximo de atenciones** permitido para cada usuario.
Antes de realizar la distribución, Hablla verifica qué usuarios poseen la menor cantidad de atenciones abiertas en el momento en que se ejecuta la cola y, a continuación, valida si aún no alcanzaron el límite configurado en el permiso. Si un usuario ya ha alcanzado ese límite, deja de participar en la distribución hasta volver a tener capacidad para recibir nuevas atenciones.
El límite de atenciones por usuario se define mediante los **Permisos**, en la configuración del permiso que se asignará al usuario.
Para saber cómo configurar este límite, consulta la documentación de los **Permisos** [haciendo clic aquí](/hablla-docs-es/hablla/configuraciones/permisos.md#atendimentos).
### Aleatorio
Selecciona uno de los elementos registrados en la cola de forma aleatoria cada vez que se utilice la cola. En este algoritmo, todos los elementos participantes tienen la misma probabilidad de ser seleccionados, sin considerar ningún criterio de distribución.
Este algoritmo se indica para escenarios en los que no hay necesidad de mantener una secuencia o equilibrar la carga de trabajo entre los participantes, realizándose la elección de forma aleatoria en cada ejecución.
### Peso por agente
{% hint style="warning" %}
Para utilizar este algoritmo, es necesario configurar el **nivel de prioridad** de cada usuario participante de la cola. Si no se configura ningún peso, la distribución puede no ocurrir como se espera.
{% endhint %}
Permite distribuir los elementos de la cola de forma proporcional entre los usuarios, utilizando un **peso** configurado para cada uno de ellos. Cuanto mayor sea el peso asignado a un usuario, mayor será la frecuencia con la que será seleccionado durante las distribuciones.
Este algoritmo se indica para equipos en los que algunos usuarios tienen mayor capacidad de atención o necesitan recibir un mayor volumen de solicitudes en relación con los demás.
#### Ejemplo
Usuarios
Nivel de prioridad
Ana
1
Bruno
2
Carlos
1
En este escenario, el usuario **Bruno** tiende a recibir aproximadamente el doble de distribuciones en comparación con Ana y Carlos, mientras que Ana y Carlos reciben distribuciones en la misma proporción.
{% hint style="info" icon="triangle-exclamation" %}
Para saber cómo realizar esta configuración, consulta la guía práctica en nuestra documentación para saber cómo configurar los niveles de prioridad de atención de los usuarios [haciendo clic aquí. ↗️](/hablla-docs-es/hablla/configuraciones/permisos.md#atendimentos)
{% endhint %}
## Cómo configurar las colas de distribución
Para crear tus propias colas de distribución, primero necesitarás tener un usuario **administrador** para poder acceder a la configuración de tu workspace.
{% stepper %}
{% step %}
### Accede a la configuración de tu Workspace
Después de acceder a tu [studio](https://studio.hablla.com/), para acceder a la configuración del workspace, haz clic en el ícono del **engranaje** en la esquina **superior derecha** de tu pantalla.
{% endstep %}
{% step %}
### Accede a la configuración de las colas de distribución
Al acceder a la configuración de tu workspace, localiza en el menú lateral, en la parte izquierda de tu pantalla, la opción "**Colas de distribución**" y haz clic sobre ella.
{% endstep %}
{% step %}
### Crea una nueva cola de distribución
Al acceder a la configuración de las **colas de distribución**, probablemente todavía no tendrás una cola creada. Para crear una nueva cola, basta con hacer clic en el botón "**+ Nueva Cola de Distribución**" en la parte superior derecha de la nueva pantalla que se abrirá.
Después de hacer clic, aparecerá una nueva pantalla de configuración de la cola que vas a crear con 3 campos para definir: **Nombre para mostrar de la cola**, **Algoritmo de Desbordamiento**, y **Tipo de cola**.
{% endstep %}
{% step %}
### **Define el nombre para mostrar de tu cola**
En esta etapa debes crear un nombre para mostrar para tu cola de distribución.
{% endstep %}
{% step %}
### **Define el algoritmo de desbordamiento de tu cola**
Ahora necesitas seleccionar una de las opciones **Algoritmos de Desbordamiento** disponibles para definir el tipo de algoritmo que se utilizará para tu nueva cola.
{% endstep %}
{% step %}
### **Define el tipo de cola de tu cola**
Aquí debes seleccionar una de las opciones de **Tipos de cola** disponibles para definir cuál será el tipo de tu nueva cola de distribución.
{% endstep %}
{% step %}
### Guarda la configuración
Ahora solo tienes que hacer clic en el botón **Guardar** para hacer efectivas las configuraciones de tu cola de distribución.
{% endstep %}
{% endstepper %}
Las **Colas de distribución** ofrecen una forma simple y flexible de automatizar la selección de elementos dentro de Hablla, permitiendo que la distribución siga reglas consistentes y adaptadas a las necesidades de tu operación.
Al elegir correctamente el **Tipo de cola** y el **Algoritmo de Desbordamiento**, es posible distribuir atenciones, definir responsables, realizar enrutamientos y automatizar diversos procesos sin la necesidad de decisiones manuales durante la ejecución de los flujos.
Después de crear y configurar tu cola de distribución, quedará disponible para su uso en los **Flujos de automatización** de tu workspace, pudiendo reutilizarse siempre que sea necesario.
{% hint style="success" %}
**Próximo paso:** Ahora que tu cola está configurada, consulta la documentación de **Flujos de automatización** para aprender cómo utilizar una Cola de distribución durante la ejecución de un flujo, [haciendo clic aquí ↗️](/hablla-docs-es/flujos-de-automatizaciones/gestion-de-flujos/como-utilizar-las-colas-de-distribucion-en-el-flujo.md)
{% endhint %}
---
# 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/hablla-docs-es/hablla/configuraciones/cola-de-distribucion.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.
.png?alt=media&token=552d788e-5a04-4fc4-9f52-335f9ff2950e)
