Builder · Atualizado em 06/10/2026
Como pedir uma resposta no Builder
Configure a Entrada do usuário: aguarde a resposta, guarde em variável, valide o formato e defina o tempo de inatividade.
A Entrada do usuário é o ponto do bloco em que o fluxo para e espera o contato escrever. Tudo o que o robô disse antes (textos, menus, mídias) é enviado primeiro; depois o Builder aguarda a resposta e decide o próximo bloco pelas condições de saída.
Quando usar
- Para perguntar nome, e-mail, número do pedido ou qualquer dado livre.
- Para coletar a resposta de um menu ou quick reply.
- Para impedir respostas fora do formato esperado (um número, uma data, um padrão).
- Para encadear mensagens sem esperar o contato, usando Não aguardar.
Pré-requisitos
- Acesso de edição a um fluxo no Builder.
- Um bloco com a pergunta já escrita. Um bloco novo do tipo Padrão já traz a Entrada do usuário.
Passo a passo
- No canvas, clique no bloco da pergunta e vá para a aba Conteúdo.
- Escreva a pergunta com um conteúdo Texto. Veja Como adicionar texto a um bloco no Builder.
- Localize o cartão Entrada do usuário, sempre o último da lista. Se ele não existir, clique em + Adicionar conteúdo e escolha Entrada do usuário.
- Clique no cartão para abri-lo.
- Escolha Aguardar resposta para esperar o contato ou Não aguardar para seguir direto.
- Para guardar o que o contato escrever, preencha o campo Variável em Salvar resposta em variável, por exemplo
emailCliente. - Para exigir um formato, marque Validar a entrada do usuário.
- Em Tipo de validação, escolha Texto, Número, Data, Expressão regular ou Tipo.
- Se escolheu Expressão regular, escreva o padrão no campo Expressão regular. Se escolheu Tipo, informe o tipo esperado, como
image/jpeg, no campo Tipo. - Revise a Instrução de validação, a mensagem enviada quando a resposta não servir.
- Para limitar a espera, marque Tempo de inatividade e informe os minutos em Tempo limite (minutos).
- Abra a aba Condições de saída e defina para onde a conversa vai depois da resposta.
Campos da tela
| Campo | Para que serve |
|---|---|
| Aguardar resposta / Não aguardar | Define se o fluxo espera o contato. O cartão indica "Aguardando resposta do usuário" ou "Ir direto para o próximo passo" |
| Variável | Nome em que a resposta é guardada. Só letras, números e pontos. Para usar depois, escreva {{NomeDaVariável}} |
| Validar a entrada do usuário | Liga a conferência da resposta |
| Tipo de validação | Texto, Número, Data, Expressão regular ou Tipo |
| Instrução de validação | Mensagem enviada quando a validação falha. É obrigatória quando a validação está ligada |
| Tempo de inatividade | Liga o prazo máximo de espera |
| Tempo limite (minutos) | Inteiro de 1 a 1380 |
O que cada validação aceita
| Tipo | Aceita | Instrução sugerida pelo editor |
|---|---|---|
| Texto | Mensagem de texto | Digite um texto |
| Número | Dígitos, com sinal opcional, ponto como decimal e vírgula tratada como separador de milhar | Digite um número válido |
| Data | Formatos como 25/12/2026, 25-12-2026, 25/12 e 2026-12-25T10:00:00Z; datas impossíveis, como 31/02, são recusadas | Por favor, utilize o formato DD/MM/YYYY |
| Expressão regular | Respostas que casam com o padrão informado | Digite de acordo com o padrão acima |
| Tipo | Mensagens cujo tipo seja exatamente o informado, como image/jpeg | Não entendi, formato não esperado |
Exemplo na Loja Girassol
No bloco Pedir número do pedido, a Loja Girassol escreve o Texto "Qual o número do seu pedido?", escolhe Aguardar resposta, guarda em numeroPedido, marca Validar a entrada do usuário com o tipo Número e a instrução "Envie só os números do pedido". Se o contato mandar "meu pedido", recebe a instrução e continua no mesmo bloco; ao enviar "48213", o fluxo segue e o bloco seguinte pode escrever {{numeroPedido}}.
Resultado esperado
O fluxo para no bloco, recebe a resposta válida, guarda o valor na variável (quando informada) e segue pelas condições de saída.
Boas práticas
- Dê à variável um nome que diga o que ela guarda, como
emailCliente. - Escreva a instrução de validação dizendo como responder certo, não apenas que errou.
- Defina um tempo de inatividade quando a pergunta puder ficar sem resposta por muito tempo.
- Teste uma resposta válida e uma inválida no painel de teste. Veja Como testar um fluxo no Builder.
Limitações
- Só existe uma Entrada do usuário por bloco, sempre ao final da lista de conteúdos.
- Na validação por Expressão regular e por Tipo, os campos são obrigatórios; sem eles o editor aponta erro.
- No bloco Início a espera é fixa: não há a escolha Não aguardar. No bloco Humano, o cartão só permite guardar a resposta em variável: não há validação nem tempo de inatividade.
- O tempo de inatividade vai até 1380 minutos (23 horas).
Problemas comuns
- O nome da variável foi recusado: há espaço, hífen ou acento. Use só letras, números e pontos.
- O contato fica preso na mesma pergunta: a validação está recusando a resposta. Confira o tipo escolhido e o padrão, e teste com um exemplo válido.
- O fluxo não segue depois da resposta: o bloco não tem condição de saída nem saída padrão com destino.
- O campo de minutos mostra erro: informe um número inteiro de 1 a 1380.
Próximos passos
Perguntas frequentes
Todo bloco precisa de Entrada do usuário?
Não obrigatoriamente. Um bloco novo do tipo Padrão já nasce com ela, mas você pode escolher Não aguardar para seguir direto ao próximo bloco sem esperar o contato.
O que acontece se a resposta for inválida?
Quando a validação está ligada, o Pipe envia a Instrução de validação ao contato e o fluxo continua no mesmo bloco, esperando uma nova resposta.
Que nome posso dar à variável?
Use letras, números e pontos. Qualquer outro caractere faz o editor apontar erro.
O que é o tempo de inatividade?
Um limite de 1 a 1380 minutos. Se o contato não responder nesse prazo, o fluxo segue como se não houvesse resposta: pela saída padrão ou por uma condição que trate a ausência de resposta.
Esse artigo foi útil?
Obrigado pelo retorno!