Com o campo customizado somente leitura, você garante que informações específicas fiquem visíveis no Agendor CRM sem risco de serem alteradas manualmente pela equipe.
Neste artigo, você vai ver:
O que é um campo somente leitura e para que serve
Como identificar esses campos no CRM
Como criar e configurar (somente administradores)
Como preencher via API pública
Regra específica para Produtos
O que são campos do tipo "somente leitura"?
Campos customizados do tipo somente leitura são visíveis para todos os usuários nas telas e formulários de Empresas, Pessoas, Negócios e Produtos.
Eles podem ser filtrados, mas não podem ser editados pela interface do Agendor CRM. Seus valores são preenchidos exclusivamente via API pública, por usuários com perfil de administrador.
Esses campos resolvem um problema adicional: garantir que dados vindos de sistemas externos (ERP, ferramentas de NPS, Agendor Chat etc.) fiquem visíveis no CRM sem risco de serem alterados manualmente pela equipe. Isso garante confiabilidade da informação para os gestores e para o time.
Exemplos de campos:
NPS do cliente
ID do ERP
Ranking ABC
Como identificar um campo "somente leitura"
Nas fichas, o campo somente leitura aparece sem ícone de edição. Ao passar o mouse sobre ele, uma mensagem diferente é exibida dependendo do usuário ativo:
Colaboradores: "Este é um campo somente leitura."
Administradores: "Este é um campo somente leitura. Pode ser preenchido apenas via API por usuários Administradores."
O valor do campo pode ser selecionado e copiado, mas não é possível editá-lo pela interface.
Como configurar (somente Administradores)
Comece acessando: Menu > Configurações > Personalização de formulários
Os campos somente leitura aparecem listados junto com os campos normais, com o identificador "Somente leitura".
Para criar um novo campo somente leitura, marque a opção "Somente leitura" na tela de criação do campo customizado. Um aviso será exibido: "Este campo ficará visível para todos, mas só poderá ser preenchido via API por Administradores."
Para converter um campo normal em somente leitura, basta abrir um campo existente e selecionar a opção "Somente leitura". Os dados já preenchidos pelos usuários são mantidos, eles apenas perdem a permissão de editar. A conversão também é reversível: o administrador pode desmarcar a opção para que o campo volte a ser editável por todos.
Ações disponíveis para campos somente leitura:
Reordenar (junto com os demais campos)
Esconder / mostrar
Renomear *
Excluir *
⚠️ Importante: somente campos criados por Administradores podem ser renomeados ou excluídos. Campos criados automaticamente por uma integração (como a do Agendor Chat com Meta Ads) não podem ser editados.
Como preencher o campo "somente leitura" via API pública
Administradores podem definir e editar valores de campos somente leitura via API pública nas rotas de criação e edição de Empresas, Pessoas, Negócios e Produtos.
Usuários comuns que tentarem escrever nesses campos receberão um erro com a mensagem indicando que o campo não pode ser alterado.
👁️🗨️ Saiba mais: Como usar a API do Agendor
No caso de Produtos, ao fazer uma importação por planilha, o valor de um campo somente leitura só é aceito na criação de novos produtos. Em atualizações via planilha, o valor é ignorado.
👁️🗨️ Saiba mais: Como importar produtos em massa no Agendor?
Ficou com alguma dúvida? Estamos à disposição em nossos canais de atendimento! 🙋♀️