# Objetos Customizados

## Introdução

Objetos Customizados são estruturas definidas para armazenar informações diversas dentro de um contato. Um mesmo contato pode conter qualquer número de Objetos Customizados, que podem ser criados por meio de automações ou manualmente.

**Exemplos de possíveis Objetos Customizados:**

* Feedbacks: ID do atendimento, mensagem do feedback (opcional) e nota do atendimento.
* Pedido: ID do pedido, nome do pedido e valor unitário.
* Exames Solicitados: Tipo de exame, data do agendamento, laboratório.
* Participações em Eventos: Nome do evento, data, presença confirmada, observações.
* Treinamentos Internos: Nome do treinamento, carga horária, data, conclusão (sim/não).

## Criando uma definição de Objeto Customizado

Entre no menu de **Configurações**, e em seguida em **Objetos Customizados**. Após isso, clique no botão **Novo**, para criar uma nova definição.

O valor preenchido no campo **Nome (Plural)** será exibido como uma nova aba no perfil de todos os contatos, representando uma lista de objetos vinculados.\
Para que um Objeto Customizado esteja disponível na instância, é necessário marcar a opção **Publicado**.

Se você deseja permitir a criação automática desses objetos por meio de chatbots, automações, webhooks integrados, ou através da própria página de contatos, ative também a opção **Permitir criação dinâmica de objetos**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2Fk03dxg0xH1bIhReiGQBi%2Fimage.png?alt=media&#x26;token=82d48fdf-165d-4ed7-b738-e74a927d8cc6" alt=""><figcaption><p><em>Menu de Configurações.</em></p></figcaption></figure>

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2Fsh02mxyOlDO5mFFUfQrc%2Fimage.png?alt=media&#x26;token=f4d68f98-e5ae-4159-b318-5e9e0284c3ca" alt=""><figcaption><p><em>Lista de definições.</em></p></figcaption></figure>

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FqtgEUD0WzRmvjvtL2y9r%2Fimage.png?alt=media&#x26;token=6951e1d0-cdfa-4d30-9600-043c663cbbf8" alt=""><figcaption><p><em>Tela de Editar Definição.</em></p></figcaption></figure>

## Configurações dos Campos

Ao criar um novo campo para a definição de um Objeto Customizado, é necessário selecionar o **tipo de dado**, como *Texto*, *Número*, *Data*, entre outros — conforme listado na imagem abaixo.

Cada campo pode ter algumas configurações adicionais:

* **Obrigatório:** Exige que o campo seja preenchido no momento da criação ou edição do objeto customizado.
* **Identificador Único:** Define se o valor do campo será exclusivo para cada objeto, funcionando como um identificador único (útil para casos como ID de pedidos, códigos de protocolo, etc.).
* **Valor Padrão:** Valor que será preenchido automaticamente ao criar um novo objeto, podendo ser alterado manualmente se necessário.
* **Alias:** Define como o campo será referenciado em outras partes do sistema, como no uso de *tokens*. Veja mais sobre tokens de objetos customizados.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FmeACfu9lQu69TIwkTKNL%2Fimage.png?alt=media&#x26;token=028f085a-2a9a-4be5-9a49-b1e4d374021f" alt=""><figcaption><p><em>Lista de tipos de campos.</em></p></figcaption></figure>

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2Ft4lDHjQzAgbHo405P10p%2Fimage.png?alt=media&#x26;token=06805c80-ee53-49a7-87fd-96bf09d1c42d" alt=""><figcaption><p><em>Tela de edição do campo.</em></p></figcaption></figure>

## Preenchendo um Objeto Manualmente

Ao acessar os dados completos de um lead, será possível visualizar a aba **Participações em Eventos**, onde são listados os objetos customizados associados a ele.

Você pode **relacionar um objeto customizado pré-existente** a um lead — ideal, por exemplo, em casos de planos de assinatura fixos, onde basta relacionar ao lead sem criar um novo objeto do zero.\
No entanto, neste exemplo, optaremos por criar um novo objeto customizado.

Após criado, o objeto aparecerá automaticamente na aba **Participações em Eventos** do lead.\
Esses dados poderão ser utilizados em **tokens** (para personalizações em mensagens, por exemplo) ou consultados via **automações**, conforme necessário.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FYNIJmIiImVUCyr70vWCF%2Fimage.png?alt=media&#x26;token=469bd4b1-9a3f-447e-8623-c862ed5f196f" alt=""><figcaption><p><em>Dados completos do contato.</em></p></figcaption></figure>

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FJmwmdEJ0eoqlyyNMjoAQ%2Fimage.png?alt=media&#x26;token=d92ad282-ff66-4231-8f46-15467993fb9f" alt=""><figcaption><p><em>Preenchendo um objeto.</em></p></figcaption></figure>

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2Fg5rK3A7LmnNEexu8oON0%2Fimage.png?alt=media&#x26;token=70fa9346-fd82-45ec-ae1e-386de2b704a6" alt=""><figcaption><p><em>Evento cadastrado.</em></p></figcaption></figure>
