> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/embudo/embudo-pt-br/edicao-do-funil/campos-requeridos-datos-obligatorios-por-etapa.md).

# Campos Obrigatórios: dados obrigatórios por etapa

A funcionalidade de **Campos Obrigatórios** atua como um filtro de qualidade no seu funil de vendas. Permite definir quais informações são **obrigatórias para entrar** em uma etapa específica, incluindo agora **campos de contato**. Isso permite uma personalização mais profunda na coleta de dados por fase do processo.

**A Regra de Ouro**: Os campos são obrigatórios para **ENTRAR** na etapa.

* Se a IA tentar mover um cliente para "Cotização", primeiro verificará se ele tem os dados exigidos por "Cotização".
* Se você mover manualmente um ticket para "Cotização", o sistema pedirá que você preencha esses dados manualmente.

{% hint style="danger" %}
**Pré-requisito**: O Campo (Dado), seja personalizado ou de contato, deve existir previamente no Vambe e estar associado ao Ticket. *Se você ainda não os criou:* 👉 [\\\[Como criar campos personalizados e atribuí-los ao Ticket\\\]](https://academy.vambe.ai/crm/gestion-de-campos-y-datos-a-recopilar)
{% endhint %}

***

#### 1. Como funciona a lógica da IA?

Quando seu Assistente de IA decide que é hora de avançar um cliente (ex: o cliente pede cotação), o sistema executa uma validação de segurança sobre a etapa de destino:

1. **Tentativa de Mudança**: A IA executa a função `change_stage` para mover o cliente para a etapa-alvo (ex: "Pendente Enviar Cotação").
2. **Verificação de Destino**: O sistema verifica: *"Esta etapa de destino exige algum dado obrigatório?"*.
3. **Extração Inteligente** (Gemini Flash):
   * Se o dado estiver faltando (ex: RUT), a IA analisa toda a conversa histórica e as ferramentas usadas anteriormente para ver se o cliente já o mencionou.
   * Se encontrar, salva automaticamente e autoriza a entrada na etapa.
4. **Solicitação Ativa**:
   * Se o dado não existir no chat, o sistema bloqueia a mudança de etapa.
   * A IA, em vez de mover o cliente, responde solicitando o dado faltante.

> Exemplo:
>
> * Meta: Entrar na etapa "Pendente Cotação" (Requer: RUT).
> * Ação: A IA detecta que falta o RUT.
> * Resposta ao cliente: *"Para gerar sua cotação formal e avançar, preciso que você me informe seu RUT, por favor."*

***

#### 2. Configuração Passo a Passo

Para ativar esses requisitos de entrada, siga estes passos:

1. Entre no seu Funil e clique no ícone de Lápis (Editar Funil) no canto superior direito.\ <br>

   <figure><img src="/files/12c5d39b0412a82d6fce20a7bc645b553b8b1fdf" alt=""><figcaption></figcaption></figure>
2. Selecione a aba Tickets.<br>

   <figure><img src="/files/b6507aa482158d28c0a8b5fd570eb47ab3542d23" alt=""><figcaption></figcaption></figure>
3. Localize a coluna da Etapa de Destino (a etapa à qual você quer adicionar requisitos de entrada).
4. Ative o botão "Campos obrigatórios".
5. Selecione na lista os dados (incluindo campos de contato) que devem estar preenchidos para permitir a entrada.

<figure><img src="/files/e0581a1e8ad0ff6b0e4948a714d1db4ea0912c45" alt="" width="563"><figcaption></figcaption></figure>

6. Clique em Salvar alterações.<br>

<figure><img src="/files/2ee3beb649a3581e30c578aa2570cb39c51644f9" alt=""><figcaption></figcaption></figure>

***

#### 3. Movimentos Manuais vs. IA

É importante entender como isso afeta sua operação diária:

* 🤖 Movimento por IA: É 100% automático. A IA busca o dado no chat. Se não estiver lá, pede ao cliente de forma natural na conversa.\ <br>

  <figure><img src="/files/135a2e7000c732a5d9a2fd190f1eebf36d903f86" alt=""><figcaption></figcaption></figure>
* 👤 Movimento Manual (Agente): Se você arrastar um ticket manualmente para uma etapa com requisitos, o sistema detectará que o dado está faltando e abrirá uma janela pop-up obrigando você a preenchê-lo manualmente naquele momento. Você não poderá soltar o ticket nessa etapa até completar as informações.

<figure><img src="/files/b3560bb9e0ed94d67cd3187446beeaf95ae30a6f" alt=""><figcaption></figcaption></figure>

***

#### 4. Visualização nos Logs (Field Extraction)

Você pode monitorar como a IA busca essas informações revisando os logs da conversa ou o Playground. Você verá um evento chamado FIELD\_EXTRACTION.

* Required fields: Mostra o que a etapa de destino exigia.
* Missing fields: Mostra o que não encontrou.
* Message sent to user: Mostra a pergunta que gerou para pedir o dado.


---

# 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://academy.vambe.ai/embudo/embudo-pt-br/edicao-do-funil/campos-requeridos-datos-obligatorios-por-etapa.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.