> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/atendimento/tamanho-da-fila.md).

# Tamanho da fila

O módulo **Tamanho da Fila** consulta quantos atendimentos estão aguardando na fila de um departamento específico do Hyperflow Conversas. É útil para informar o cliente sobre o tempo de espera esperado, ou para decidir automaticamente qual caminho seguir dependendo da demanda atual.

{% hint style="warning" %}
Este módulo conta apenas os atendimentos que estão **efetivamente aguardando na fila**. Atendimentos pausados ou com tempo de resposta estourado não entram nessa contagem.
{% endhint %}

<figure><img src="/files/FykfnjromoabOjHAS6Yj" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Tamanho da Fila na área de trabalho do fluxo.</p></figcaption></figure>

***

## 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Atendimento** (identificada pela cor laranja).
5. Arraste o módulo **Tamanho da Fila** para a área de trabalho do fluxo.

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma conta do Hyperflow Conversas conectada a este aplicativo.
{% endhint %}

***

## 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

<figure><img src="/files/OaqEzlbJOpJmMqFbv05x" alt=""><figcaption><p>Imagem 2 - Painel de configuração do módulo Tamanho da Fila aberto.</p></figcaption></figure>

***

### 🏢 Departamento

No campo **Departamento**, selecione o departamento do Hyperflow Conversas cuja fila você quer consultar.

***

### 🔢 Usando o resultado

O número de atendimentos na fila fica disponível como a variável `{{input.size}}` **apenas no módulo conectado logo em seguida**.

{% hint style="warning" %}
Se precisar usar esse número mais adiante no fluxo (além do próximo módulo), grave o valor em uma **Variável de Fluxo** ou **Variável de Usuário** logo depois de consultar o tamanho da fila — caso contrário, a informação se perde nas etapas seguintes.
{% endhint %}

<figure><img src="/files/ukaKMVBmDc6mxicEjhzL" alt=""><figcaption><p>Imagem 3 - Módulo seguinte usando a variável {{input.size}} em uma mensagem.</p></figcaption></figure>

***

## 💡 Caso de uso

**Cenário:** uma empresa quer avisar o cliente sobre a fila antes de transferir para um agente humano, e oferecer uma opção de retorno automático quando a fila estiver muito grande.

**Configuração:**

1. Antes de transferir o atendimento, adicione o módulo **Tamanho da Fila** com o departamento desejado.
2. No módulo seguinte, envie uma mensagem como: `No momento, há {{input.size}} pessoas aguardando na fila.`
3. Use um módulo **Condicional** para verificar se `{{input.size}}` é maior que um número específico, e oferecer a opção de retorno automático nesse caso.

**Resultado:** o cliente recebe uma expectativa realista de espera, e a empresa pode oferecer alternativas quando a fila estiver cheia.

***

## 📌 Dicas úteis

* Use o resultado logo no módulo seguinte, ou salve-o em uma variável se precisar dele mais adiante no fluxo.
* Combine com o módulo **Condicional** para tomar decisões automáticas com base no tamanho da fila.
* Este módulo não tem uma saída alternativa para erros — se a consulta falhar (por exemplo, se o departamento configurado for excluído depois), o fluxo não prossegue a partir deste ponto.

***

## 📝 Resumo

* O módulo **Tamanho da Fila** consulta quantos atendimentos aguardam na fila de um departamento.
* O único campo de configuração é o **Departamento**.
* O resultado fica disponível como `{{input.size}}` somente no módulo imediatamente seguinte.
* A contagem inclui apenas atendimentos efetivamente aguardando na fila, não os pausados ou com tempo de resposta estourado.