# Passo 7: Como funcionam os campos de metadados do contato e do ticket?

Os campos de **Metadados** permitem que o Vambe registre informações do cliente e do ticket de forma automática enquanto a IA conversa. Essas informações são usadas para personalizar respostas, completar funções, mover etapas e, em geral, tornar todo o fluxo mais inteligente.

No entanto, para que o sistema registre dados corretamente, é fundamental entender **como um metadado é capturado e quais condições precisam ser atendidas**.

#### [Como criar um campo no Vambe](https://academy.vambe.ai/v1/docs/paso-1-c%C3%B3mo-crear-un-campo-en-vambe)

***

{% stepper %}
{% step %}

### A regra principal: a IA só pode salvar metadados se o campo existir

Antes de qualquer coisa, há um ponto-chave:

✔️ Se o metadado **não estiver criado**, a IA **não pode salvá-lo**.

Nem por erro, nem por intuição, nem porque “ouviu” isso na conversa.

Pode lembrá-lo temporariamente na memória da conversa, mas **essa memória se perde** e não fica registrada em nenhum lugar do sistema.

Por isso, **todos os campos que você quiser usar devem estar criados previamente** como metadados do contato ou metadados do ticket.

Como criar um metadado no Vambe?\
Consulte: <https://academy.vambe.ai/v1/docs/paso-1-c%C3%B3mo-crear-un-campo-en-vambe>
{% endstep %}

{% step %}

### A IA não precisa de instruções como “salve este dado”

No Vambe **não se usa a instrução literal “salvar X em metadata”**. Isso é automático.

A IA salva metadados quando acontece uma destas duas coisas:

#### a) O dado aparece explicitamente na conversa

Exemplo:

O cliente diz:

> “Meu e-mail é <juan@example.com>”

Se existir um metadado chamado **e-mail**, o Vambe:

* Detecta o e-mail
* Valida-o
* Salva-o automaticamente

Sem necessidade de instruções adicionais.

#### b) O assistente obtém o dado por uma função

Exemplo:

A IA executa *buscar linha na planilha* com o RUT → encontra o endereço e o telefone.

Se existirem os campos de metadados **endereço** e **telefone**, o sistema os completa sozinho.
{% endstep %}

{% step %}

### O que você deve fazer então?

Você deve garantir:

✔️ Criar todos os metadados necessários\
Se o campo faltar, o dado nunca será salvo.

✔️ Indicar em “Passos a seguir” ou “Casos possíveis” quando a IA deve **perguntar** algo\
Exemplo: “Solicite o e-mail do cliente antes de cotar.”\
A IA pergunta → o cliente responde → o dado é armazenado automaticamente.

✔️ Indicar quando deve **extrair** um dado de um documento ou do contexto\
Exemplo: “Se o cliente escreve ‘quero ver o preço’, busque a informação em Vector Search.”\
Assim que a IA obtém o dado, se o metadado existir → o Vambe o salva.
{% endstep %}

{% step %}

### Metadados do contato vs Metadados do ticket

#### Metadados do contato

Informações permanentes que ficam salvas para todas as conversas futuras:

* Nome
* E-mail
* Telefone
* Cidade
* RUT
* Preferências gerais
* Origem ou outros campos “estáveis”

#### Metadados do ticket

Informações que pertencem **somente ao processo atual**, como:

* Produto que deseja hoje
* Data da visita
* Motivo do contato
* Variáveis para um orçamento
* Seleções temporárias

Quando o ticket é encerrado, esses metadados deixam de ser usados.
{% endstep %}

{% step %}

### O que acontece se um campo não existir?

Se o metadado **não estiver criado**, acontecem duas coisas:

1. A IA **entende sim a informação**, mas somente como parte do contexto (memória conversacional).
2. Essa memória **se perde** assim que o estado do ticket muda ou o agente intervém.

Por isso é fundamental que:

✔️ Todo dado importante exista como campo

Caso contrário, o sistema não poderá usá-lo para:

* Ações automáticas
* Envio de PDFs
* Mudanças de etapa
* Vambe Ads
* Agendamentos
* Envio de e-mails ou mensagens
* Relatórios internos
* Personalização avançada
  {% endstep %}
  {% endstepper %}

***

## Resumo geral

* A IA **não salva** metadados porque você mandou: ele salva automaticamente se o campo existir.
* Para capturar qualquer dado, primeiro você deve **criar o metadado**.
* A IA só captura informações se o dado aparecer na conversa ou se ela o obtiver por meio de funções.
* Os metadados se dividem em **contato** (permanentes) e **ticket** (temporários).
* Se o metadado não existir, o dado não será salvo e a inteligência o perderá.


---

# Agent Instructions: 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:

```
GET https://academy.vambe.ai/bienvenido-a-vambe/bienvenido-a-vambe-pt-br/como-funciona-a-vambe-conceitos-essenciais/passo-7-como-funcionam-os-campos-de-metadados-do-contato-e-do-ticket.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.