Resumo

A Caixa de Pergunta é um dos elementos mais usados no construtor de chatbots WATI. Ela permite que você faça uma pergunta aos usuários e capture suas respostas. Você pode personalizá-la com opções de resposta pré-definidas, permitir entrada de texto livre, validar respostas e até mesmo salvar respostas como variáveis para uso posterior. Este guia cobre os principais recursos da Caixa de Pergunta, como configurá-la e considerações importantes ao usá-la.

Instruções

Partes da Caixa de Pergunta

Texto da Pergunta

O Texto da Pergunta é a pergunta real exibida para o usuário. Você pode:

Adicionar variáveis (ex: @{NomeDaVariável}) para personalizar a pergunta.
Incluir emojis para deixá-la mais envolvente.
Formatar o texto como negrito, itálico, ou riscado.

Variantes de Resposta

Variantes de Resposta são opções de resposta pré-definidas das quais os usuários podem escolher. Se as variantes de resposta forem fornecidas, os usuários devem responder digitando o número correspondente. Por exemplo:

Sim = 1
Não = 2 Se um usuário digitar 1, o chatbot registra a resposta como Sim. Se preferir permitir que os usuários insiram uma resposta de texto livre, basta deixar o campo Variantes de Resposta vazio.

Tratamento de Respostas Não Correspondentes (Opção de Recuo)

Se um usuário inserir uma resposta inesperada (ex: "oi" em vez de 1 ou 2), você pode configurar uma opção de recuo para direcionar o chatbot. A opção de recuo (rotulada como Geral) ajuda a lidar com entradas não reconhecidas redirecionando os usuários para outro fluxo do chatbot.

Salvando Respostas em uma Variável

As respostas dos usuários podem ser armazenadas em uma variável, que pode ser:

Usada em outra etapa do chatbot.
Verificada contra condições para lógica posterior.
Exibida novamente para o usuário. Por exemplo:
Caso 1: Armazenar a resposta do usuário em uma variável para uso futuro.

Caso 2: Verificar o valor de uma variável armazenada e acionar uma condição.

Opções Avançadas

Validação de Resposta de Texto

Se Variantes de Resposta não forem fornecidas, você pode habilitar Opções Avançadas para validar as respostas dos usuários. Isso garante que os usuários forneçam o formato de dados esperado.

Validação de Número

Requer que os usuários insiram um número dentro de um intervalo mínimo e máximo.
É possível definir mensagens de erro personalizadas (ex: "Por favor, digite um número entre 1 e 1000").
O chatbot pode ser configurado para sair se o usuário inserir respostas inválidas repetidamente.

Validação de Data

Formats aceitos: M/d/aaaa, MM/dd/aaaa, M/dd/aaaa, MM/d/aaaa.
Exemplo: 1/1/2021, 01/11/2021, 1/11/2021.

Validação de Data + Hora

Valida contra um formato de relógio de 12 horas.
Exemplos de formatos:
- M/d/aaaa h:mm:ss tt → 1/9/2021 8:00:00 AM
- MM/dd/aaaa hh:mm:ss → 12/25/2020 03:59:05

Validação de Hora

Aceita formatos como:
- hh:mm tt → 02:35 PM
- HH:mm:ss → 14:37:21
- h:mm:ss tt → 2:37:00 PM

Validação de Padrão (Regex)

Permite filtrar com base em expressões regulares (regex).
Exemplos:
- Apenas letras (sem números ou emojis): ^([a-zA-Z\s]+)$
- Formato de e-mail: ^([a-zA-Z0-9_\-\.]+)@([a-zA-Z0-9_\-\.]+)\.([a-zA-Z]{2,5})$
- Sem emojis permitidos: ^(?!.[^\u0020-\u007e\u00a0-\u00ff\u0152\u0153\u0178])$
- Handle do Instagram: ^instagram\.com/([a-zA-Z0-9_\-\.]+)$

Aceitando Respostas de Mídia

Anteriormente, se um usuário enviasse um arquivo de mídia para o chatbot, isso resultaria em um erro. Agora, você pode configurar o chatbot para aceitar arquivos de mídia como documentos, imagens ou vídeos.

Tipos de Mídia Suportados

Documentos
Imagens
Vídeos

Nota: Arquivos de áudio e notas de voz não são suportados.

Opções Avançadas para Resposta de Mídia

