Pergunta do Telegram

Visão Geral

O Componente de Pergunta do Telegram (identificado na interface como telegram_question) é um nó de interação outbound focado em coleta de dados e engajamento. Sua função principal é disparar uma pergunta ao usuário dentro do chat do Telegram e reter a automação em estado de espera (standby) até que uma resposta válida ocorra. Ele suporta tanto a coleta de entradas textuais tradicionais quanto interações baseadas em botões clicáveis, adaptando-se às regras de layout nativas do aplicativo.

Parâmetros de Configuração

A parametrização do bloco gerencia os formatos de exibição da mensagem e as regras de persistência das respostas no sistema:

• Tipo: Menu suspenso que define a mecânica de entrada do componente:

  • Texto: Aguarda uma resposta escrita manualmente pelo usuário.

  • Interativo (ou Interativo): Habilita o envio de botões clicáveis integrados à mensagem.

• Mensagem: Campo de texto para preenchimento do enunciado da pergunta que será enviada ao contato no chat.

• Possui Variável (Chave de Alternância - Toggle Switch): Habilita o armazenamento da resposta dada pelo cliente na memória interna do fluxo.

• Alvo da Resposta: Dropdown opcional para mapear o dado recebido diretamente a um campo padrão do perfil do contato no CRM (ex: Nome, E-mail, Telefone).

• buttons_type * (* Obrigatório se Interativo): Menu que seleciona o formato de renderização dos botões conforme os padrões de layout do Telegram:

  • Botão em linha: Cria botões anexados diretamente abaixo do balão da mensagem (Inline Keyboards).

  • Botão de teclado: Substitui temporariamente o teclado padrão do usuário no aplicativo por blocos de botões de resposta rápida (Reply Keyboards).

• Múltiplas Saídas (Chave de Alternância - Toggle Switch): Quando ativa, cria uma ramificação física no editor de fluxos para cada botão adicionado, permitindo caminhos personalizados para cada escolha.

Construtor Visual

A interface do construtor adapta seus campos de forma condicional conforme a opção escolhida no parâmetro Tipo:

• Layout Modular para Modo Interativo:S elecionar a modalidade Interativo destrava o parâmetro obrigatório buttons_type *. O painel expande verticalmente para exibir os repetidores onde o administrador insere os rótulos de texto de cada botão e decide o layout físico da grade de respostas.

• Validação por Asterisco: O seletor de formato de botões traz o indicativo de asterisco (*), sinalizando ao administrador que o nó não será validado ou salvo de forma incompleta se os botões nativos não forem criados.

Operadores Especiais

As propriedades lógicas deste componente lidam com callbacks nativos do Telegram e interpolação de tags:

• Manipulação de Callbacks Independentes (Inline vs Reply): O motor diferencia a lógica de clique:

  • Ao usar Botão em linha, o clique dispara um evento de callback_query em segundo plano, mantendo o histórico do chat limpo.

  • Ao usar Botão de teclado, a plataforma interpreta o clique como o envio de uma mensagem de texto contendo o nome do botão escolhido pelo usuário.

• Interpolação de Variáveis: O campo Mensagem é totalmente compatível com a sintaxe de chaves duplas {{...}}, permitindo personalizar a pergunta com base em dados coletados em nós anteriores (ex: "Entendido, {{nome}}! Qual o seu nível de satisfação?").

Exemplos Práticos

A tabela abaixo demonstra cenários tradicionais de aplicação deste componente no fluxo do Telegram:

Tipo Selecionado	Tipo de Botão (buttons_type)	Enunciado da Mensagem	Opções / Botões Configurados	Caso de Uso Prático
Texto	Nenhum	"Por favor, digite o seu e-mail corporativo:"	Nenhum (Entrada de texto livre)	Capturar o e-mail do contato de forma escrita para validar leads em uma esteira de vendas.
Interativo	Botão em linha	"Deseja receber as atualizações do pedido?"	[Sim], [Não]	Oferecer uma confirmação rápida por botões inline anexados ao próprio balão de aviso, gerando cliques limpos na tela.
Interativo	Botão de teclado	"Selecione o setor de atendimento:"	[Suporte], [Financeiro], [Vendas]	Mudar o teclado padrão do usuário no app por opções grandes de menu de triagem, facilitando o toque no celular.