Aguardar uma pessoa
Pausar a execução e aguardar uma decisão ou informação fornecida por uma pessoa.
O que faz
Combina as funções de resposta e de início. Envia respostas estruturadas e permite que o fluxo seja retomado a partir deste ponto.
Quando usar: Use quando o seu fluxo precisar pausar a execução e aguardar uma decisão ou informação fornecida por uma pessoa.
Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.
Enquanto aguarda a pessoa, a execução permanece pausada. Defina claramente quem pode responder e o que acontece em caso de demora.
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 Aguardar uma pessoa 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
Campos da resposta
Defina a estrutura dos dados da resposta. Use <variable.nome> nos nomes dos campos para referenciar variáveis do fluxo.
Notificação
Configure ferramentas de notificação para avisar quem aprova (ex.: Slack, e-mail).
- Padrão:
- []
- Exemplo:
- (selecione as ferramentas permitidas)
Campos de entrada
Defina os campos que a pessoa pode preencher ao retomar.
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 <aguardarumapessoa.url>: 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 |
|---|---|---|
<aguardarumapessoa.url> | string | URL da tela de retomada. |
<aguardarumapessoa.resumeEndpoint> | string | URL do endpoint da API de retomada, para requisições diretas com curl. |
<aguardarumapessoa.response> | json | Dados exibidos para quem aprova. |
<aguardarumapessoa.submission> | json | Dados do formulário enviados por quem aprova. |
<aguardarumapessoa.resumeInput> | json | Dados brutos de entrada enviados na retomada. |
<aguardarumapessoa.submittedAt> | string | Data e hora ISO em que o fluxo foi retomado. |
Exemplo de uso
Objetivo: Processar os dados antes de seguir para a próxima etapa.
- Notificação
- (selecione as ferramentas permitidas)
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 <aguardarumapessoa.url>. 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.
- 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.
- CondiçãoAvaliar uma condição e escolher por qual saída o fluxo deve continuar.