## 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

1. Confirme com um administrador que o módulo está habilitado.
2. Crie um **tipo de objeto** com um **nome** (ex.: "Curso") e um **ícone**.
3. Adicione os **campos** do tipo, escolhendo o formato de cada um (texto, número, moeda, data, sim/não,
   lista ou link).
4. Defina a **propriedade principal** — o campo usado para exibir o nome do registro.

### Cadastrar e associar registros

1. Crie um **registro** do tipo (ex.: "Curso de Inglês", valor 100), preenchendo os campos.
2. Abra um **contato** ou um **negócio** e use a opção de **associar** o registro a ele.
3. Opcionalmente, informe um **rótulo de associação** (ex.: "aluno", "responsável").
4. 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.

## Veja também

- [Atributos personalizados de contato e conversa](/hc/ajuda/articles/contacts-crm-atributos-personalizados-pt-br)
- [CRM: pipelines, kanban e negócios (deals)](/hc/ajuda/articles/contacts-crm-crm-pipelines-kanban-negocios-pt-br)
- [Registro de pedidos (Orders Registry) no CRM](/hc/ajuda/articles/contacts-crm-crm-orders-registry-pt-br)
- [Visão geral de Contatos e do CRM](/hc/ajuda/articles/contacts-crm-overview-pt-br)