---
title: "Defina seu modelo de dados na Spryx"
category: "Spryx 101"
updatedAt: "2026-10-23T02:55:01Z"
url: "https://spryx.ai/help/primeiros-passos/defina-seu-modelo-de-dados"
---

# Defina seu modelo de dados na Spryx

Aprenda a decidir entre atributo, relacionamento, View, Lista e Object ao estruturar sua operação na Spryx.

Um bom modelo de dados representa sua operação sem duplicar informações nem criar estruturas mais complexas do que o necessário. Depois de entender as peças da Spryx, use este guia para escolher qual delas resolve cada necessidade.

Você não precisa desenhar o modelo perfeito antes de começar. Estruture primeiro o que já está claro e evolua quando o processo exigir novos dados ou relações.

**Pré-requisitos**

- **Permissão:** Qualquer pessoa pode usar este guia para planejar a operação. Admins e Builders configuram Objects, atributos, relacionamentos e Listas; membros com acesso aos dados podem criar Views.

## Escolha pela função da informação {#escolha-pela-funcao-da-informacao}

- Use um **atributo** para guardar um valor que descreve um Record existente.
- Use um **relacionamento** para conectar Records de Objects diferentes.
- Use uma **View** para filtrar, ordenar ou apresentar os mesmos dados de outra forma.
- Use uma **Lista** quando Records participam de um processo que possui dados próprios.
- Use um **Object** quando a informação tem identidade, cadastro e relações próprias.

Quando houver dúvida, comece pela estrutura mais simples que preserva o significado dos dados.

## Use um atributo para descrever algo que já existe {#use-um-atributo-para-descrever-algo-que-ja-existe}

Crie um atributo quando um único valor descreve o Record em qualquer contexto. **Segmento** de uma Empresa, **Valor** de um Deal e **Data prevista** de um Projeto são exemplos.

Escolha um tipo coerente com o dado. Para valores que precisam ser filtrados de maneira consistente, prefira uma seleção com opções definidas em vez de texto livre.

