> 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

## 🟢 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.

**📷 Inserir print:** visão geral do módulo Agente Online na área de trabalho do fluxo

***

### 🧭 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.

**📷 Inserir print:** painel de módulos com a categoria Atendimento expandida e o módulo Agente Online visível

{% 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.

**📷 Inserir print:** painel de configuração do módulo Agente Online aberto

***

#### 🏢 Departamento

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

**📷 Inserir print:** campo Departamento com a lista de departamentos disponíveis

***

#### 🧑‍💼 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 %}

**📷 Inserir print:** campo Agente com a opção de lista e a chave de busca por e-mail ativada

***

#### 🔢 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 %}

**📷 Inserir print:** módulo Condicional logo em seguida, usando a variável `{{input.online}}` para decidir o próximo passo

***

#### 🔀 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 %}

**📷 Inserir print:** módulo com a opção Continuar automaticamente ativada e conectado ao próximo módulo

***

### 💡 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.