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

# Pergunta Facebook

### Visão Geral

O **Componente de Pergunta do Facebook Messenger** é um nó de ação focado em triagem, coleta de dados estruturados e enriquecimento de cadastros na plataforma. Sua função principal é enviar um enunciado ou questionamento diretamente para o chat privado (DM) do usuário no Facebook Messenger e aguardar uma resposta digitada de forma síncrona. A automação retém o contato nesta etapa até que um dado compatível seja informado, permitindo salvar o insumo e dar andamento ao fluxo de conversação.

### Parâmetros de Configuração

A parametrização do componente gerencia as regras de validação da entrada do usuário e o destino do armazenamento dos dados coletados:

* **Tipo:** Campo fixo e restrito do componente neste canal. Suporta unicamente a modalidade `Texto`, estabelecendo que todas as perguntas enviadas por este bloco aguardam exclusivamente respostas digitadas textualmente pelo usuário final (sem suporte a menus interativos de botões ou listas nativas da API).<br>
* **Mensagem (\* Campo Obrigatório):** O enunciado da pergunta ou instrução que o chatbot enviará na caixa de diálogo do cliente.<br>
* **Possui Variável (Chave de Alternância - Toggle Switch):** Quando ativada, habilita o salvamento do input digitado em um contêiner de memória, operando através de chaves estáticas (*Fixed*) ou dinâmicas (*Expression*).<br>
* **Variável (\* Obrigatório se ativo):** O nome da tag ou variável local (ex: `response`) criada para armazenar temporariamente o conteúdo da resposta.<br>
* **Alvo da Resposta:** Menu suspenso para mapear e salvar o dado de forma definitiva em propriedades do perfil do contato. As opções abrangem campos nativos e customizados como: `Nome`, `Telefone`, `E-mail`, `Endereço`, `CPF`, `CNPJ`, `Data`, `NPS`, `CSAT` ou um `custom_field`.<br>
* **Ignorar se a meta for cumprida (Chave de Alternância - Toggle Switch):** Se o contato já possuir dados válidos no campo selecionado em *Alvo da Resposta*, o componente pula esta etapa do fluxo silenciosamente para evitar perguntas redundantes.<br>
* **Aceitar resposta&#x20;*****(*****&#x20;Campo Obrigatório):** Filtro validador de dados que determina a sintaxe aceitável para o avanço do fluxo. O menu de buscas oferece os seguintes formatos de validação:
  * *Estruturas de Texto/Números:* `Texto`, `Número`, `Dados Válidos`.<br>
  * *Campos de Cadastro:* `Número de telefone`, `E-mail`, `CPF`, `CNPJ`, `Data`.<br>
  * *Pesquisas e Localização:* `NPS`, `CSAT`, `Localização`.<br>
  * *Formatos de Mídia:* `Áudio`, `Documento`, `Vídeo`, `Imagem`, `Contato`.<br>

### Construtor Visual

A interface gráfica foca em validação estrita de formulário e controle linear de processos na árvore de automação:

* **Campos Obrigatórios de Salvamento:** Diferente de nós informativos, a obrigatoriedade assinalada por asterisco (`*`) nos campos de *Mensagem* e *Aceitar resposta* impede que regras de conversação sejam publicadas com lacunas de validação, evitando travar o usuário em uma pergunta sem critérios de saída.<br>
* **Nó de Fluxo Sequencial com Validação:** No editor de design, o componente exibe uma porta de saída tradicional. No entanto, o motor da automação cria uma malha lógica invisível de repetição: se o cliente fornecer uma resposta que falhe no critério selecionado em *Aceitar resposta*, o bloco repete a mensagem original de forma contínua até receber um input compatível.<br>

### Operadores Especiais

As propriedades lógicas deste componente lidam com motores de máscara de dados e validação sintática (*input validation*) para canais de chat social:

* **Máscaras de Validação de Documentos e Dados:** Quando o campo *Aceitar resposta* está configurado para chaves específicas (como `CPF`, `CNPJ` ou `E-mail`), o motor interno aplica algoritmos de checagem na string digitada pelo usuário. Entradas que não correspondam à estrutura matemática de um CPF válido ou à sintaxe padrão de e-mail são rejeitadas de forma automática na camada de recebimento da API.<br>
* **Mapeamento Prévio de Variáveis Globais:** O campo *Mensagem* é compatível com interpretadores de strings através de chaves duplas (`{{...}}`). Isso possibilita que a pergunta enviada no Messenger utilize dados capturados em outros canais ou blocos (ex: "`{{nome}}`, confirme para nós o seu CPF, por favor:").<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários de uso do componente para realizar cadastros e triagens inteligentes através do Facebook Messenger:

| **Tipo Selecionado** | **Mensagem Configurada**                                   | **Alvo da Resposta / Variável**                                                                                    | **Aceitar resposta** | **Caso de Uso Prático**                                                                                                              |
| -------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `Texto`              | "Qual o número do seu CPF?"                                | <p><strong>Alvo:</strong> <code>CPF</code><br><br><br><br><strong>Variável:</strong> <code>cpf\_cliente</code></p> | `CPF`                | Capturar e validar o documento do usuário. Caso ele digite letras ou números incompletos, o sistema recusa e reapresenta a pergunta. |
| `Texto`              | "Por favor, digite a sua data de nascimento (DD/MM/AAAA):" | <p><strong>Alvo:</strong> <code>Data</code><br><br><br><br><strong>Variável:</strong> <code>nascimento</code></p>  | `Data`               | Coletar dados cronológicos para atualizar o perfil do contato e salvar na ficha cadastral do CRM da plataforma.                      |
| `Texto`              | "De 0 a 10, o quanto você recomendaria nosso serviço?"     | <p><strong>Alvo:</strong> <code>NPS</code><br><br><br><br><strong>Variável:</strong> <code>nota\_nps</code></p>    | `NPS`                | Rodar uma pesquisa de satisfação transacional direta por texto na DM do Facebook ao fim de uma jornada de suporte.                   |


---

# 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/facebook-components/pergunta-facebook.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.