Pergunta do WhatsApp

Visão Geral

O Componente de Pergunta do WhatsApp é um nó de ação focado na coleta de dados, triagem e construção de diálogos estruturados. Sua função principal é enviar uma pergunta diretamente ao cliente e aguardar uma resposta em tempo real. O fluxo de automação entra em estado de espera (standby) neste componente até que o usuário responda com um dado válido, permitindo armazenar a resposta informada e ramificar a árvore de automação de acordo com a escolha ou conteúdo digitado.

Parâmetros de Configuração

A parametrização do componente define a estrutura de exibição da pergunta e as regras de armazenamento de dados:

• Tipo: Determina a mecânica de interação da pergunta enviada:

  • Texto: Envia uma mensagem de texto simples e aguarda uma resposta digitada manualmente pelo cliente.

  • Interactive: Envia formatos nativos de botões ou listas interativas da API do WhatsApp.

• _Mensagem ( Campo Obrigatório):_* O conteúdo ou enunciado da pergunta que será exibido para o cliente.

• Possui Variável (Chave de Alternância - Toggle Switch): Quando ativada, habilita o armazenamento da resposta. Pode operar em modo Fixed (variável estática da plataforma) ou Expression (expressão dinâmica).

• _Variável ( Obrigatório se ativo):_* Define o nome do contêiner interno (ex: response) que receberá o valor da resposta.

• Alvo da Resposta: Permite mapear e salvar o dado recebido diretamente em campos nativos ou personalizados do contato, como Nome, E-mail, Endereço, NPS, CSAT ou um custom_field (campo personalizado).

• Ignorar se a meta for cumprida (Chave de Alternância - Toggle Switch): Se o contato já tiver o campo alvo preenchido previamente em seu perfil, o componente pula a pergunta automaticamente e avança para o próximo nó sem incomodar o usuário.

• Aceitar resposta: Filtro de validação de dados que estabelece o que é uma resposta válida. Para perguntas do tipo Texto, restringe a entrada a formatos como: Texto, Número, Número de telefone, E-mail, Localização ou Áudio. Se o usuário enviar algo fora do formato (ex: mandar uma imagem quando se espera um e-mail), o sistema rejeita e repete a pergunta.

Construtor Visual

A interface do construtor se adapta e expande dinamicamente de acordo com as propriedades selecionadas no campo Tipo:

Configuração para o Tipo Interactive

Ao alternar o tipo para interativo, o componente exibe o campo Tipo de Resposta para definir o layout dos botões:

• Opção Botões (Quick Replies): Permite construir botões de clique rápido que aparecem abaixo da mensagem. A interface limita a criação a no máximo 3 botões.

• Opção Lista (List Messages): Transforma a interação em um menu de opções limpo. Ao selecionar essa modalidade, o formulário visual expande e exige os seguintes campos obrigatórios:

  • Botão para abrir lista *: O texto que aparecerá no botão principal de clique (ex: "Selecionar").

  • Título da Seção *: O cabeçalho da janela que agrupa os itens.

  • Lista: Bloco repetidor onde o administrador usa o botão + Add item para incluir as opções nominais de escolha (Botão) e textos de apoio (Descrição). A interface limita a criação a no máximo 10 itens de lista.

• Múltiplas Saídas: Chave de alternância que, se ativada, gera uma porta física de saída no editor gráfico para cada botão ou item de lista criado, permitindo desenhar caminhos totalmente customizados para cada resposta do usuário.

Operadores Especiais

As propriedades lógicas deste componente lidam com validação de tipos de dados (data validation) e gerenciamento de estado de inputs:

• Validador de Regex e Tipos Nativos: Quando configurado para aceitar apenas E-mail ou Número de telefone, o componente roda um script de validação sintática na resposta do cliente. Se a validação falhar, o motor bloqueia o avanço do fluxo e repete a mensagem de pergunta.

• Mapeamento de Metadados Interactive: Em perguntas do tipo Interactive estruturadas como lista, o campo Aceitar resposta altera seu escopo padrão para o modo Dados Válidos. O sistema valida se o texto clicado corresponde exatamente a um dos IDs estruturados na lista do construtor, ignorando textos aleatórios digitados pelo usuário durante aquela etapa do menu.

Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de aplicação deste componente para guiar interações inteligentes via WhatsApp:

Tipo Selecionado	Configuração do Construtor	Alvo da Resposta / Variável	Caso de Uso Prático
Texto	Mensagem: "Qual o seu e-mail?" Aceitar resposta: E-mail	Alvo: E-mail Variável: email_cliente	Capturar e validar o e-mail do cliente. Se ele digitar algo sem @, o sistema repete a pergunta até receber um e-mail válido.
Interactive (Botões)	Mensagem: "Você já é cliente?" Botões: [Sim] , [Não]	Variável: ja_e_cliente Múltiplas Saídas: Ativado	Criar um menu de triagem inicial rápido com 2 botões, ramificando o fluxo para caminhos diferentes baseados no clique do usuário.
Interactive (Lista)	Mensagem: "Escolha uma opção de serviço" Itens (Máx 10): [Suporte], [Vendas], [Financeiro]	Alvo: custom_field Múltiplas Saídas: Ativado	Apresentar um menu de opções robusto em formato de lista (Menu de Opções) para direcionar o cliente para os setores corretos da empresa.