Campos personalizados

Os campos padrão do Syncro (Nome, Telefone, Email, Empresa, Valor) cobrem o básico, mas todo negócio tem dados específicos que precisa rastrear: CNPJ, número de funcionários, segmento, decisor de compra, prazo de fechamento, ferramenta atual, fonte de indicação detalhada, etc. Os Campos Personalizados permitem você criar essas colunas extras com tipo de dado certo (texto, número, data, lista de opções) sem precisar de desenvolvimento.

Os campos aparecem automaticamente no drawer de cada lead e podem ser usados em filtros, automações e listas dinâmicas.

Pré-requisitos

• Permissão de admin da Conta (apenas admins criam/editam definições; managers e viewers usam).

• Plano com slots disponíveis pra campos personalizados.

Os 10 tipos de campo disponíveis

Criar um campo personalizado

1. Acesse Configurações → Campos extras.

2. Você vê a lista de campos atuais (se houver).

3. Clique em Novo campo.

4. Preencha:

• Nome interno (snake_case, sem acentos): identificador técnico. Ex: cnpj, numero_funcionarios, segmento. Não pode ter espaço.

• Label (rótulo visível): como aparece pros usuários. Ex: CNPJ, Número de funcionários, Segmento.

• Tipo de campo: escolha entre os 10 disponíveis.

• Obrigatório: marca se o campo precisa ser preenchido pra criar/editar lead.

• Mostrar no card (kanban): se o valor aparece no card do lead no kanban.

• Mostrar na lista: se vira coluna na listagem /contatos.

• Ativo: liga/desliga o campo.

• Posição (sort_order): ordem de exibição.

5. Se o tipo for select ou multiselect, preencha Opções (uma por linha):

Tecnologia
Saúde
Educação
Varejo
Outros

6. (Opcional) Defina valor padrão que aparece pré-preenchido quando criar lead novo.

7. Clique em Salvar.

8. Campo aparece em todos os drawers de lead a partir desse momento.

Como aparece no drawer do lead

Após criar o campo, ele aparece automaticamente no drawer de cada lead numa seção "Campos personalizados" (ou similar). A interface depende do tipo:

• Texto / Email / URL / Telefone: input text simples.

• Texto longo: textarea.

• Número: input com validação numérica.

• Moeda: input com prefixo "R$" e formatação automática.

• Data: date picker.

• Lista: dropdown com as opções configuradas.

• Múltipla escolha: multi-select com checkboxes.

• Checkbox: toggle on/off.

Você preenche e salva junto com o resto do lead.

Validações por tipo

O Syncro valida o formato no momento de salvar:

• Email: precisa ser email válido.

• URL: precisa começar com http:// ou https://.

• Data: precisa ser data válida.

• Número: precisa ser numérico (aceita decimais).

• Moeda: numérico com 2 casas decimais.

• Select: o valor precisa estar nas opções configuradas (não aceita valor avulso).

• Multiselect: cada valor precisa estar nas opções.

Se a validação falha, o sistema retorna erro e o lead não é salvo.

Editar um campo existente

1. Em Configurações → Campos extras, clique no campo desejado.

2. Ajuste:

• Label (sempre seguro mudar)

• Opções (selecione com cuidado — ver aviso abaixo)

• Posição, Ativo, Mostrar no card / lista

3. Salve.

⚠️ Atenção: ao alterar opções de um select removendo opção que leads existentes já têm, esses leads ficam com valor "órfão". O Syncro mantém o valor antigo no lead, mas no select aparece como inválido. Sugerimos: antes de remover opção, confirme que nenhum lead a usa, ou ajuste leads em massa antes.

Mudar tipo de um campo

⚠️ Não é possível mudar o tipo de um campo depois de criado. Por exemplo, não dá pra transformar campo text em number.

Se precisar mudar:

1. Crie um campo novo com o tipo correto.

2. Migre os dados dos leads (manualmente ou via API).

3. Apague o campo antigo.

Excluir um campo

1. Em Configurações → Campos extras, clique no ícone de lixeira.

2. Confirme.

3. O campo é apagado do catálogo e os valores em todos os leads são apagados (cascata).

⚠️ Atenção: deletar campo é irreversível. Considere desativar (toggle "Ativo") se quer só esconder temporariamente.

Mostrar campo no card do kanban

Se você marca Mostrar no card, o valor do campo aparece no card de cada lead no kanban. Útil pra destacar dados-chave:

• "Mostrar CNPJ no card" — vendedor já vê quando arrasta.

• "Mostrar Segmento no card" — facilita priorização visual.

• "Mostrar Decisor no card" — sabe imediatamente quem ligar.

💡 Dica: não exagere — máximo 2-3 campos no card pra não poluir. Cards grandes demais ficam difíceis de escanear.

Usar campo personalizado em filtros

Na listagem /contatos, alguns campos personalizados aparecem como opção de filtro (depende de configuração). Pra filtrar:

1. Selecione o campo no dropdown de filtros.

2. Defina o valor.

3. Lista atualiza.

Usar em listas dinâmicas

Em listas dinâmicas, campos personalizados podem ser condições:

Veja Listas dinâmicas.

Usar em automações

Você pode usar campos personalizados como:

• Condição: "Só dispara se custom:segmento = Tecnologia".

• Ação update_lead: a IA ou automação atualiza o valor do campo.

• Ação extract_lead_data: a IA extrai informação da conversa e preenche o campo.

Veja Automações.

Importação com campos personalizados

Ao importar CSV, você consegue mapear coluna do arquivo pra campo personalizado:

• No mapeamento, escolha Custom: {nome do campo} ao invés dos campos padrão.

• O Syncro popula o campo durante a importação.

• Pra select, o valor precisa bater com uma das opções configuradas (case-sensitive).

Quantidade de campos personalizados

A quantidade máxima de campos personalizados é controlada pelo plano:

Se você atinge o limite, recebe "Limite atingido" — faça upgrade do plano.

Boas práticas

• Comece com 3-5 campos mais críticos. Não tente mapear tudo de cara.

• Use nome interno snake_case consistente: numero_funcionarios, data_proposta, decisor_compra.

• Use Label amigável em pt_BR: Número de funcionários, Data da proposta, Decisor de compra.

• Marque obrigatório só campos críticos — campos obrigatórios atrasam o cadastro.

• Revise periodicamente — campos sem uso há 6 meses, considere remover.

API e integrações

Pra automações externas (n8n, Zapier, código próprio), os campos personalizados são acessíveis via API REST v1:

• GET /api/v1/custom-fields — lista definitions

• PUT /api/v1/leads/{id} — atualiza values

Veja API e Webhooks.

Próximos passos

• Pra usar tags em vez de campos estruturados, veja Tags.

• Pra criar listas baseadas em campos, veja Listas dinâmicas.

Artigos relacionados

• Tags de contatos

• Editar um contato

• Listas de contatos

• Automações