Os objetos personalizados permitem que você recrie seu modelo de dados no Brevo definindo novos objetos para armazenar informações mais relevantes para sua empresa. Neste artigo, veremos o exemplo de uma empresa de aluguel de carros e criaremos um objeto personalizado chamado "Carros". Esse objeto personalizado é definido por vários atributos (número da placa, marca, cor etc.) e está associado aos contatos.

Antes de começar

• Os objetos personalizados devem satisfazer suas necessidades. Para saber mais sobre objetos personalizados e como eles podem ser usados no Brevo, confira nosso artigo dedicado O que são objetos personalizados?.
• Por enquanto, você só pode importar dados de objetos personalizados de uma API ou sincronizando com o CDP.

Etapa 1: definir o nome e a finalidade do objeto

Para criar um objeto personalizado:

1. Acesse Contacts > Settings > Object management (Contatos > Configurações > Gerenciamento de objetos).
2. Clique em Create custom objects (Criar objetos personalizados).
3. Insira o nome do objeto no singular. Um ID de objeto é criado automaticamente.
   Um ID de objeto é um identificador exclusivo usado ao sincronizar seus dados por meio de integrações ou APIs.
4. (Opcional) Para editar seu ID de objeto:

   1. Clique no ícone de caneta ao lado do ID do objeto.

      ❗️ Importante

      O ID do objeto deve começar com uma letra e pode incluir apenas letras minúsculas (a–z), números (0–9) e sublinhados (_). Outros caracteres especiais não são permitidos.

   2. Clique em Save changes (Salvar alterações).
5. Insira o nome do seu objeto no plural.
   
6. Clique em Continue (Continuar).

Etapa 2: definir o primeiro atributo do seu objeto

Um atributo é um campo de dados que contém informações específicas sobre seu objeto, como número da placa, marca ou cor.

Para definir o primeiro atributo do seu objeto:

1. Insira o nome do primeiro atributo.
2. O tipo do primeiro atributo só pode ser texto. Você pode criar diferentes tipos de atributos depois de criar seu objeto personalizado.
   
3. Clique em Continue (Continuar).

Etapa 3: criar associações para seu objeto 

Objetos personalizados podem ser vinculados a contatos ou outros objetos, padrão ou personalizados. Essas associações aparecem na página de detalhes e na visualização de listagem de cada objeto.

Para criar associações para seu objeto:

1. Selecione o tipo de associação que você quer criar.
   Vamos considerar um objeto personalizado, Carro, que você quer associar a um contato. A tabela a seguir mostra todos os tipos de associação que você pode criar e fornece uma descrição e um exemplo.

   Tipo de associação	Descrição	Exemplo
   Muitos para um	Vários dos seus objetos podem ser associados a uma instância do outro objeto.	Vários carros podem ser associados a apenas um contato.
   Um para muitos	Seu objeto pode ser associado a várias instâncias do outro objeto.	Um carro pode ser associado a vários contatos.
   Muitos para muitos	Várias instâncias do seu objeto podem ser associadas a várias instâncias do outro objeto.	Vários carros podem ser associados a vários contatos.

2. Selecione o objeto ao qual você quer associar seu objeto.
   
3. (Opcional) Clique em Add association (Adicionar associação) e repita as etapas 1 e 2 para criar mais associações.
4. (Opcional) Clique no ícone da lixeira para excluir uma associação.
5. Clique em Create association (Criar associação).

Seu objeto foi criado. Você pode visualizar e gerenciar seu objeto personalizado na página Objetos personalizados.

Etapa 4: adicionar dados

Agora que criou seu objeto personalizado, você pode adicionar os dados do cliente correspondentes a esse objeto. Por exemplo, em nosso exemplo de uma empresa de aluguel de carros, agora podemos adicionar todos os carros que alugamos junto com os detalhes (número da placa, marca, cor etc.) e associá-los aos contatos que alugaram os carros.

Por enquanto, você não pode importar ou adicionar registros de objetos diretamente do Brevo. Para importar dados, você tem duas opções:

• Importar de uma API
  ➡️ Para saber mais, entre em contato com seu gerente de sucesso do cliente (CSM).
• Sincronizar com CDP
  ➡️ Para saber mais, confira nosso artigo dedicado Prepare suas fontes de dados para importação no CDP do Brevo.

Visualizar e gerenciar objetos personalizados

Depois de criar um objeto personalizado, vá para Contacts > Custom objects (Contatos > Objetos personalizados). A partir daí, você pode ver uma lista de todos os seus objetos personalizados e o número de registros que cada um deles possui. Clique no nome do objeto personalizado para visualizar os registros. Cada registro tem sua própria página de detalhes, assim como objetos padrão, exibindo os atributos e associações para acesso rápido a todas as informações relevantes.

Para gerenciar e criar novas associações e atributos:

1. Acesse Contacts > Settings > Object management (Contatos > Configurações > Gerenciamento de objetos).
2. Clique no nome do seu objeto personalizado na coluna Objects (Objetos).
3. Na guia Attributes (Atributos), você pode:
   1. Criar novos atributos.
      Você pode criar atributos de texto, número, data, categoria, múltipla escolha e booleanos.
   2. Clique no ícone de três pontos ao lado de um atributo para editar o nome ou excluí-lo.
      
4. Na guia Associations (Associações), você pode criar novas associações. Para saber mais, confira a etapa 3.

⏭️ O que vem a seguir?

• O que são objetos personalizados?

🤔 Dúvidas?

Em caso de dúvida, sinta-se à vontade para entrar em contato com nossa equipe de suporte, criando um tíquete a partir da sua conta. Caso ainda não tenha uma conta, entre em contato conosco aqui.

Se você está procurando ajuda com um projeto usando o Brevo, podemos encontrar à agência parceira da Brevo certa.