> 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

Garanta a qualidade dos seus dados. Configure "cadeados" para que a IA (ou sua equipe) não possa inserir um cliente em uma etapa específica sem ter os dados obrigatórios completos, incluindo agora c

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="https://3033540422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4nRFeKJn1URTfeH8tYXz%2Fuploads%2F0zzyJCSwbmqYc1TV0lon%2Fimage.png?alt=media&amp;token=74c4215e-eba2-4e82-8bde-b1e441366b89" alt=""><figcaption></figcaption></figure>
2. Selecione a aba Tickets.<br>

   <figure><img src="https://3033540422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4nRFeKJn1URTfeH8tYXz%2Fuploads%2FsaOl3QBckeUZbrGzLbRO%2Fimage.png?alt=media&amp;token=d74e66a3-ec48-4d20-accb-56a5e35d415d" 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="https://3033540422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4nRFeKJn1URTfeH8tYXz%2Fuploads%2FuGGtP2Pb2lFYG2QeMDcn%2Fimage.png?alt=media&amp;token=4e3a4c1a-8253-4d6d-acb7-345c78ddefcb" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://3033540422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4nRFeKJn1URTfeH8tYXz%2Fuploads%2F6KVLhsvMLayZ4o1paXKy%2FCaptura%20de%20pantalla%202026-02-03%20a%20la(s)%2011.55.06%E2%80%AFa.m..png?alt=media&amp;token=4124348d-18e3-4bdd-87a1-e0a7a1f725d9" 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="https://3033540422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4nRFeKJn1URTfeH8tYXz%2Fuploads%2FFYXbRV84S03xvBYgAaN2%2Fimage.png?alt=media&amp;token=bb8af3e4-30b4-43ba-a0ed-ce8cfc560f02" 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="https://3033540422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4nRFeKJn1URTfeH8tYXz%2Fuploads%2FTfbZYLDmSzdWEg013GnO%2Fimage.png?alt=media&amp;token=33fd4235-e4db-486e-a717-4f22874dfab0" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.vambe.ai/embudo/embudo-pt-br/edicao-do-funil/campos-requeridos-datos-obligatorios-por-etapa.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.