For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.


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


🔍 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.

🏢 Departamento

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

🧑‍💼 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.

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.

🔢 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}}.

🔀 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.


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

Last updated