Visão geral
A ConversaLabs modela um mundo padrão: contatos, conversas, empresas e negócios. Mas todo negócio também acompanha suas próprias entidades: uma escola tem Cursos e Matrículas; uma clínica tem Procedimentos e Convênios; um SaaS tem Licenças e Projetos; uma imobiliária tem Imóveis e Visitas.
Os Objetos personalizados (Custom Objects) permitem criar essas entidades de forma no-code. Você define um tipo de objeto (com um nome livre, campos próprios e uma propriedade principal de exibição), cadastra registros (as instâncias) e os associa a contatos e negócios. É o mesmo conceito de Custom Objects do HubSpot/Mautic, agora nativo na plataforma — uma só conta, uma só governança, sem re-cadastrar dados em ferramentas externas.
Pré-requisitos
- O módulo de Objetos personalizados é opcional e vem desativado por padrão. Peça a um administrador para habilitá-lo para a conta.
- Permissão de gestão de objetos personalizados para criar tipos, campos e registros.
- Contatos e/ou negócios já existentes para associar os registros.
Passo a passo
Criar um tipo de objeto
- Confirme com um administrador que o módulo está habilitado.
- Crie um tipo de objeto com um nome (ex.: "Curso") e um ícone.
- Adicione os campos do tipo, escolhendo o formato de cada um (texto, número, moeda, data, sim/não, lista ou link).
- Defina a propriedade principal — o campo usado para exibir o nome do registro.
Cadastrar e associar registros
- Crie um registro do tipo (ex.: "Curso de Inglês", valor 100), preenchendo os campos.
- Abra um contato ou um negócio e use a opção de associar o registro a ele.
- Opcionalmente, informe um rótulo de associação (ex.: "aluno", "responsável").
- Para remover o vínculo, use a opção de desassociar.
Configurações & opções
- Tipos de campo: texto, número, moeda, data, sim/não (booleano), lista e link — os mesmos formatos dos atributos personalizados, com os mesmos widgets de preenchimento.
- Propriedade principal: define como o registro aparece nas listas e nos painéis.
- Associações: um registro pode ser associado a contatos e a negócios, com rótulo opcional e data de associação. Cada vínculo é único por associável.
- Visão por tipo: ao abrir um contato (ou negócio), os registros associados aparecem agrupados por tipo.
- Segmentação e automação: é possível filtrar contatos por "associado ao tipo X" e usar condições/ações de automação e webhooks com base nas associações.
- API: tipos, registros e associações podem ser gerenciados via API pública, com deduplicação por identificador externo.
Casos de uso
- Uma escola registra Cursos e Matrículas e os associa aos contatos dos alunos.
- Uma clínica controla Procedimentos e Convênios por paciente.
- Um SaaS acompanha Licenças e Projetos por cliente, ligados aos negócios.
- Uma imobiliária cadastra Imóveis e Visitas e os associa a contatos e oportunidades.
Dicas, limites e boas práticas
- Comece com poucos tipos e campos essenciais; expanda conforme a necessidade.
- Escolha bem a propriedade principal — ela é o "nome" do registro em toda a interface.
- Use rótulos de associação para diferenciar papéis (ex.: aluno vs. responsável).
- Na versão atual, as associações são feitas a contatos e negócios (não a conversas ou empresas), e não há associação entre registros nem campos calculados.
Solução de problemas
- Não vejo o módulo: ele pode estar desativado para a conta — fale com um administrador.
- Não consigo criar tipos ou campos: confirme sua permissão de gestão de objetos personalizados.
- Não acho um registro para associar: verifique se ele foi criado no tipo correto.
- Registro duplicado pela API: envie um identificador externo estável para a deduplicação funcionar.