Esperar
Pausar a execução por um intervalo de tempo antes de continuar.
O que faz
Pausa a execução do fluxo por um intervalo de tempo definido. Por padrão, a espera acontece dentro da própria execução, por até 5 minutos. Ative Assíncrono para pausar a execução em disco e retomá-la automaticamente em esperas de até 30 dias.
Quando usar: Use quando o seu fluxo precisar pausar a execução por um intervalo de tempo antes de continuar.
Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.
Antes de começar
Conexão necessária: Sem conexão externa obrigatória.
Nenhuma conta externa é obrigatória para usar este bloco.
Passo a passo
- Adicione Esperar ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Nenhuma conta externa é obrigatória para usar este bloco.
- Revise a ação principal descrita no cartão do bloco.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Campos
Tempo de espera
ObrigatórioMáximo de 5 minutos (300 segundos). Ative Assíncrono para esperar até 30 dias.
- Padrão:
- 10
- Exemplo:
- 09:00
Unidade
Obrigatório conforme a operaçãoDefine a data, o horário ou a programação usada pela operação.
- Quando aparece:
- Quando o campo “Assíncrono” for diferente de “true”
- Opções:
- Segundos · Minutos
- Padrão:
- Segundos
Unidade
Obrigatório conforme a operaçãoDefine a data, o horário ou a programação usada pela operação.
- Quando aparece:
- Quando o campo “Assíncrono” for “true”
- Opções:
- Minutos · Horas · Dias
- Padrão:
- Minutos
Assíncrono
Ativa ou desativa este comportamento.
- Exemplo:
- false
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <esperar.waitDuration>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<esperar.waitDuration> | number | Duração da espera em milissegundos. |
<esperar.status> | string | Status do bloco de espera (waiting = aguardando, completed = concluído, cancelled = cancelado). |
<esperar.resumeAt> | string | Data e hora (ISO) em que uma espera suspensa será retomada (só em esperas longas). |
Exemplo de uso
Objetivo: Processar os dados antes de seguir para a próxima etapa.
- Tempo de espera
- 09:00
- Unidade
- Segundos
- Unidade
- Minutos
- Assíncrono
- false
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <esperar.waitDuration>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
Blocos relacionados
- AgendamentoIniciar a execução automaticamente nos dias e horários programados.
- Aguardar uma pessoaPausar a execução e aguardar uma decisão ou informação fornecida por uma pessoa.
- AnotaçãoAdicionar uma anotação visual ao desenho do fluxo sem executar uma ação.
- APIExpor um endpoint HTTP legado para iniciar o fluxo; em fluxos novos, prefira o bloco Início.
- AvaliadorAvaliar um conteúdo com critérios definidos e devolver uma nota ou conclusão.
- Base de conhecimentoPesquisar semanticamente nas bases de conhecimento disponíveis.