> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/telegram-components/pergunta-do-telegram.md). # 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. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/telegram-components/pergunta-do-telegram.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.