> 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/instagram-components/pergunta-do-instagram.md).

# Pergunta do Instagram

### Visão Geral

O **Componente de Pergunta do Instagram** é um nó de interação focado em capturar dados, qualificar leads e conduzir conversas estruturadas dentro do ambiente de mensagens diretas (DM). Sua função principal é enviar uma pergunta ao usuário e reter o fluxo em estado de espera (*standby*) até que uma resposta válida seja digitada. Por limitações de layout ou da API deste canal específico, o componente funciona de forma estritamente linear através de caixas de entrada de texto, não oferecendo suporte a botões de clique rápido ou listas interativas.

### Parâmetros de Configuração

A parametrização do nó determina o comportamento do diálogo e o destino das strings capturadas pelo chatbot:

* **Tipo:** Campo restrito e padronizado na modalidade `Texto`. Indica que toda a interação do bloco dependerá de uma resposta escrita manualmente pelo usuário no chat.<br>
* **Mensagem:** Caixa de texto onde o administrador digita o enunciado da pergunta (ex: "Qual o seu melhor e-mail?").<br>
* **Possui Variável (Chave de Alternância - Toggle Switch):** Quando ligada, permite que a plataforma guarde o que o cliente digitou em uma chave de memória para uso posterior na automação.<br>
* **Variável (\* Obrigatório se ativo):** Campo de entrada para definir o nome do contêiner que receberá a resposta (o padrão visual sugerido é `response`).<br>
* **Alvo da Resposta:** Menu suspenso para sincronizar o input recebido diretamente com a ficha cadastral do cliente no CRM interno. Suporta campos como: `Endereço`, `CSAT`, `custom_field` (campo personalizado), `E-mail`, `Nome` e `NPS`.<br>
* **Aceitar resposta&#x20;*****(*****&#x20;Campo Obrigatório):** O validador de dados (*data validation*) que define o formato que a resposta precisa ter para que o fluxo continue. O menu oferece filtros como: `Texto`, `Número`, `Dados Válidos`, `Número de telefone`, `E-mail` e `Localização`.<br>

### Construtor Visual

A interface do construtor preza pelo preenchimento rápido e foca no controle rígido de validação sintática das mensagens recebidas:

* **Formulário Linear Simplificado:** Devido à ausência de estruturas complexas de mídia interativa (como botões e listas nativas), o construtor exibe um layout limpo de cima a baixo, onde o asterisco (`*`) reforça a obrigatoriedade de estipular um critério de aceitação de resposta para salvar o nó.<br>
* **Comportamento de Repetição Oculto:** No editor de fluxos, este componente conta com uma porta de saída tradicional. No entanto, o motor lárvico da plataforma gera um loop automático: caso o usuário digite algo que não passe no filtro selecionado em *Aceitar resposta* (ex: digitar texto comum quando o campo exige um `E-mail`), a automação barra o avanço e repete a pergunta original.<br>

### Operadores Especiais

As propriedades de processamento lógico deste componente controlam a integridade dos dados inseridos antes de integrá-los aos perfis:

* **Validação Sintática por Expressão regular (Regex Nativo):** Quando configurado para validar formatos específicos (como `E-mail` ou `Número de telefone`), o motor interno analisa se a estrutura de caracteres atende aos padrões globais (presença de `@` e domínios válidos no e-mail, por exemplo). Se o input for inválido, o fluxo bloqueia a gravação nos campos do CRM para evitar dados corrompidos.<br>
* **Interpolação de Strings na Mensagem:** A caixa de texto do campo *Mensagem* aceita o uso de chaves duplas `{{...}}` para resgatar dados que a automação já possui sobre o contato, tornando o questionamento mais humano e personalizado (ex: "Perfeito, `{{nome}}`! Agora digite o seu telefone com DDD:").<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de aplicação deste componente para guiar atendimentos automatizados no Instagram de forma segura:

| **Tipo Selecionado** | **Mensagem Configurada**                       | **Alvo da Resposta** | **Aceitar resposta** | **Caso de Uso Prático**                                                                                                                |
| -------------------- | ---------------------------------------------- | -------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `Texto`              | "Qual o seu nome completo?"                    | `Nome`               | `Texto`              | Capturar o nome do usuário que acabou de interagir com o bot e atualizar o cadastro dele na plataforma.                                |
| `Texto`              | "Digite seu e-mail para receber o catálogo:"   | `E-mail`             | `E-mail`             | Capturar o e-mail para campanhas de marketing. Se o usuário digitar um texto qualquer sem formato de e-mail, o sistema repete o bloco. |
| `Texto`              | "Por favor, informe um telefone para contato:" | `custom_field`       | `Número de telefone` |                                                                                                                                        |


---

# 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/instagram-components/pergunta-do-instagram.md?ask=<question>&goal=<endgoal>
```

`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.
