Conecta-seEntrar na plataforma

Esperar

Esperar um tempo, uma resposta validada do cliente ou um evento externo, como um pagamento.

Lógica e processamentoRecurso internoConexão: Sem conexão externa obrigatória

O que faz

Espera um tempo, uma resposta do cliente (com validação) ou um evento externo, como a confirmação de um pagamento.

Quando usar: Use quando o seu fluxo precisar esperar um tempo, uma resposta validada do cliente ou um evento externo, como um pagamento.

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

  1. Adicione Esperar ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Nenhuma conta externa é obrigatória para usar este bloco.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Esperar por

    Escolhe uma das opções aceitas por este campo.

    Opções:
    Tempo · Resposta do cliente · Evento externo
    Padrão:
    Resposta do cliente
    Exemplo:
    Tempo

  • Até quando

    Define a data, o horário ou a programação usada pela operação.

    Quando aparece:
    Quando o campo “Esperar por” for “Tempo”
    Opções:
    Por um tempo · Até uma data e hora · Até a próxima abertura do atendimento
    Padrão:
    Por um tempo

  • Duração

    Define por quanto tempo a execução deve aguardar.

    Quando aparece:
    Quando o campo “Esperar por” for “Tempo” e o campo “Até quando” for “Por um tempo”
    Padrão:
    {"amount":1,"unit":"hours"}

  • Data e hora

    AAAA-MM-DD HH:mm.

    Quando aparece:
    Quando o campo “Esperar por” for “Tempo” e o campo “Até quando” for “Até uma data e hora”
    Exemplo:
    2026-09-15

  • Fuso da data

    Define a data, o horário ou a programação usada pela operação.

    Quando aparece:
    Quando o campo “Esperar por” for “Tempo” e o campo “Até quando” for “Até uma data e hora”
    Exemplo:
    09:00

  • Interromper se o cliente escrever

    Ativa ou desativa este comportamento.

    Quando aparece:
    Quando o campo “Esperar por” for “Tempo”
    Padrão:
    false

  • Variação aleatória

    Em campos adicionais

    Espalha os disparos para não acordar todas as conversas no mesmo segundo.

    Quando aparece:
    Quando o campo “Esperar por” for “Tempo”

  • Tipo de resposta

    Escolhe uma das opções aceitas por este campo.

    Quando aparece:
    Quando o campo “Esperar por” for “Resposta do cliente”
    Opções:
    Texto · Número · E-mail · Telefone · CPF · CNPJ · Data · Sim ou não · Imagem · Documento · Áudio · Localização · Expressão regular
    Padrão:
    Texto

  • Expressão regular

    Até 200 caracteres; expressões que podem travar são recusadas na publicação.

    Quando aparece:
    Quando o campo “Esperar por” for “Resposta do cliente” e o campo “Tipo de resposta” for “Expressão regular”

  • Salvar resposta em

    Nome da variável do fluxo que guarda a resposta.

    Quando aparece:
    Quando o campo “Esperar por” for “Resposta do cliente”
    Exemplo:
    nomeDaVariavel

  • Dado sensível

    Mascara a resposta na trilha e nos registros.

    Quando aparece:
    Quando o campo “Esperar por” for “Resposta do cliente”
    Padrão:
    false

  • Tentativas

    Define um valor numérico, quantidade ou limite da operação.

    Quando aparece:
    Quando o campo “Esperar por” for “Resposta do cliente”
    Padrão:
    2
    Exemplo:
    10

  • Mensagem de resposta inválida

    Informa o conteúdo de texto que será enviado ou processado.

    Quando aparece:
    Quando o campo “Esperar por” for “Resposta do cliente”
    Padrão:
    Não consegui entender. Pode mandar de novo?
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Juntar mensagens picotadas (segundos)

    Segundos de espera para juntar mensagens que o cliente manda picotadas (ex.: “oi”, “quero”, “a segunda via”) antes de validar a resposta. 0 valida cada mensagem sozinha.

    Quando aparece:
    Quando o campo “Esperar por” for “Resposta do cliente”
    Padrão:
    0

  • Sem resposta em

    Tempo máximo esperando a resposta. Passado esse tempo, o fluxo sai pela saída “Sem resposta”. Vazio ou 0 espera até a validade da sessão.

    Quando aparece:
    Quando o campo “Esperar por” for “Resposta do cliente”
    Padrão:
    {"amount":30,"unit":"minutes"}

  • Chave do evento

    Obrigatório conforme a operação

    Aceita variáveis. O mesmo valor precisa chegar no evento externo para a conversa seguir.

    Quando aparece:
    Quando o campo “Esperar por” for “Evento externo”
    Exemplo:
    pix:identificador-da-cobranca

  • Sem evento em

    Define a data, o horário ou a programação usada pela operação.

    Quando aparece:
    Quando o campo “Esperar por” for “Evento externo”
    Padrão:
    {"amount":1,"unit":"days"}
    Exemplo:
    30000

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.resposta>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<esperar.resposta>jsonResposta validada: texto, valor normalizado e mídia, quando houver.
<esperar.evento>jsonDados do evento externo recebido.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

InícioEsperarpróxima etapa
Esperar por
Tempo
Até quando
Por um tempo
Duração
{"amount":1,"unit":"hours"}
Data e hora
2026-09-15
Fuso da data
09:00
Interromper se o cliente escrever
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.resposta>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Blocos relacionados