Skip to main content
A propriedade é um campo personalizado do lead: “Cidade”, “Plano de interesse”, “Data da consulta”, “Valor do orçamento”. Pode ser texto livre, número, uma lista fechada de valores ou uma lista com valor numérico (cada opção tem um preço, por exemplo). Quem preenche pode ser a equipe, o agente (com uma ação da Zatten), a API, um fluxo ou a importação de contatos. Cada propriedade tem um slug, o identificador fixo usado pelo agente, pela API e pelo CSV.

Onde fica no painel

  • Contatos → aba Propriedades: a tabela com Nome, Slug, Vínculo, Valores e Descrição, e o botão Adicionar Propriedade.
  • Contatos → Lista: uma coluna por propriedade, editável na própria célula; o filtro Filtrar por propriedade; a ação em massa de propriedade.
  • Painel do lead (em Conversas): o bloco Propriedades.

Como configurar

O slug

  • É gerado do nome na criação: minúsculas, sem acento, espaços viram _. “Data de Nascimento” vira data_de_nascimento.
  • Não muda depois, mesmo renomeando a propriedade. Os valores preenchidos nos leads ficam presos a ele.
  • Não pode repetir no projeto: “Já existe uma propriedade com o slug … neste projeto”.
  • É o nome do campo nas tools do agente, na API e no cabeçalho do CSV de importação.

Qual tipo usar?

Número e lista com valor numérico alimentam as métricas do funil (soma por coluna, contagem acima de um valor). No tipo Número, o valor é só dígitos com ponto decimal (199.9); texto, vírgula ou R$ são recusados no CRM e na API. Prefira lista sempre que der: o agente recebe as opções e não inventa variações, e campanhas e filtros por valor ficam confiáveis. Na lista, cada valor precisa ser único (sem diferenciar maiúsculas) e é preciso ao menos um.

Como funciona por trás

  • Ao encerrar o atendimento, as propriedades de vínculo Conversa saem do lead e ficam no histórico daquela conversa. As de vínculo Contato continuam.
  • Enviar para a IA: cada propriedade tem a opção “enviar para a IA”. Ligada, o valor preenchido entra no contexto do agente a cada resposta. Vem ligada por padrão: propriedade criada pelo painel já vai para a IA. A opção não aparece no formulário do painel: para desligar, só pelo template (MCP ou JSON). Veja O que a Zatten injeta no contexto.
  • O agente preenche pela ação “preencher propriedade”, sempre pelo slug. Com lista, ele só aceita os valores da lista. Veja Ações da Zatten.
  • Filtro em Contatos: texto livre busca por “contém”; lista escolhe um dos valores. Várias condições valem juntas (todas precisam bater).

O que muda depois que está em uso

Pelo MCP

As propriedades viajam no bloco properties do template, com os valores da lista.
  • Renomeie pelo slug. Sem slug, um nome novo cria outra propriedade.
  • O tipo vai em property_type: TEXT, NUMBER, ENUM (lista) ou FLOAT_ENUM (lista com valor numérico). Ausente não mexe. ENUM e FLOAT_ENUM exigem ao menos uma opção em values; em FLOAT_ENUM, cada opção leva numeric_value e o value é o slug da opção.
  • display_format: "CURRENCY_BRL" exibe em reais (só NUMBER e FLOAT_ENUM); "NONE" tira. Ausente não mexe.
  • is_enum é o jeito antigo de ligar a lista: sem property_type, is_enum: true com values vira ENUM.
  • send_to_ai só se altera por aqui. O padrão é true (vai para a IA).
  • Valor retirado de values continua existindo nos leads.

Armadilhas

  • Decida entre texto e lista antes de preencher. Depois que algum contato tem valor em texto livre, não dá mais para virar lista. A saída é criar outra propriedade.
  • Tirar um valor da lista no painel apaga dados. Os contatos com aquele valor ficam sem a propriedade. Confira a contagem na confirmação.
  • Renomear não muda o slug. Um slug ruim (“teste_1”) fica para sempre; escolha bem o nome na criação.
  • “Enviar para a IA” vem ligado e não está no formulário. Toda propriedade preenchida vai para o agente. Para esconder uma propriedade do agente (dado interno, satisfação), desligue pelo template.
  • Vínculo Conversa some ao encerrar. Dados permanentes (CPF, cidade) devem ser de vínculo Contato.
  • Valor fora da lista na importação é ignorado, com aviso no resultado.

Perguntas frequentes

Em Contatos → Lista, selecione os leads e use a ação de propriedade. Ou importe um CSV com uma coluna por propriedade, usando o slug como cabeçalho. Veja Contatos.
Sim, se ela estiver preenchida no lead e com “enviar para a IA” ligado (o padrão). Para o agente gravar, ele precisa da ação “preencher propriedade” apontando para ela.
Tag é sim ou não. Propriedade guarda um valor. Veja Tags.

Para saber mais