Propriedades personalizadas

A propriedade é um campo personalizado do lead: “Cidade”, “Plano de interesse”, “Data da consulta”. Pode ser texto livre ou uma lista fechada de valores. 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.

​

Texto livre ou lista?

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.
• is_enum: true e values andam juntos. values sem is_enum: true é ignorado, com nota.
• 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

​

Para saber mais

• Tags
• Contatos
• Qualificação de leads
• O que a Zatten injeta no contexto
• Referência do template
• Termos para buscar: “campos personalizados de CRM”, “enum”, “slug”.