![Janela Criar atributo com o seletor de tipos aberto, mostrando opções como Checkbox, Data, E-mail, Moeda, Número, Referência a record e Relacionamento.](https://cdn.sanity.io/images/qbc9enz0/production/67af7265f5f6621c6d3d67edb7fb8a0fb01964ab-2560x1600.png?w=1600&fit=max&auto=format)

_O tipo do atributo define como o valor será preenchido, exibido e consultado._

## Use um relacionamento para conectar Records {#use-um-relacionamento-para-conectar-records}

Se a informação já existe como outro Record, conecte os dois em vez de copiar seu nome para um campo de texto. Um Deal pode se relacionar com uma Empresa; um Ticket pode se relacionar com um Contact.

O relacionamento mantém as duas pontas conectadas e permite navegar entre os Records. Antes de criá-lo, defina também quantos Records podem existir de cada lado.

## Use uma View para mudar a perspectiva {#use-uma-view-para-mudar-a-perspectiva}

Uma View não cria Records nem guarda uma nova participação. Ela define como os dados existentes aparecem por meio de campos visíveis, filtros, ordenação e layout.

Use uma View quando a pergunta puder ser respondida consultando os valores que já existem. Alguns exemplos:

- Deals com previsão de fechamento neste mês;
- projetos sob responsabilidade da pessoa conectada;
- empresas de um segmento específico;
- entradas de uma Lista agrupadas por etapa.

![Configurações de uma View abertas sobre uma tabela, mostrando os atributos visíveis e a opção de adicionar outro atributo.](https://cdn.sanity.io/images/qbc9enz0/production/4829ea21ae69391e925594c15574b315cc04b9ec-2560x1520.png?w=1600&fit=max&auto=format)

_Cada View escolhe como apresentar os mesmos dados sem duplicá-los._

> **Informação**
>
> **Views em diferentes áreas.** Views podem organizar Records de um Object, entradas de uma Lista e o trabalho no Live Chat. O funcionamento das Views do Live Chat será aprofundado quando apresentarmos essa área.

## Use uma Lista para acompanhar uma participação {#use-uma-lista-para-acompanhar-uma-participacao}

Use uma Lista quando o time escolhe um conjunto de Records para um processo e precisa guardar informações que só existem naquele contexto.

Em uma implantação de clientes, por exemplo, a Empresa continua sendo o Record original. **Etapa da implantação**, **data de início** e **especialista responsável** podem pertencer à entrada em uma Lista chamada Implantação de clientes.

Uma Lista também pode ter diferentes Views. A Lista define quais Records participam e quais dados pertencem ao processo; a View define apenas como essas entradas aparecem.

![Janela Nova lista preenchida para Implantação de clientes sobre o Object Deal, com descrição, o status Etapa e as opções Novo, Em implantação e Ativo.](https://cdn.sanity.io/images/qbc9enz0/production/6e6eee6c0b6c009824112746bd1d6b5ab949bfbe-2560x1600.png?w=1600&fit=max&auto=format)

_A Lista cria um contexto de processo para Records de um mesmo Object._

## Use um Object para uma entidade própria {#use-um-object-para-uma-entidade-propria}

Crie um Custom Object quando o que você acompanha precisa ter vários Records, atributos próprios e relacionamentos com outras partes da operação.

Um **Contrato**, por exemplo, pode ter número, valor, início, vencimento e um relacionamento com a Empresa. Como uma Empresa pode ter vários contratos, guardar tudo em atributos da Empresa limitaria o histórico e misturaria entidades diferentes.

Antes de criar, confira se um Object de sistema ou um modelo do Catálogo de Objects já representa essa entidade.

![Janela Criar Custom Object preenchida com os nomes Pedido e Pedidos e o Identifier pedido gerado automaticamente.](https://cdn.sanity.io/images/qbc9enz0/production/b266eefe3709481c64672a5a7760f6a1ff05cf43-2560x1600.png?w=1600&fit=max&auto=format)

_Um Custom Object dá identidade, atributos e Records próprios a uma entidade da operação._

## Decida entre View e Lista {#decida-entre-view-e-lista}

Essa é a escolha que mais costuma gerar dúvida:

- Use uma **View** quando os Records podem entrar e sair do resultado por regras baseadas nos dados existentes.
- Use uma **Lista** quando a participação é escolhida para um processo e precisa ter atributos próprios.

Por exemplo, “todos os Deals acima de R$ 50 mil” pode ser uma View filtrada. Já “Deals escolhidos para a revisão trimestral”, com avaliação e observações específicas da revisão, deve ser uma Lista.

## Aplique o modelo a situações reais {#aplique-o-modelo-a-situacoes-reais}

- **Guardar o segmento de cada Empresa → atributo de seleção.** É uma característica da Empresa.
- **Ligar um Deal à Empresa compradora → relacionamento.** Os dois lados são Records com identidade própria.
- **Ver Deals que fecham neste mês → View.** O conjunto é obtido com um filtro sobre dados existentes.
- **Acompanhar clientes em implantação → Lista.** A participação tem etapa e dados próprios do processo.
- **Cadastrar vários contratos por Empresa → Custom Object.** Cada contrato tem identidade, atributos e relação próprios.

## Evite erros comuns {#evite-erros-comuns}

- Não crie um Object para guardar apenas um valor que poderia ser um atributo.
- Não escreva o nome de outro Record em texto quando a informação precisa ser um relacionamento.
- Não crie uma Lista quando uma View filtrada já mantém o conjunto atualizado.
- Não repita o mesmo atributo em várias Listas se ele descreve o Record em todos os contextos; mova-o para o Object.
- Não duplique Objects para cada equipe quando todos trabalham com as mesmas entidades.

## Use este caminho de decisão {#use-este-caminho-de-decisao}

1. A informação precisa de cadastro, vários atributos e relações próprias? Crie um **Object**.
2. Ela conecta dois Records existentes? Crie um **relacionamento**.
3. Ela é apenas um valor que descreve um Record? Crie um **atributo**.
4. Os Records participam de um processo com dados próprios? Crie uma **Lista**.
5. Você só precisa filtrar, ordenar ou apresentar os mesmos dados? Crie uma **View**.

## A seguir {#a-seguir}

Com o modelo de dados concluído, veja como Notas preservam contexto e como Tarefas organizam os próximos passos da equipe.

[Introdução a Tarefas](https://spryx.ai/help/primeiros-passos/introducao-a-tarefas) — Organize os próximos passos da equipe com prazo, responsáveis e Records relacionados.

## Perguntas frequentes

### Preciso definir todo o modelo antes de começar?

Não. Comece pelas entidades e informações que já estão claras. Novos atributos, relacionamentos, Listas, Views e Custom Objects podem ser adicionados conforme a operação evolui.

### Quando uma informação deve sair da Lista e ir para o Object?

Quando ela passa a descrever o Record em qualquer contexto, e não apenas sua participação naquela Lista.

### Uma View copia os Records que aparecem nela?

Não. A View consulta e apresenta os mesmos Records ou entradas com outra configuração.

### Uma Lista pode ter Views?

Sim. A Lista define a participação e seus dados próprios; as Views definem como as entradas serão exibidas.