> 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/configuracoes/fila-de-distribuicao.md). # Fila de distribuição As **Filas de Distribuição** permitem automatizar a seleção de um item dentre um conjunto previamente configurado, utilizando regras de distribuição definidas por diferentes algoritmos. Atualmente, esse recurso pode ser utilizado em **Fluxos de Automação** dentro do seu workspace na Hablla permitindo selecionar automaticamente um item da fila durante a execução do fluxo. Essas filas podem ser utilizadas em diversos cenários dentro da Hablla, como a distribuição de atendimentos entre atendentes, definição automática do responsável por um cartão, roteamento entre organizações, seleção de pessoas cadastradas ou qualquer outro processo que necessite escolher um item de forma automática e padronizada. Cada fila de distribuição criada é composta pelos seguintes componentes: 1. #### Conjunto de Itens da Fila *O conjunto de itens serão **as opções disponíveis** para que o algoritmo de distribuição possa selecionar um desses itens.* 2. #### Algoritmo de distribuição *O algoritmo é responsável por determinar qual será o próximo item selecionado sempre que a fila for utilizada.* Dessa forma, as Filas de Distribuição tornam os processos mais flexíveis, eliminam distribuições manuais e garantem que a lógica de seleção seja aplicada de forma consistente em toda sua operação. ## O que é o Algoritmo de Transbordo O **Algoritmo de Transbordo** é responsável por definir a lógica utilizada pelo sistema para selecionar o próximo item de uma fila. Sempre que uma fila de distribuição for acionada dentro de um fluxo, o sistema analisa os itens disponíveis e utiliza o algoritmo configurado para determinar qual deles será selecionado naquela execução. ### Algoritmos de Transbordo Atualmente, o **algoritmo de transbordo** conta com 6 opções disponíveis, sendo elas: Fila Sequencial, Menor quantidade de atendimentos no dia, Menor quantidade de atendimentos abertos, Menor quantidade de atendimentos abertos com limite, Aleatório e Peso por Atendentes. A seguir, explicamos um pouco sobre cada uma delas. ### Fila Sequencial A fila sequencial, realiza a distribuição seguindo uma sequência entre os itens cadastrados na fila. Por exemplo, considerando uma fila com as opções: 1. Ana 2. Bruno 3. Carlos As execuções serão distribuídas seguindo a ordem: ```mermaid --- config: theme: base themeVariables: primaryColor: "#893fff" primaryBorderColor: "#893fff" primaryTextColor: "#FFFFFF" lineColor: "#0057B8" --- flowchart LR A([Ana]) --> B([Bruno]) B --> C([Carlos]) C --> A ``` Esse algoritmo é indicado quando se deseja realizar uma distribuição uniforme seguindo uma ordem contínua. ### Menor Quantidade de Atendimentos no dia Responsável por selecionar o usuário que possuir a **menor quantidade de atendimentos recebidos no dia**. Nesse algoritmo, antes de realizar a distribuição, a Hablla compara a quantidade de atendimentos que cada usuário da fila recebeu e seleciona aquele que possuir o menor número. Esse modelo ajuda a equilibrar a distribuição ao longo do dia. ### Menor quantidade de atendimentos abertos Responsável por considera a quantidade de **atendimentos atualmente em aberto** com cada usuário. Desse modo, o próximo atendimento é direcionado para o usuário que possuir a menor quantidade de atendimentos em andamento no momento em que a fila com esse algoritmo for acionada. Esse algoritmo é útil para equilibrar a carga de trabalho atual da equipe. ### Menor quantidade de atendimentos abertos com limite {% hint style="info" %} **Importante:** este algoritmo funciona **apenas para usuários que utilizam uma Permissão Personalizada com limite de atendimentos definido**. Usuários que utilizam as permissões padrão da plataforma não terão o limite de atendimentos considerado durante a distribuição. {% endhint %} Funciona de forma semelhante à opção **Menor quantidade de atendimentos em aberto**, porém também considera o **limite máximo de atendimentos** permitido para cada usuário. Antes de realizar a distribuição, a Hablla verifica quais usuários possuem a menor quantidade de atendimentos em aberto no momento em que a fila é executada e, em seguida, valida se eles ainda não atingiram o limite configurado na permissão. Caso um usuário já tenha alcançado esse limite, ele deixa de participar da distribuição até voltar a possuir capacidade para receber novos atendimentos. O limite de atendimentos por usuário é definido por meio das **Permissões**, na configuração da permissão que será atribuída ao usuário. Para saber como configurar esse limite, consulte a documentação das **Permissões** [clicando aqui](/hablla/configuracoes/permissoes.md#atendimentos). ### Aleatório Seleciona um dos itens cadastrados na fila de forma aleatória sempre que a fila for utilizada. Nesse algoritmo, todos os itens participantes possuem a mesma probabilidade de serem selecionados, sem considerar qualquer critério de distribuição. Esse algoritmo é indicado para cenários em que não há necessidade de manter uma sequência ou balancear a carga de trabalho entre os participantes, sendo a escolha realizada de forma randômica a cada execução. ### Peso por atendente {% hint style="warning" %} Para utilizar este algoritmo, é necessário configurar o **nível de prioridade** de cada usuário participante da fila. Caso nenhum peso seja configurado, a distribuição pode não ocorrer conforme o esperado. {% endhint %} Permite distribuir os itens da fila de forma proporcional entre os usuários, utilizando um **peso** configurado para cada um deles. Quanto maior o peso atribuído a um usuário, maior será a frequência com que ele será selecionado durante as distribuições. Esse algoritmo é indicado para equipes em que alguns usuários possuem maior capacidade de atendimento ou que precisam receber um volume maior de demandas em relação aos demais. #### Exemplo
UsuáriosNível de Prioridade
Ana1
Bruno2
Carlos1
Nesse cenário, o usuário **Bruno** tende a receber aproximadamente o dobro de distribuições em comparação com Ana e Carlos, enquanto Ana e Carlos recebem distribuições na mesma proporção. {% hint style="info" icon="triangle-exclamation" %} Para saber como realizar essa configuração, consulte o guia prático em nossa documentação para saber como configurar os níveis de prioridade de atendimento dos usuários [clicando aqui. ↗️](/hablla/configuracoes/permissoes.md#atendimentos) {% endhint %} ## Como Configurar as Filas de Distribuição Para criar as suas próprias filas de distribuição, você primeiro precisará ter um usuário **administrador** para poder acessar as configurações do seu workspace. {% stepper %} {% step %} ### Acesse as configurações do seu Workspace Após acessar o seu [studio](https://studio.hablla.com/), para acessar as configurações do workspace, clique no ícone da **engrenagem** no canto **superior direito** da sua tela.
{% endstep %} {% step %} ### Acesse as configurações de Filas de Distribuição Ao acessar as configurações do seu workspace, localize no menu lateral na parte esquerda da sua tela a opção "**Filas de Distribuição**" e clique sobre ela.
{% endstep %} {% step %} ### Crie uma nova fila de distribuição Ao acessar as configurações das **filas de distribuição**, você provavelmente não terá ainda uma fila criada. Para criar uma nova fila, basta clicar no botão "**+ Nova Fila de Distribuição**" na lateral superior direita da nova tela que vai se abrir.
Após clicar surgirá uma nova tela de configuração da fila que você irá criar com 3 campos para serem definidos: **Nome de Exibição da Fila**, **Algoritmo de Transbordo**, e **Tipo da Fila**. {% endstep %} {% step %} ### **Defina o Nome de Exibição da sua Fila** Nessa etapa você deve criar um nome de exibição para a sua fila de distribuição.
{% endstep %} {% step %} ### **Defina o Algoritmo de Transbordo da sua Fila** Agora você precisa selecionar uma das opções de **Algoritmos de Transbordo** disponíveis para a definição do tipo de Algoritmo que será utilizado para a sua nova fila.
{% endstep %} {% step %} ### **Defina o Tipo da Fila da sua Fila** Aqui você deve selecionar uma das opções de **Tipos de Fila** disponíveis para definir qual será o tipo da sua nova fila de distribuição.
{% endstep %} {% step %} ### Salve as configurações Agora basta apenas clicar no botão **Salvar** para efetivar as suas configurações da Fila de Distribuição. {% endstep %} {% endstepper %} As **Filas de Distribuição** oferecem uma forma simples e flexível de automatizar a seleção de itens dentro da Hablla, permitindo que a distribuição siga regras consistentes e adaptadas as necessidades da sua operação. Ao escolher corretamente o **Tipo da Fila** e o **Algoritmo de Transbordo**, é possível distribuir atendimentos, definir responsáveis, realizar roteamentos e automatizar diversos processos sem a necessidade de decisões manuais durante a execução dos fluxos. Após criar e configurar sua fila de distribuição, ela ficará disponível para utilização nos **Fluxos de Automação** do seu workspace, podendo ser reutilizada sempre que necessário. {% hint style="success" %} **Próximo passo:** Agora que sua fila está configurada, consulte a documentação de **Fluxos de Automação** para aprender como utilizar uma Fila de Distribuição durante a execução de um fluxo, [clicando aqui ↗️](/fluxos-de-automacoes/gestao-de-fluxos/como-utilizar-as-filas-de-distribuicao-em-fluxo.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/configuracoes/fila-de-distribuicao.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.