For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.


1

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

2

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.

3

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.

4

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.

5

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


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á.

Atualizado

Isto foi útil?