For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/max/custom-objects-with-max.md.
  • Português

      • Como pedir para a IA criar e preencher objetos do CRM, como Imóveis ou Contratos?

      Descreva o que o seu negócio acompanha e o que quer fazer ("quero cadastrar meus imóveis e ligar cada um aos contatos interessados", "cadastre o contrato 123 para a Ana", "quais imóveis de 3 quartos estão disponíveis?"). O Max lê os objetos, campos e ligações que já existem na conta antes de propor ou criar qualquer coisa.

      Antes de começar:

      • O recurso de objetos personalizados precisa estar liberado para a sua conta. Se não estiver, o Max avisa.
      • O Max segue as permissões do seu cargo em Objetos personalizados: criar objetos e ligações exige Configurar; cadastrar e editar registros exige Criar e Editar; excluir exige Excluir. Quem tem acesso Próprios só enxerga e altera os registros pelos quais é responsável.

      1. Peça para montar um objeto

      Diga o que quer cadastrar e como ele se relaciona com contatos, oportunidades, empresas ou outros objetos. O Max propõe:

      • o nome no singular e no plural, o gênero da palavra, o ícone e a cor;
      • o campo-título, que dá nome a cada registro (ex.: Endereço, Placa, Número do contrato);
      • os primeiros campos, com o tipo de cada um;
      • cada ligação, escrita em frase simples, com quantos de cada lado ("cada contrato pertence a 1 contato; um contato pode ter vários contratos").

      Confirme ou ajuste, e o Max cria tudo. Depois você pode pedir mais campos, renomear o objeto ou trocar o campo-título.

      Duas coisas para saber:

      • O nome na API do objeto nasce do nome no plural e não muda depois, mesmo que você renomeie o objeto.
      • A quantidade de cada lado de uma ligação não pode mudar depois que ela já tem vínculos. Pense nela antes de confirmar.

      2. Peça para cadastrar e vincular registros

      Diga os dados do registro e a quem ele se liga ("cadastre o imóvel Rua das Flores, 120, 3 quartos, e vincule à Ana como interessada"). O Max cria o registro com os valores e os vínculos de uma só vez.

      • Só o campo-título é obrigatório para salvar. Os demais campos marcados como obrigatórios são cobrados na tela, então diga os dados que tiver.
      • Em ligações do tipo 1 → vários, vincular um novo item pode trocar o vínculo anterior ou mover o item de outro registro. O Max avisa antes quando isso vai acontecer.
      • Para corrigir dados, peça a mudança ("o imóvel 120 agora tem 4 quartos"). Trocar o campo-título renomeia o registro.
      • Você também pode pedir para trocar o responsável, desvincular um item ou escrever uma anotação no Histórico do registro.

      3. Pergunte sobre os seus registros

      Faça a pergunta como faria a um colega:

      • "Quais imóveis de 3 quartos ainda estão disponíveis?"
      • "Quais contratos vencem neste mês?"
      • "O que aconteceu com o veículo ABC1D23?" — o Max lê o Histórico do registro.
      • "Quantos contatos têm pelo menos um imóvel de interesse acima de R$ 500 mil?" — o Max mede o público com o filtro de contatos por objeto, o mesmo de filtrar contatos por um objeto.

      A busca rápida por nome olha só o campo-título. Para outros campos, o Max monta um filtro.

      4. Peça alterações em massa e visões salvas

      • Em massa: "marque como vendidos todos os imóveis da Rua X", "passe para o Bruno todos os contratos sem responsável". O Max conta os registros afetados antes e pede a sua confirmação. Seleções grandes rodam em segundo plano e o Max acompanha até terminar.
      • Visões salvas: "salve uma visão Kanban de imóveis por situação". A visão fica disponível para todo o workspace.

      Ações que apagam — excluir registros, excluir uma ligação (com todos os vínculos dela), excluir uma visão ou uma anotação — e alterações em massa pedem a sua confirmação antes de acontecer. Registros excluídos não podem ser recuperados. Objetos não são excluídos, só arquivados.

      Relacionados

      Se não funcionou

      • O Max diz que não encontra o objeto ou o registro: o recurso não está liberado, o objeto está arquivado ou o seu acesso é Próprios e o registro tem outro responsável.
      • O Max não consegue criar objeto ou ligação: o seu cargo não tem Configurar em Objetos personalizados.
      • Um vínculo antigo sumiu depois de vincular outro: a ligação é do tipo 1 → vários e o novo vínculo trocou o anterior. Peça para o Max vincular de novo se precisar.
      • A mudança na quantidade de cada lado da ligação foi recusada: a ligação já tem vínculos. Remova os vínculos ou crie uma nova ligação.