Resumo

Os Attributes (ou Atributos) são os blocos fundamentais de informação dentro da Nuvia. Eles definem as características e propriedades dos objetos da plataforma, como People, Companies e Deals, garantindo que todos os dados sejam padronizados, consistentes e reutilizáveis em listas, relatórios, automações e integrações.

Que é um Attribute?

Um Attribute representa um campo de informação que descreve uma característica de um objeto.

Exemplos:

Uma Person pode ter os atributos Nome, E-mail e Cargo;
Uma Company pode ter Nome da empresa, Indústria e Tamanho.

Os atributos podem ser de dois tipos:

System Attributes: padrões do sistema, criados pela própria Nuvia e usados em todo o produto.
Custom Attributes: criados pelos usuários para adaptar a plataforma às necessidades do negócio.

Parâmetros que definem um Attribute

Cada atributo possui um conjunto de parâmetros que descreve sua estrutura, comportamento e origem de dados. Esses parâmetros garantem a coerência no uso e a integridade dos dados.

Parâmetro	Descrição	Exemplo
Slug	Código identificador único do atributo.	`email_corporativo`
Attribute Name	Nome visível e padronizado.	“E-mail corporativo”
Format	Tipo de dado aceito.	Text, Number, URL, Currency, Date, Select, etc.
Constraints	Regras aplicadas (Unique, Required, Immutable).	E-mail = Unique
Type	Origem do atributo (System ou Custom).	Custom
Data Source	Origem do valor (User input, System default, Provider-enriched, AI-generated).	Created at → System default
Relationship	Define a relação entre objetos (1:1, 1:N, N:M).	Uma Company pode ter várias People
Object	Entidade à qual o atributo pertence.	People, Company ou Deal

Slug

O Slug é o código identificador único de um atributo. Ele é usado pela plataforma para reconhecer o campo internamente, garantindo que não haja duplicações.

Exemplo:

Nome visível: “Email Address”
Slug: email

Attribute Name

É o nome visível do atributo — como ele aparece para o usuário na interface da Nuvia. Deve ser claro, descritivo e seguir um padrão de nomenclatura que facilite a identificação.

Exemplos:

“Nome completo”
“Data de fechamento”
“Indústria da empresa”

Format

Define o tipo de dado aceito pelo atributo. Isso garante que cada campo receba apenas o tipo de informação correto, mantendo a consistência dos dados.

Principais formatos:

Text: textos livres (nomes, descrições).
Number: números inteiros ou decimais.
Date / Timestamp: datas e horários.
Select / Multi-select: opções predefinidas.
Currency: valores monetários.
URL: endereços de sites.
User / Relationship: associações com outros objetos.

Exemplo: O atributo “Valor do Deal” utiliza o formato Currency.

Constraints

As Constraints são regras que controlam o comportamento do atributo. Elas ajudam a definir restrições e garantir a integridade dos dados.

Tipos comuns:

Unique: o valor não pode ser duplicado (ex.: e-mail).
Required: campo obrigatório.
Immutable: não pode ser alterado depois de criado.

Exemplo: O atributo “E-mail” de uma pessoa deve ser Unique para evitar cadastros repetidos.

Type

O Type classifica o atributo de acordo com sua origem:

System: criado pela Nuvia como parte do sistema padrão.
Custom: criado pelo usuário administrador.

Exemplos:

“Created at” → System
“Departamento interno” → Custom

Data Source

Define como o valor do atributo é gerado ou preenchido. Isso permite rastrear a origem da informação e saber se ela vem do usuário, do sistema ou de integrações externas.

Principais origens:

User input: digitado manualmente.
System default: preenchido automaticamente pela Nuvia.
Eriched: obtido via integração com provedores de dados.
AI-boosted: inferido ou gerado por inteligência artificial.

Exemplo: “Created at” é System default; “Indústria” pode ser Enriched.

Relationship

O parâmetro Relationship descreve como o atributo se conecta a outros objetos dentro da Nuvia. Essas relações criam vínculos entre entidades como People, Company e Deal.

Tipos de relacionamento:

1:1 (um-para-um): uma Company tem um e-mail principal.
1:N (um-para-muitos): uma Company pode ter várias People associadas.
N:M (muitos-para-muitos): uma Person pode estar em vários Deals e vice-versa.

Importante: as relações são bidirecionais — um objeto “sabe” com o que está conectado, sem duplicar atributos.

Object

O Object é a entidade que contém o atributo. Cada atributo pertence a um tipo de objeto específico dentro da Nuvia.

Objetos disponíveis:

People → atributos de pessoas ou contatos.
Company → atributos de empresas ou organizações.
Deal → atributos de oportunidades, transações ou negócios.

Exemplo: O atributo “Cargo” pertence ao objeto People; “Indústria” pertence ao objeto Company.

FAQ — Dúvidas frequentes

Para que servem os Attributes?

Para estruturar, categorizar e relacionar informações dentro da Nuvia de forma organizada e automatizável.

Posso criar meus próprios Attributes?

Sim, desde que você tenha permissões de administrador. Esses são chamados de Custom Attributes.

Qual é a diferença entre Attribute e Object?

O Attribute é a informação (ex.: “Nome”), enquanto o Object é a entidade que a contém (ex.: People).

O que são Relationships?

São as conexões entre objetos, como uma pessoa vinculada a uma empresa ou um negócio associado a vários contatos.

Os Attributes são usados onde?

Em records, campaigns, geração de insights, dashboards, etc.