> 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/fluxos-de-automacoes/gestao-de-fluxos/como-utilizar-as-filas-de-distribuicao-em-fluxo.md). # Como utilizar as Filas de Distribuição em Fluxo Agora que você já sabe como criar e configurar uma **Fila de Distribuição**, o próximo passo é utilizá-la em um **Fluxo de Automação**. Caso ainda não saiba como configurar a sua Fila, você pode aprender mais sobre as **Filas de Distribuição**, pela nossa documentação oficial [clicando aqui ↗️](/hablla/configuracoes/fila-de-distribuicao.md). Atualmente, as Filas de Distribuição podem ser utilizadas **exclusivamente por meio dos Fluxos de Automação** da Hablla. Para isso, é necessário adicionar o componente **Distribuidor de Filas** ao fluxo onde a distribuição deverá ocorrer. No tutorial abaixo, iremos utilizar um modelo de fluxo no qual nós **criaremos** um fluxo do zero composto por apenas 4 componentes para exemplificar a utilização da **Fila de Distribuição** na prática. ### 1. Crie o fluxo desejado Acesse o **Studio** e adicione um novo fluxo onde a distribuição deverá ser realizada. Neste exemplo, utilizaremos um fluxo com atendimento receptivo do WhatsApp. 1. **Primeiro Passo:** Clique no ícone no botão de WhatsApp no menu rápido de ícones localizado na parte inferior da tela. 2. **Segundo Passo:** Selecione o ícone do "**Receptivo do WhatsApp**" no seu fluxo. {% hint style="info" %} Para selecionarmos qualquer componente nos fluxos de automação, temos duas opções: * **Opção 1:** Clicar e segurar sobre o componente e depois arrastar para a **área em branco** do fluxo *(Nessa opção, você consegue escolher qual a localização o novo componente permanecerá no fluxo).* * **Opção 2:** Basta clicar sobre o componente e o fluxo automaticamente criará o novo componente dentro de uma **área padrão** do fluxo. {% endhint %} ### 2. Adicione o componente Distribuidor de Filas {% hint style="warning" %} **Importante:** O componente deve fazer parte de um fluxo de automação. Ele não pode permanecer isolado, sem conexão com os demais componentes do fluxo. {% endhint %} 1. **Passo 1:** No menu rápido de componentes na parte inferior, localize e clique no componente "Hablla" (O ícone com o logotipo da Hablla) 2. **Passo 2:** Agora, localize o componente: "**Distribuidor de Filas**" e selecione ele. 3. **Passo 3:** Ligue os nós do receptivo ao ícone de distribuidor de filas, conforme apresentado no GIF a seguir:
### 3. Selecionar a fila que será utilizada no nó do Distribuidor Clique **duas vezes** sobre o componente **Distribuidor de Filas** para abrir suas configurações. Ao abrir a nova janela, você precisa selecionar uma das **filas que você configurou** anteriormente seguindo a [nossa documentação](/hablla/configuracoes/fila-de-distribuicao.md). No campo **Fila\***, selecione uma das filas que você criou e depois clique em **Salvar**. {% hint style="warning" icon="triangle-exclamation" %} Se ainda não tiver configurado nenhuma fila de distribuição, elas não serão exibidas nesse componente. {% endhint %}
### 4. Conecte a saída de sucesso da Fila ao próximo nó do fluxo Após salvar as configurações da fila, conecte a sua saída **Sucesso** ao componente **Variáveis Globais**. Neste exemplo, utilizaremos uma variável global para **facilitar a identificação e reutilização dos dados retornados pelo Distribuidor de Filas** nas próximas etapas do fluxo. Dessa forma, em vez de utilizar diretamente a expressão completa gerada pelo componente, podemos atribuir esse valor a uma variável com um nome mais simples e fácil de identificar. {% hint style="warning" %} A Variável Global não **realiza a distribuição**. O usuário já foi selecionado anteriormente pelo **Distribuidor de Filas**. Neste exemplo, ela é utilizada apenas para armazenar o ID retornado em uma variável de fácil identificação e reutilização nas próximas etapas do fluxo. {% endhint %} Para adicionar o componente de variáveis globais: * Clique no ícone **Adicionar Componente (Ícone +)**, disponível no menu rápido de componentes do fluxo. * Em seguida, role para baixo na lista de componentes até a seção **Outros**, clique sobre ela e depois selecione a opção **Defina variáveis globais**. * Agora você deve conectar a saída de sucesso do **Distribuidor de Filas** ao novo componente de variáveis globais. * Após conectar a saída de sucesso do **Distribuidor** ao nó de **Variáveis Globais**, clique **duas vezes** sobre ele para abrir as configurações do nó. * Adicione uma variável global e insira no campo de valor, a expressão que retorna o **ID do Usuário**, que no caso do nosso exemplo, é retornado pela chave **key** do **Distribuidor de Fila**. *Como neste exemplo estamos utilizando uma fila do tipo **Usuários**, o Distribuidor de Filas retornará as informações referentes aos usuários selecionados dentro da fila de distribuição.*
Chave da Variável GlobalValor
id_userExpressão com o ID do usuário retornado pelo Distribuidor de Filas
{% hint style="info" %} No nosso exemplo, a expressão que retorna o **id do usuário** retornado pelo Distribuidor é a chave de nome "**key**" a seguir: ``` {{$data?.queueDistributor_0b35ul2nyd8t?.key}} ``` :warning: Lembre-se de alterar o **id do componente** de acordo com o seu fluxo. {% endhint %} * Agora basta salvar, clicando no botão "Salvar" no canto inferior direito da tela.
{% hint style="warning" %} Para compreender melhor esta etapa, recomendamos consultar a documentação sobre [**Como utilizar Variáveis e Expressões nos Fluxos**](/fluxos-de-automacoes/usando-variaveis.md#o-que-sao-variaveis-na-hablla) e também a documentação do componente [**Definir Variáveis Globais**](/fluxos-de-automacoes/todos-os-componentes/others/definir-variaveis-globais.md). {% endhint %} ### 5. Adicione e configure o componente de Transferência Agora que o ID do usuário selecionado pela fila está armazenado em uma **Variável Global**, o próximo passo é utilizar essa informação para realizar a transferência do atendimento e para isso, basta seguir os passos abaixo. #### Adicione o componente de Transferência * No menu rápido de componentes do fluxo, clique no ícone **Hablla** para visualizar os componentes disponíveis. * Localize a opção **Transferência**, clique sobre ela e arraste o componente para dentro do fluxo. * Em seguida, conecte a saída de sucesso do componente **Defina variáveis globais** ao componente de **Transferência**.
Agora que já adicionamos o componente de Transferência ao fluxo, precisamos agora configurá-lo para que ele funcione devidamente. Os próximos passos, ensinarão como você pode realizar essa configuração e efetivar as mudanças no seu fluxo. #### Configure o setor de destino * **Clique duas vezes** sobre o componente de **Transferência** para abrir suas configurações. * Primeiro, selecione o **Setor** para o qual o atendimento deverá ser transferido. {% hint style="warning" %} **Importante:** os usuários cadastrados na sua Fila de Distribuição também **devem fazer parte do setor selecionado** no componente de Transferência. Caso o usuário retornado pela fila não pertença ao setor definido, o atendimento não será direcionado para ele. Nesse cenário, o atendimento poderá ser encaminhado para a fila de atendimentos do setor ou distribuído para outro usuário, caso esse setor possua um algoritmo de transbordo ativo. {% endhint %} #### Configure o usuário utilizando uma expressão Após definir o setor, configure o campo **Usuário** para utilizar o ID armazenado anteriormente na Variável Global. Por padrão, esse campo permite selecionar diretamente um dos usuários cadastrados no seu workspace. Como queremos utilizar dinamicamente o usuário selecionado pela Fila de Distribuição, será necessário alterar o campo para o modo **Expression**. Para isso: 1. Passe o mouse sobre o título do campo **Usuário**. 2. No lado direito desse campo, localize e clique na opção **Expression**. 3. Após clicar, campo será liberado para receber uma expressão. Agora, informe a expressão correspondente à Variável Global criada anteriormente, que no caso do nosso exemplo, é representada pela expressão abaixo: ``` {{$data?.id_user}} ``` Após finalizar as configurações, clique em **Salvar**.
Por fim, nessa etapa, finalizamos as configurações do nosso fluxo de exemplo e ele seguirá esta sequência: ```mermaid flowchart LR A["Receptivo do WhatsApp"] --> B["Distribuidor de Filas"] B --> C["Variáveis Globais"] C --> D["Transferência de Atendimento"] ``` ### 6. Publique e ative o fluxo Com todos os componentes configurados e conectados, o próximo passo é **publicar as alterações** realizadas no fluxo. Para isso, basta seguir os passos a seguir: * Clique no botão **Publicar**. Uma janela de confirmação será exibida; confirme a publicação para aplicar as alterações. * Após a publicação, verifique também se o fluxo está **Ativo** visualizando se a chave ao lado direito do botão "publicar", está marcada ou desmarcada. Caso esteja inativo, clique sobre a chave de ativação para habilitá-lo. {% hint style="warning" %} **Importante:** publicar e ativar são ações diferentes. Além de publicar as alterações realizadas, certifique-se de que o fluxo esteja **Ativo**. Caso esteja inativo, o fluxo não será executado. {% endhint %}
### 7. Teste sua Fila de Distribuição Agora com o fluxo **publicado** e **ativo**, você já pode testar o funcionamento da sua **Fila de Distribuição**. Como neste exemplo utilizamos um **Receptivo do WhatsApp**, para testar, basta enviar uma mensagem para o número configurado no componente **Receptivo do WhatsApp**. Ao receber a mensagem, o fluxo será iniciado e seguirá as configurações que realizamos: ```mermaid flowchart LR A["Mensagem recebida"] --> C["Distribuidor de Filas"] C --> D["Variável Global"] D --> E["Transferência de Atendimento"] ``` Durante a execução, no momento em que o fluxo passar pelo **Distribuidor de Filas**, ele selecionará automaticamente um usuário de acordo com a fila e o algoritmo configurados. O ID do usuário selecionado será armazenado na Variável Global e utilizado pelo componente de **Transferência** para direcionar o atendimento. **Tudo pronto!** A partir de agora, sempre que um atendimento passar por esse fluxo, a Fila de Distribuição será acionada e o atendimento poderá ser transferido automaticamente para o usuário selecionado, respeitando as regras de distribuição configuradas. --- # 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/fluxos-de-automacoes/gestao-de-fluxos/como-utilizar-as-filas-de-distribuicao-em-fluxo.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.