---
title: Objetos Personalizados
image: /images/user-guide/objects/objects.png
---

<Frame>
  <img src="/images/user-guide/objects/objects.png" alt="Header" />
</Frame>

Objetos são estruturas que permitem armazenar dados (registros, atributos e valores) específicos de uma organização. O Twenty fornece tanto objetos padrão quanto personalizados.

Objetos padrão são objetos embutidos com um conjunto de atributos disponíveis para todos os usuários. Exemplos de objetos padrão no Twenty incluem Empresa e Pessoa. Objetos padrão possuem campos padrão que também estão disponíveis para todos os usuários do Twenty, como Company.displayName.

Objetos personalizados são aqueles que você pode criar para armazenar informações exclusivas para sua organização. Eles não são embutidos; membros do seu workspace podem criar e personalizar objetos personalizados para armazenar informações para as quais objetos padrão não são adequados.

## Esquema de alto nível

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/custom-object-schema.png" alt="High level schema" />
</div>

<br/>

## Como funciona

Objetos personalizados são derivados de tabelas de metadados que determinam a forma, o nome e o tipo dos objetos. Todas essas informações estão presentes no banco de dados de esquema de metadados, que consiste em tabelas:

- **DataSource**: Detalha onde os dados estão presentes.
- **Object**: Descreve o objeto e vincula a um DataSource.
- **Field**: Delimita os campos de um Objeto e se conecta ao Objeto.

Para adicionar um objeto personalizado, o workspaceMember fará uma consulta à API /metadata. Isso atualiza os metadados de acordo e computa um esquema GraphQL baseado nos metadados, armazenando-o em um cache GQL para uso posterior.

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/add-custom-objects.jpeg" alt="Query the /metadata API to add custom objects" />
</div>

<br/>

Para buscar dados, o processo envolve fazer consultas através do endpoint /graphql e passá-las pelo Resolvedor de Consulta.

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/custom-object-schema.png" alt="Query the /graphql endpoint to fetch data" />
</div>