Use a API de Entrada do utilizador etapa para capturar as respostas dos usuários e armazená-las como variáveis no contexto do bot.
👍 Nota: assim que o fluxo chega a uma etapa de Entrada do Usuário, o bot será pausado, permanecerá no fluxo e aguardará estritamente a resposta do usuário antes de continuar. Nenhuma outra intenção ou caso de uso poderá ser acionado enquanto esta etapa estiver ativa. Isso garante que você sempre colete os dados exatos de que precisa, no formato correto e na ordem que definiu.
Quando usar?
Use uma etapa de Entrada do Usuário sempre que precisar:
Obrigar o usuário a responder a uma pergunta específica antes de prosseguir.
Validar a resposta (e-mail, regex, seleção em uma lista) imediatamente.
Limitar a conversa a esse único ponto de coleta de dados.
Tipos de validação da Entrada do Usuário
Há vários tipos de variáveis e métodos de validação ao coletar entradas dos usuários:
Texto livre: Captura qualquer resposta do usuário sem validação.
Endereço de e-mail: Garante que a entrada corresponda a um formato de e-mail válido.
Regex: Valida a entrada em relação a um formato específico usando expressões regulares (exemplos úteis de regex podem ser encontrados aqui).
Seleção: Apresenta aos usuários opções predefinidas por meio de Respostas rápidas; apenas uma opção pode ser selecionada.
Concentre-se na coleta de entradas do usuário por meio de opções predefinidas
Usando o tipo de validação Seleção, você pode apresentar aos usuários uma lista de opções para escolher. Essas opções são exibidas como Respostas rápidas.
Etapas de configuração:
Defina uma variável.
Atribua um título à opção da Resposta rápida.
Defina o valor dos dados para armazenamento (o valor salvo na variável).
⏮️ O novo prompt é o texto de fallback que o bot envia sempre que a resposta do usuário não corresponde ao formato esperado ou às regras de validação. O bot continuará repetindo esta mensagem — e aguardando uma resposta correta — até que o usuário forneça uma resposta válida ou toque explicitamente em “Cancelar”/“Pular”.
Modificando a Entrada do Usuário
1. Voltar
Ativar o botão "Voltar" permite que os usuários retornem à etapa anterior e substituam o valor de uma Entrada do Usuário.
2. Verificação de dados
Peça aos usuários que verifiquem a precisão das informações coletadas e permita que façam correções.
Comportamento:
Clicar em "Confirmar e continuar" leva o usuário à próxima etapa do fluxo.
Clicar em "Alterar nome" ou "Alterar idade" leva o usuário a uma subetapa para modificar a informação selecionada.
Detalhes:
A mensagem que solicita o fornecimento de um valor, acionada quando um usuário pede para alterar uma variável, é única para todas as variáveis e pode ser configurada na seção "Configurar" de Verificação de dados.
Quando uma variável com regras de validação (por exemplo, um e-mail) é modificada por meio de uma etapa de Verificação de dados, as regras de validação continuam sendo aplicadas.
Handover tag
Se o seu User Input faz parte de uma transferência para um atendente humano que não usa uma etapa Live Chat Handover nem Ticket Handover (por exemplo, uma solicitação seguida de uma chamada API à sua ferramenta de suporte), abra a aba Advanced e ative Mark as handover tag na seção Handover tag. O Analytics passa então a contar a conversa na sua taxa de handover. O handover é registrado quando o bot faz a pergunta.
Essa configuração não é oferecida na etapa File Upload. Para ver como funciona em detalhe, consulte Answers.