> 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/agente-online.md).

# Agente online

O módulo **Agente Online** consulta o Hyperflow Conversas para saber se há um agente disponível (online) em um departamento — seja qualquer agente do departamento, ou um agente específico. É útil para decidir se vale a pena transferir o atendimento para um humano naquele momento, ou seguir por um caminho alternativo (como agendar um retorno) quando não houver ninguém online.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FFkZ4hnxapxOruBa9IWvi%2F01-visao-geral-canvas.png?alt=media&amp;token=b1e6968d-d0a0-4e56-a09e-79477c48f528" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Agente Online 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 **Agente Online** para a área de trabalho do fluxo.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F1pqdsWcdAJPLHbXJ4mJK%2F02-painel-modulos-atendimento.png?alt=media&amp;token=fb7b40a4-027a-4acc-a49b-76798a2829b8" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Atendimento expandida e o módulo Agente Online visível.</p></figcaption></figure>

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma conta do Hyperflow Conversas conectada a este aplicativo, com pelo menos um departamento já cadastrado (e, se for verificar um agente específico, com esse agente já cadastrado no departamento). Sem essa conexão, o painel de configuração não exibe os departamentos disponíveis.

Departamentos e agentes são cadastrados diretamente no Hyperflow Conversas, em **Organização > Departamentos** e **Organização > Agentes**. Depois de cadastrar o que for necessário, volte para a área de trabalho do fluxo e reabra o módulo **Agente Online** para selecioná-los.
{% 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="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FmmXUjD6GwNP04b5pun3w%2F03-painel-config-aberto.png?alt=media&amp;token=b78af69d-f4cc-432b-8aea-7b395323a0f9" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo Agente Online aberto.</p></figcaption></figure>

***

#### 🏢 Departamento

Selecione o departamento do Hyperflow Conversas que você quer verificar. Este campo é obrigatório.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FI4N5UlJFo91RgTzsYDFd%2Fimage.png?alt=media&amp;token=95d38ceb-3a08-4e0f-93b5-b2ca7659c65b" alt=""><figcaption><p>Imagem 4 - Campo Departamento com a lista de departamentos disponíveis.</p></figcaption></figure>

***

#### 🧑‍💼 Agente

Escolha como identificar o agente a ser verificado:

* **Selecionar agente da lista** — escolha um agente específico já cadastrado no departamento.
* **Buscar usando uma variável, por e-mail** — ative essa opção para informar o e-mail do agente diretamente ou por uma variável do fluxo, em vez de escolher da lista.

{% hint style="info" %}
Se você não selecionar nenhum agente específico (nem por lista, nem por e-mail), o módulo verifica se **qualquer agente** do departamento escolhido está online.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FPNzy7UttcNeze3mRuUWY%2Fimage.png?alt=media&amp;token=394cf882-05c7-4ccf-b6da-844929ff50fb" alt=""><figcaption><p>Imagem 5 - Campo Agente com a opção de lista a selecionar.</p></figcaption></figure>

***

#### 🔢 Usando o resultado

O resultado da verificação fica disponível como a variável `{{input.online}}` (verdadeiro ou falso) **apenas no módulo conectado logo em seguida**. A lista de agentes consultados também fica disponível em `{{input.agents}}`.

{% hint style="warning" %}
Se precisar usar esse resultado 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 deste módulo — caso contrário, a informação se perde nas etapas seguintes.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FvlXlq8eCJRhssRnY71kp%2F06-condicional-input-online.png?alt=media&amp;token=e45ac56c-b347-4180-9d4f-0ab3b41f06ff" alt=""><figcaption><p>Imagem 6 - Módulo Condicional logo em seguida, usando a variável {{input.online}} para decidir o próximo passo.</p></figcaption></figure>

***

#### 🔀 Saída do módulo

O módulo tem apenas uma saída, chamada **Continuar automaticamente**. Ela precisa estar ativada no painel de configuração para que o fluxo siga adiante depois da verificação.

{% hint style="warning" %}
Se você desativar a opção **Continuar automaticamente**, o módulo não terá nenhuma saída conectável, e o fluxo será interrompido nesse ponto. Deixe sempre essa opção ativada e conecte o próximo módulo (geralmente um **Condicional**) para aproveitar o resultado da verificação.
{% endhint %}

***

### 💡 Caso de uso

**Cenário:** uma empresa só quer transferir o atendimento para um humano quando realmente houver alguém disponível; caso contrário, prefere agendar um retorno.

**Configuração:**

1. Antes de transferir o atendimento, adicione o módulo **Agente Online** com o departamento de suporte.
2. Deixe o campo **Agente** vazio, para verificar qualquer agente do departamento.
3. Conecte um módulo **Condicional** logo em seguida, verificando se `{{input.online}}` é verdadeiro.
4. Se verdadeiro, siga para o módulo **Transferir para o atendente**. Se falso, siga para um fluxo de agendamento de retorno.

**Resultado:** o cliente só é transferido para um humano quando há alguém realmente disponível, evitando longas esperas sem resposta.

***

### 📌 Dicas úteis

* Use o resultado logo no módulo seguinte (geralmente um **Condicional**), ou salve-o em uma variável se precisar dele mais adiante no fluxo.
* Deixe o campo **Agente** vazio para verificar o departamento inteiro, ou selecione um agente específico para checar apenas ele.
* Mantenha a opção **Continuar automaticamente** sempre ativada — sem ela, o módulo não tem saída e o fluxo para nesse ponto.
* 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 **Agente Online** consulta se há um agente disponível em um departamento do Hyperflow Conversas.
* Pode verificar qualquer agente do departamento, ou um agente específico (por lista ou por e-mail).
* O resultado fica disponível como `{{input.online}}` (e `{{input.agents}}`) somente no módulo imediatamente seguinte.
* A opção **Continuar automaticamente** precisa estar ativada, senão o módulo fica sem saída.