> ## Documentation Index > Fetch the complete documentation index at: https://docs.maketalk.ai/llms.txt > Use this file to discover all available pages before exploring further. # Bloco Qualificação > Colete dados do lead de forma estruturada e envie para seu CRM, webhook ou fluxo comercial ## O que é o Bloco Qualificação? O bloco **Qualificação** permite que o agente colete dados estruturados do lead durante a conversa — nome, email, empresa, faturamento, cargo, o que você precisar. Os dados são coletados de forma natural (conversacional) ou direta (pergunta a pergunta), validados e enviados para o destino configurado: webhook, CRM Chatwoot ou ambos. ### Por que usar? | Benefício | Descrição | | ------------------------- | -------------------------------------------------------------------- | | **Coleta garantida** | O sistema garante que todos os campos obrigatórios sejam preenchidos | | **Conversacional** | A IA puxa os dados das mensagens, sem parecer formulário | | **Integração CRM** | Pode criar um deal direto no CRM do Chatwoot quando qualifica | | **Webhook para N8N/Make** | Envie os dados para qualquer ferramenta externa via POST | *** ## Quando usar Use o bloco Qualificação sempre que precisar **transformar uma conversa em dados estruturados** para a equipe comercial. Alguns cenários típicos: * Agência digital qualificando lead B2B (faturamento, segmento, canais atuais) * SaaS coletando dados para um trial (empresa, cargo, tamanho do time) * Imobiliária identificando perfil (tipo de imóvel, orçamento, região) * Consultoria captando briefing (objetivo, urgência, investimento previsto) Para agendamento simples (nome + email + motivo), o bloco **Agendamento** encadeado com **Coleta de Dados** resolve. Use Qualificação quando você precisar de **múltiplos campos estruturados** que vão para um CRM ou fluxo comercial. *** ## Como funciona ``` Cliente chega no bloco Qualificação ↓ Agente envia mensagem de introdução ↓ IA coleta os campos configurados (modo conversacional ou direto) ↓ [Opcional] Confirma os dados com o cliente ↓ Envia para: • Webhook (N8N, Make, etc.) • CRM Chatwoot (cria deal) • Ambos ↓ Executa a ação pós-qualificação (continuar / transferir / mensagem final) ``` A qualificação segue uma **máquina de estados determinística** — ou seja, o sistema garante a ordem e evita que a IA pule etapas. *** ## Campos principais ### Identificação | Campo | Descrição | Exemplo | | ----------------- | -------------------------------------- | ------------------------------ | | **Nome do Fluxo** | Identificador do fluxo de qualificação | "Qualificação Agência Digital" | ### Perguntas de Qualificação Cada pergunta é um **campo** com os seguintes parâmetros: | Campo | Descrição | Exemplo | | ---------------------- | ------------------------------------------------------- | ------------------------------------------------------------- | | **ID do campo** | Nome técnico usado nos dados enviados | `nome`, `email`, `faturamento` | | **Pergunta** | Texto que o agente usa para coletar o dado | "Qual o faturamento mensal da empresa?" | | **Tipo** | Tipo do campo | Texto, Email, Telefone, Número, Seleção, Texto longo, Arquivo | | **Obrigatório** | Se a coleta não pode prosseguir sem esse dado | Sim / Não | | **Opções** | Apenas para tipo "Seleção" — lista de valores possíveis | "Até R$ 50k", "R$ 50k-200k", "Acima de R\$ 200k" | | **Dica para o agente** | Orientação de como o agente deve perguntar | "Pergunte de forma natural no meio da conversa" | ### Comportamento | Campo | Descrição | | ------------------------------ | ----------------------------------------------------------------------------------------- | | **Modo de Coleta** | **Conversacional** (extrai das mensagens naturalmente) ou **Direto** (pergunta uma a uma) | | **Permitir dados incompletos** | Permite enviar o que foi coletado mesmo se faltar algum campo opcional | | **Confirmar antes de enviar** | Agente repete os dados e pede confirmação antes de enviar | ### Mensagens | Campo | Descrição | Exemplo | | --------------- | ---------------------------------- | --------------------------------------------------------------------------- | | **Introdução** | Mensagem ao começar a qualificação | "Para preparar uma proposta personalizada, preciso de algumas informações." | | **Confirmação** | Mensagem após envio bem-sucedido | "Recebi suas informações! Nossa equipe entrará em contato em breve." | | **Erro** | Mensagem se houver falha no envio | "Houve um problema ao processar. Vou transferir você para nossa equipe." | ### Webhook | Campo | Descrição | | ------------------ | ---------------------------------------------------------------------- | | **URL do Webhook** | Endpoint que recebe os dados via POST (N8N, Make, Zapier, API própria) | ### Integração CRM (Chatwoot) Quando ativada, cria automaticamente um **deal** no CRM do Chatwoot ao concluir a qualificação: | Campo | Descrição | | ------------------ | ----------------------------------------------------------- | | **Pipeline** | Em qual pipeline criar o deal | | **Stage inicial** | Em qual stage o deal entra | | **Título do deal** | Template com placeholders (ex: `{lead_name} — {flow_name}`) | Os placeholders disponíveis são `{lead_name}`, `{flow_name}`, `{contact.name}` e qualquer campo coletado (`{email}`, `{empresa}`, etc.). ### Ação pós-qualificação O que o fluxo faz depois de coletar e enviar os dados: | Opção | Comportamento | | -------------------------- | --------------------------------------------- | | **Continuar conversa** | O agente segue com o fluxo normalmente | | **Transferir para humano** | Encaminha para a equipe comercial | | **Exibir mensagem final** | Envia uma mensagem de despedida personalizada | *** ## Exemplo de uso em fluxo **Cenário — Agência digital qualificando lead B2B:** ``` [Roteador] └── "Quer orçamento" → [Qualificação] → [Handoff: equipe comercial] ``` **Configuração da Qualificação:** | Campo | Tipo | Obrigatório | | ------------- | ----------- | ----------- | | `nome` | Texto | Sim | | `email` | Email | Sim | | `empresa` | Texto | Sim | | `cargo` | Texto | Não | | `faturamento` | Seleção | Sim | | `objetivo` | Texto longo | Sim | * **Modo de coleta:** Conversacional * **Webhook:** `https://n8n.suaempresa.com/webhook/lead-qualificado` * **Integração CRM:** Ativada → pipeline "Novos Leads", stage "Qualificados" * **Ação pós:** Transferir para humano A IA coleta os dados durante o bate-papo de forma natural. Quando todos os obrigatórios estão preenchidos, o sistema envia para o N8N **e** cria o deal no CRM Chatwoot, depois transfere a conversa para o vendedor. *** ## Blocos relacionados Mova ou feche deals do CRM em pontos específicos do fluxo. Direcione só os leads comerciais para a Qualificação. Transfira para o vendedor depois de qualificar. Para coleta simples + agendamento, use o Agendamento com Coleta de Dados.