As ferramentas de tempo de espera do OmniSiga permitem criar lógicas automatizadas e interações dinâmicas dentro dos processos do sistema. Elas são utilizadas no módulo de Configuração de Fluxos e servem para controlar navegações, temporizações e integrações externas.
Tempo de Espera Nomeado
Contexto
Usada quando é necessário aguardar um período determinado e, ao final desse período, direcionar o usuário para um nó específico do fluxo. O tempo é armazenado em uma variável para possível consulta ou cancelamento posterior.
Objetivo
Permitir o controle de timeout dentro do fluxo, possibilitando redirecionamentos automáticos após o término do TTL (Time To Live) configurado.
Campos Disponíveis
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Nome do elemento | Sim | Texto | Nome da caixa no fluxo (identificação visual). |
| Nome do tempo limite (variável) | Sim | Texto | Nome da variável que armazenará o identificador/tempo do TTL. |
| Nó de destino | Sim | Seleção de nó | Nó do fluxo para onde o usuário será encaminhado quando o TTL expirar. |
| TTL em minutos | Sim | Número (min) | Tempo a aguardar até que o timeout dispare. |
| Próximo nó | Opcional | Seleção de nó | Nó para onde o usuário seguirá enquanto aguarda o TTL. |
Exemplo de Tela
Legenda: caixa "Tempo de Espera Nomeado" com campos de configuração.
(espaço reservado para Print 1 — insira imagem
prints/tempo_espera_nomeado.png)
Exemplo de Uso
Fluxo: "Confirmação de Interesse"
- Envia mensagem solicitando confirmação.
- Insere um Tempo de Espera Nomeado com TTL = 5 minutos.
- Enquanto aguarda, fluxo segue para nó de coleta de logs (Próximo nó).
- Se o usuário não responder em 5 minutos, o Nó de destino recebe o usuário e envia mensagem de encerramento ou encaminha para atendimento humano.
Cancelar Tempo de Espera
Contexto
Usada para interromper um temporizador criado previamente por um Tempo de Espera Nomeado. Indicada quando uma ação do usuário torna obsoleto o timeout (por exemplo, confirmação antecipada).
Objetivo
Evitar que a ação configurada para o término do TTL seja executada quando não for mais necessária.
Campos Disponíveis
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Nome do elemento | Sim | Texto | Nome da caixa no fluxo. |
| Nome do tempo limite | Sim | Texto | Nome da variável do tempo que será cancelado (deve corresponder ao Nome do tempo limite criado anteriormente). |
| Próximo nó | Sim | Seleção de nó | Nó para onde o usuário deve ser enviado após o cancelamento. |
Exemplo de Tela
Legenda: caixa "Cancelar Tempo de Espera" com opção para apontar a variável do timeout.
(espaço reservado para Print 2 — insira imagem
prints/cancelar_tempo_espera.png)
Exemplo de Uso
Fluxo: "Confirmação de Agendamento"
- Após solicitar confirmação, foi criado um Tempo de Espera Nomeado com TTL = 10 minutos.
- Se o usuário confirmar antes de 10 minutos, o nó de confirmação acionará Cancelar Tempo de Espera apontando para a variável correspondente.
- Em seguida o fluxo segue para o nó de conclusão, evitando que a rotina de timeout envie lembretes ou cancele o agendamento.
Aguardar Comando Externo
Contexto
Fluxos que dependem de eventos externos (por exemplo, retorno de APIs de pagamento, sistemas parceiros ou processos assíncronos) usam essa caixa para ficar em espera até receber um comando via integração.
Objetivo
Permitir que o fluxo tome ações condicionais ao receber um comando externo, como executar scripts, armazenar dados recebidos ou apenas seguir o fluxo.
Campos Disponíveis
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Nome do elemento | Sim | Texto | Nome da caixa no fluxo. |
| Ações | Sim | Enum | Comportamento ao receber o comando externo: Não fazer nada, Executar script, Armazenar resposta. |
| Script (quando aplicável) | Condicional | Texto / Script | Script a ser executado quando a opção Executar script estiver selecionada. |
| Variável de armazenamento (quando aplicável) | Condicional | Texto | Nome da variável que receberá a resposta quando Armazenar resposta estiver selecionado. |
| Após receber, ir para | Sim | Seleção de nó | Nó de destino após o recebimento do comando externo. |
Exemplo de Tela
Legenda: caixa "Aguardar Comando Externo" com opções de ação.
(espaço reservado para Print 3 — insira imagem
prints/aguardar_comando_externo.png)
Exemplo de Uso
Fluxo: "Confirmação de Pagamento"
- O fluxo envia instrução para o gateway de pagamento externo e entra na caixa Aguardar Comando Externo.
- A opção selecionada é
Armazenar respostaem variávelpagamento_statuseApós receber, ir paranó de confirmação. - Quando o parceiro enviar via API que o pagamento foi aprovado, o OmniSiga armazena os dados e encaminha o usuário para o nó de confirmação e emissão de recibo.
Inatividade do cliente
Visão Geral
A caixa de Inatividade do cliente permite definir por quanto tempo o cliente pode permanecer sem interagir antes que ações automáticas sejam disparadas no fluxo.
Objetivo
Gerenciar atendimentos parados, permitindo:
- Enviar aviso de inatividade
- Finalizar automaticamente por inatividade
- Direcionar para o próximo passo adequado
Como Funciona
A caixa possui três parâmetros principais:
1. Tempo para Aviso de Inatividade do cliente
Define após quanto tempo sem interação o sistema enviará um aviso ao cliente.
2. Tempo para finalizar devido a inatividade do cliente
Define o tempo total de inatividade necessário para finalizar o atendimento automaticamente.
3. Próximos Passos
Configurar qual será o próximo bloco do fluxo caso:
- O aviso seja disparado
- A finalização seja atingida
Comportamento no Fluxo
- A contagem de inatividade passa a valer em todos os pontos do fluxo onde existe interação do usuário.
- Se o tempo configurado for atingido:
- O aviso é disparado automaticamente, ou
- O atendimento é finalizado, conforme o tempo definido.
- Cada evento (aviso e finalização) exige um próximo passo configurado.
- O sistema considera inatividade quando o cliente não envia mensagens ou não responde aos elementos interativos.
- A partir de uma caixa de Inatividade do cliente todas as interações na sequência do fluxo utilizarão o mesmo parâmetro de tempo.
Boas práticas de configuração
- Nomeie variáveis de forma única e descritiva, evitando colisões entre fluxos (ex.:
ttl_confirmacao_telefone). - Defina TTLs razoáveis: tempos muito curtos podem causar disparos indevidos; tempos muito longos podem manter fluxos presos e consumir recursos. Recomendação inicial: entre 3 e 30 minutos, dependendo do caso de uso.
- Sempre trate o caminho de "Próximo nó" para quando o usuário aguarda; isso facilita auditoria e logs.
- Evite loops de espera: se um fluxo aguarda um comando externo que nunca chega, implemente timeouts ou caminhos alternativos com
Tempo de Espera Nomeado+ alertas.