Garante que os usuários enviem o tipo de arquivo correto (ex: se uma imagem é solicitada, um PDF provocará um erro de validação).
Permite o download de arquivos de mídia usando o endpoint da API getMedia.
Salva o diretório do arquivo em uma variável para uso posterior.

Conclusão

A Caixa de Pergunta no construtor de chatbots WATI é uma ferramenta poderosa que permite interações estruturadas com os usuários. Quer você esteja coletando respostas Sim/Não simples, validando entradas ou lidando com arquivos de mídia, essas funcionalidades ajudam a melhorar a funcionalidade do chatbot. Configurando corretamente as opções de resposta, variáveis e definições de validação, você pode criar um chatbot fluido e amigável.

Perguntas Frequentes (FAQs)

Perguntas Gerais

O que é a Caixa de Pergunta no construtor de chatbots WATI? → A Caixa de Pergunta é um elemento de chatbot que permite fazer uma pergunta aos usuários e capturar suas respostas. Você pode personalizá-la com opções de resposta pré-definidas, permitir entrada de texto livre, validar respostas e armazenar respostas como variáveis.
Posso usar a Caixa de Pergunta para respostas pré-definidas e abertas? → Sim, você pode fornecer opções de resposta pré-definidas ou deixá-las em branco para permitir que os usuários insiram uma resposta de texto livre.

Variantes de Resposta e Opções de Recuo

Como as Variantes de Resposta pré-definidas funcionam? → As Variantes de Resposta permitem que os usuários escolham entre opções pré-definidas. Os usuários devem digitar o número correspondente para selecionar uma opção. Por exemplo:
- Sim = 1
- Não = 2
- Se o usuário digitar 1, o chatbot registra Sim como resposta.
O que acontece Se um usuário inserir uma resposta inesperada? → Se o usuário fornecer uma entrada não reconhecida, a opção de recuo (rotulada como "Geral") pode direcionar o chatbot para frente redirecionando os usuários para outro fluxo.

Salvando Respostas

Posso salvar as respostas dos usuários para uso futuro? → Sim, as respostas podem ser armazenadas em uma variável e usadas posteriormente no fluxo do chatbot para lógica condicional ou exibição.
Como Posso verificar o valor de uma variável armazenada? → Você pode configurar condições com base nos valores das variáveis armazenadas para acionar diferentes respostas ou ações do chatbot.

Validação de Resposta

Quais opções de validação estão disponíveis para respostas dos usuários? → Você pode habilitar Opções Avançadas para validação, que inclui:
- Validação de Número (intervalo Mín/Máx)
- Validação de Data (formato específico requerido)
- Validação de Hora (vários formatos)
- Validação de Padrão (Regex) (regras personalizadas)
Como a validação de número funciona? → Os usuários devem inserir um número dentro do intervalo definido. Se eles fornecerem uma resposta inválida várias vezes, o chatbot pode ser configurado para sair.
Quais Formatos de data são suportados na Validação de Data? → Os formatos suportados incluem:
- M/d/aaaa (1/1/2021)
- MM/dd/aaaa (01/11/2021)
- M/dd/aaaa (1/11/2021)
- MM/d/aaaa (01/9/2021)
Como a validação regex funciona? → A validação regex permite que você exija formatos específicos. Por exemplo:
- Somente letras (sem números/emojis): ^([a-zA-Z\s]+)$
- Formato de e-mail: ^([a-zA-Z0-9_\-\.]+)@([a-zA-Z0-9_\-\.]+)\.([a-zA-Z]{2,5})$

Respostas de Mídia

A Caixa de Pergunta pode aceitar respostas de mídia? → Sim, você pode configurá-la para aceitar imagens, documentos e vídeos. Arquivos de áudio e notas de voz não são suportados.
O que acontece se o usuário enviar o tipo de arquivo errado? → Se a validação de mídia estiver habilitada, o chatbot exibirá uma mensagem de erro se o usuário enviar um formato de arquivo incorreto (ex: um PDF em vez de uma imagem).
Como posso fazer download das respostas de mídia enviadas pelos usuários? → Quando as respostas de mídia são salvas, seu diretório de arquivo é armazenado em uma variável. Você pode usar o endpoint da API getMedia para fazer download do arquivo.

Usando a Caixa de Perguntas no Construtor de Chatbots