> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Atributos Personalizados

A seção de **Atributos Personalizados** (Custom Attributes) permite que você crie e gerencie campos personalizados para coletar informações específicas sobre conversas, contatos ou itens do pipeline. Com os atributos personalizados, você pode estender os dados padrão do sistema e coletar informações relevantes para o seu negócio.

Cada atributo personalizado possui um nome de exibição, uma chave técnica para identificação na API, uma descrição, um tipo de dado e opcionalmente validação por expressão regular (regex). Os atributos podem ser aplicados a diferentes contextos: **Conversas**, **Contatos** ou **Pipeline** (com sub-opções para Pipeline, Estágio ou Item).

## Acessando Atributos Personalizados

Para acessar a área de gerenciamento de atributos personalizados:

1. No menu lateral esquerdo, clique em **Settings** (Configurações).
2. Na lista de opções de configurações, selecione **Custom Attributes** (Atributos Personalizados).

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/01-accessing-custom-attributes.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=03d45a03c19fedabc9e2b1e55aba2c33" alt="Acessando Atributos Personalizados - Item Custom Attributes destacado no menu lateral e estado vazio" width="600" height="776" data-path="user-guides/settings/images/01-accessing-custom-attributes.png" />

A tela principal de atributos personalizados será exibida, mostrando todos os atributos criados ou uma mensagem indicando que nenhum atributo foi criado ainda.

***

## Categorias de Atributos

Os atributos personalizados são organizados em três categorias principais, acessíveis através de abas na parte superior da tela:

* **Conversas (Conversations):** Atributos aplicados às conversas
* **Contatos (Contacts):** Atributos aplicados aos contatos
* **Pipeline:** Atributos aplicados a pipelines, estágios ou itens

<img src="https://mintcdn.com/evoai-683d737d/R_mcnK0kmJ12P2SF/user-guides/settings/images/custom-attributes-categories.png?fit=max&auto=format&n=R_mcnK0kmJ12P2SF&q=85&s=bff60b589b275f73e6dc1d0cf1b67218" alt="Estado vazio de atributos personalizados com botões New Attribute destacados e abas Conversas, Contatos e Pipeline" width="502" height="292" data-path="user-guides/settings/images/custom-attributes-categories.png" />

***

## Pesquisando Atributos Personalizados

A barra de pesquisa permite localizar atributos personalizados rapidamente pelo nome, descrição ou chave.

### Como pesquisar

1. Na parte superior da tela, localize o campo **"Search custom attributes..."** com o ícone de lupa
2. Digite o nome, descrição ou chave do atributo desejado
3. A tabela de atributos será atualizada automaticamente conforme o termo digitado, mostrando apenas os atributos que correspondem à busca

<img src="https://mintcdn.com/evoai-683d737d/R_mcnK0kmJ12P2SF/user-guides/settings/images/custom-attributes-search.png?fit=max&auto=format&n=R_mcnK0kmJ12P2SF&q=85&s=9511eb90c1d2bfebb00a1027b07162db" alt="Barra de pesquisa de atributos personalizados destacada com termo de busca digitado mostrando resultado na tabela" width="687" height="371" data-path="user-guides/settings/images/custom-attributes-search.png" />

A busca é realizada em tempo real, facilitando a localização de atributos específicos quando há muitos cadastrados.

***

## Visualizando Atributos Personalizados na Tabela

Após criar atributos personalizados, eles serão exibidos em uma tabela com as seguintes colunas:

### Colunas da Tabela

* **Name (Nome):** Nome de exibição do atributo personalizado
  * Exibe o nome definido durante a criação (ex: "Prioridade do Lead", "Cargo", "Motivo do Contato")
  * A coluna é ordenável (indicada por setas para cima/baixo)
* **Description (Descrição):** Descrição completa do atributo
  * Exibe a descrição definida durante a criação
  * Ajuda a entender o propósito do atributo
* **Type (Tipo):** Tipo de dado do atributo
  * Exibido em uma tag azul (ex: "Texto", "Número", "Data")
  * Indica o formato de dados aceito pelo atributo
* **Key (Chave):** Chave técnica do atributo
  * Exibida em uma tag cinza (ex: "prioridade\_do\_lead", "cargo", "motivo\_do\_contato")
  * Usada para identificar o atributo na API
* **Values (Valores):** Valores pré-definidos (se aplicável)
  * Exibe valores pré-definidos para atributos do tipo lista ou seleção
  * Mostra "-" quando não aplicável
* **Regex:** Indica se o atributo possui validação por expressão regular
  * Exibido em uma tag verde com "Yes" quando há regex configurada
  * Exibido como "-" quando não há validação regex
* **Created at (Criado em):** Data de criação do atributo
  * Exibe a data no formato DD/MM/AAAA (ex: "23/01/2026")
  * A coluna é ordenável (indicada por setas para cima/baixo)
* **Model (Modelo):** Modelo ao qual o atributo se aplica (apenas para Pipeline)
  * Exibe "Item", "Stage" ou "Pipeline" para atributos de pipeline
  * Não exibido para atributos de Conversas ou Contatos
* **Actions (Ações):** Menu de ações para gerenciar o atributo

  * Ícone de três pontos horizontais (`...`) que abre um menu dropdown com opções

  <img src="https://mintcdn.com/evoai-683d737d/R_mcnK0kmJ12P2SF/user-guides/settings/images/custom-attributes-model.png?fit=max&auto=format&n=R_mcnK0kmJ12P2SF&q=85&s=738004b3e337fe15c783637806e2bf23" alt="Modelo visual da tabela de atributos personalizados mostrando todas as colunas" width="1483" height="340" data-path="user-guides/settings/images/custom-attributes-model.png" />

### Funcionalidades da Tabela

* **Ordenação:** As colunas Name e Created at podem ser ordenadas clicando no cabeçalho
* **Busca Integrada:** A barra de pesquisa acima da tabela filtra os resultados em tempo real
* **Filtro por Categoria:** Use as abas (Conversas, Contatos, Pipeline) para filtrar atributos por categoria
* **Contador:** O número total de atributos na categoria atual é exibido abaixo do título

***

## Atributos para Conversas

Os atributos de conversas permitem coletar informações específicas sobre conversas, como motivo do contato, satisfação do cliente, ou qualquer outro dado relevante ao contexto da conversa.

### Criando um Atributo para Conversas

Para criar um novo atributo personalizado para conversas:

1. Na tela de Atributos Personalizados, clique na aba **"Conversas"** para filtrar apenas atributos de conversas
2. Clique no botão verde **"+ New Custom Attribute"** no canto superior direito da tela
3. Um modal será exibido com o título **"New Custom Attribute"**

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/03-custom-attribute-conversations-form.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=375502181047b3fcf76c47759c12e900" alt="Modal de criação de novo atributo personalizado para Conversas com todos os campos destacados" width="626" height="777" data-path="user-guides/settings/images/03-custom-attribute-conversations-form.png" />

#### Preenchendo o Formulário

No formulário, preencha os seguintes campos:

**1. Apply to (Aplicar a) - Obrigatório**

* Selecione **"Conversas"** no dropdown
* O texto de ajuda exibirá: "Atributos aplicados às conversas"

**2. Display Name (Nome de Exibição) - Obrigatório**

* Digite um nome amigável que será exibido aos usuários
* **Exemplo:** "Motivo do Contato"

**3. Attribute Key (Chave do Atributo) - Obrigatório**

* A chave técnica será gerada automaticamente a partir do Display Name
* Use apenas letras minúsculas, números e underscores
* **Exemplo:** `motivo_do_contato`

**4. Description (Descrição) - Obrigatório**

* Explique o propósito do atributo
* **Exemplo:** "Identify the main reason why the customer contacted you."

**5. Type (Tipo) - Obrigatório**

* Selecione o tipo de dado (Texto, Número, Data, Booleano, Lista)
* Para o exemplo "Motivo do Contato", selecione **"Texto"**

**6. Regex Validation (Validação Regex) - Opcional**

* Ative o toggle se desejar validar o formato do texto
* **Exemplo de Regex Pattern:** `^.{5,}$` (mínimo 5 caracteres)
* **Exemplo de Regex Cue:** "Describe the reason for contacting us (minimum 5 characters)."

#### Finalizando a Criação

Após preencher todos os campos obrigatórios:

1. Revise as informações inseridas
2. Verifique se a validação regex está configurada corretamente (se aplicável)
3. Clique no botão verde **"Create"** para criar o atributo
4. O atributo será criado e aparecerá na tabela de atributos de Conversas

### Editando um Atributo de Conversas

Para modificar um atributo de conversas existente:

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/04-editing-conversation-attribute.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=0b122bc4c9f8970c3432f1fb2859698a" alt="Modal de edição de atributo personalizado para Conversas com exemplo Motivo do Contato e validação regex" width="257" height="397" data-path="user-guides/settings/images/04-editing-conversation-attribute.png" />

1. Na tabela de atributos, certifique-se de que a aba **"Conversas"** está selecionada

2. Localize o atributo que deseja editar

3. Na coluna **Actions**, clique no ícone de três pontos (`...`)

4. No menu dropdown, clique em **Edit** (ícone de lápis)

5. Um modal será aberto com o título **"Edit Custom Attribute"** e os campos já preenchidos

6. Modifique os campos desejados:
   * Display Name
   * Description
   * Type (cuidado ao alterar, pois pode afetar dados existentes)
   * Regex Validation (ativar/desativar ou modificar padrão e dica)

7. Clique no botão verde **"Update"** para salvar as alterações

<Warning>
  Tenha cuidado ao alterar o **Attribute Key** ou o **Type** de um atributo existente, pois isso pode afetar integrações via API e dados já coletados.
</Warning>

### Excluindo um Atributo de Conversas

Para remover um atributo de conversas:

1. Na tabela de atributos, localize o atributo que deseja excluir

2. Na coluna **Actions**, clique no ícone de três pontos (`...`)

3. No menu dropdown, clique em **Delete** (ícone de lixeira em vermelho)

4. Confirme a exclusão no diálogo que aparecer

**Atenção:** A exclusão é permanente e todos os dados coletados através deste atributo serão perdidos.

***

## Atributos para Contatos

Os atributos de contatos permitem armazenar informações adicionais sobre contatos, como cargo, departamento, preferências ou qualquer outro dado relevante ao perfil do contato.

### Criando um Atributo para Contatos

Para criar um novo atributo personalizado para contatos:

1. Na tela de Atributos Personalizados, clique na aba **"Contatos"** para filtrar apenas atributos de contatos
2. Clique no botão verde **"+ New Custom Attribute"** no canto superior direito da tela
3. Um modal será exibido com o título **"New Custom Attribute"**

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/05-custom-attribute-contacts-form.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=d2c6f19c1d19470f29c0aac2d78b2fa8" alt="Modal de criação de novo atributo personalizado para Contatos com exemplo Cargo e validação regex ativada" width="627" height="781" data-path="user-guides/settings/images/05-custom-attribute-contacts-form.png" />

#### Preenchendo o Formulário

No formulário, preencha os seguintes campos:

**1. Apply to (Aplicar a) - Obrigatório**

* Selecione **"Contatos"** no dropdown
* O texto de ajuda exibirá: "Atributos aplicados aos contatos"

**2. Display Name (Nome de Exibição) - Obrigatório**

* Digite um nome amigável que será exibido aos usuários
* **Exemplo:** "Cargo"

**3. Attribute Key (Chave do Atributo) - Obrigatório**

* A chave técnica será gerada automaticamente a partir do Display Name
* Use apenas letras minúsculas, números e underscores
* **Exemplo:** `cargo`

**4. Description (Descrição) - Obrigatório**

* Explique o propósito do atributo
* **Exemplo:** "Indicates the contact's position or role within the company."

**5. Type (Tipo) - Obrigatório**

* Selecione o tipo de dado (Texto, Número, Data, Booleano, Lista)
* Para o exemplo "Cargo", selecione **"Texto"**

**6. Regex Validation (Validação Regex) - Opcional**

* Ative o toggle se desejar validar o formato do texto
* **Exemplo de Regex Pattern:** `^.{2,}$` (mínimo 2 caracteres)
* **Exemplo de Regex Cue:** "Please provide the contact's job title (minimum 2 characters)."

#### Finalizando a Criação

Após preencher todos os campos obrigatórios:

1. Revise as informações inseridas
2. Verifique se a validação regex está configurada corretamente (se aplicável)
3. Clique no botão verde **"Create"** para criar o atributo
4. O atributo será criado e aparecerá na tabela de atributos de Contatos

### Editando um Atributo de Contatos

Para modificar um atributo de contatos existente:

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/06-editing-contact-attribute.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=aa2cdfdce27f455c1d9243fc748adb2b" alt="Modal de edição de atributo personalizado para Contatos" width="237" height="402" data-path="user-guides/settings/images/06-editing-contact-attribute.png" />

1. Na tabela de atributos, certifique-se de que a aba **"Contatos"** está selecionada
2. Localize o atributo que deseja editar
3. Na coluna **Actions**, clique no ícone de três pontos (`...`)
4. No menu dropdown, clique em **Edit** (ícone de lápis)
5. Um modal será aberto com o título **"Edit Custom Attribute"** e os campos já preenchidos
6. Modifique os campos desejados
7. Clique no botão verde **"Update"** para salvar as alterações

<Warning>
  Tenha cuidado ao alterar o **Attribute Key** ou o **Type** de um atributo existente, pois isso pode afetar integrações via API e dados já coletados.
</Warning>

### Excluindo um Atributo de Contatos

Para remover um atributo de contatos:

1. Na tabela de atributos, localize o atributo que deseja excluir
2. Na coluna **Actions**, clique no ícone de três pontos (`...`)
3. No menu dropdown, clique em **Delete** (ícone de lixeira em vermelho)
4. Confirme a exclusão no diálogo que aparecer

**Atenção:** A exclusão é permanente e todos os dados coletados através deste atributo serão perdidos.

***

## Atributos para Pipeline

Os atributos de pipeline permitem coletar informações específicas sobre oportunidades de vendas. Eles podem ser aplicados ao pipeline como um todo, aos estágios ou aos itens (deals/leads).

### Criando um Atributo para Pipeline

Para criar um novo atributo personalizado para pipeline:

1. Na tela de Atributos Personalizados, clique na aba **"Pipeline"** para filtrar apenas atributos de pipeline
2. Clique no botão verde **"+ New Custom Attribute"** no canto superior direito da tela
3. Um modal será exibido com o título **"New Custom Attribute"**

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/07-custom-attribute-pipelines-form.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=340b8376b00a97591c0a1e2b3e1705a3" alt="Modal de criação de novo atributo personalizado para Pipeline com campo Pipeline Type destacado e exemplo Prioridade do Lead" width="632" height="842" data-path="user-guides/settings/images/07-custom-attribute-pipelines-form.png" />

#### Preenchendo o Formulário

No formulário, preencha os seguintes campos:

**1. Apply to (Aplicar a) - Obrigatório**

* Selecione **"Pipeline"** no dropdown
* O texto de ajuda exibirá: "Atributos aplicados a pipelines, estágios ou items"
* **Importante:** Quando "Pipeline" é selecionado, um campo adicional "Pipeline Type" será exibido

**2. Pipeline Type (Tipo de Pipeline) - Obrigatório**

* Selecione uma das opções:
  * **Pipeline:** Atributos aplicados ao pipeline como um todo
  * **Stage:** Atributos aplicados aos estágios do pipeline
  * **Item:** Atributos aplicados aos itens (deals/leads) do pipeline
* **Exemplo:** Para "Prioridade do Lead", selecione **"Item"**
* O texto de ajuda exibirá: "Atributos aplicados aos items (deals/leads) do pipeline"

**3. Display Name (Nome de Exibição) - Obrigatório**

* Digite um nome amigável que será exibido aos usuários
* **Exemplo:** "Prioridade do Lead"

**4. Attribute Key (Chave do Atributo) - Obrigatório**

* A chave técnica será gerada automaticamente a partir do Display Name
* Use apenas letras minúsculas, números e underscores
* **Exemplo:** `prioridade_do_lead`

**5. Description (Descrição) - Obrigatório**

* Explique o propósito do atributo
* **Exemplo:** "Define a prioridade da oportunidade no pipeline de vendas."

**6. Type (Tipo) - Obrigatório**

* Selecione o tipo de dado (Texto, Número, Data, Booleano, Lista)
* Para o exemplo "Prioridade do Lead", selecione **"Texto"**

**7. Regex Validation (Validação Regex) - Opcional**

* Ative o toggle se desejar validar o formato do texto
* **Exemplo de Regex Pattern:** `^(Baixa|Media|Alta)$` (aceita apenas "Baixa", "Media" ou "Alta")
* **Exemplo de Regex Cue:** "Use apenas: Baixa, Media ou Alta"

#### Finalizando a Criação

Após preencher todos os campos obrigatórios:

1. Revise as informações inseridas, especialmente o Pipeline Type
2. Verifique se a validação regex está configurada corretamente (se aplicável)
3. Clique no botão verde **"Create"** para criar o atributo
4. O atributo será criado e aparecerá na tabela de atributos de Pipeline

### Editando um Atributo de Pipeline

Para modificar um atributo de pipeline existente:

<img src="https://mintcdn.com/evoai-683d737d/R_mcnK0kmJ12P2SF/user-guides/settings/images/08-editing-pipeline-attribute.png?fit=max&auto=format&n=R_mcnK0kmJ12P2SF&q=85&s=984113f6ca6f6eba8b6265ce49b1a22f" alt="Modal de edição de atributo personalizado para Pipeline" width="269" height="405" data-path="user-guides/settings/images/08-editing-pipeline-attribute.png" />

1. Na tabela de atributos, certifique-se de que a aba **"Pipeline"** está selecionada

2. Localize o atributo que deseja editar

3. Na coluna **Actions**, clique no ícone de três pontos (`...`)

4. No menu dropdown, clique em **Edit** (ícone de lápis)

5. Um modal será aberto com o título **"Edit Custom Attribute"** e os campos já preenchidos

6. Modifique os campos desejados:
   * Pipeline Type (se necessário)
   * Display Name
   * Description
   * Type (cuidado ao alterar, pois pode afetar dados existentes)
   * Regex Validation (ativar/desativar ou modificar padrão e dica)

7. Clique no botão verde **"Update"** para salvar as alterações

<Warning>
  Tenha cuidado ao alterar o **Attribute Key**, **Pipeline Type** ou o **Type** de um atributo existente, pois isso pode afetar integrações via API e dados já coletados.
</Warning>

### Excluindo um Atributo de Pipeline

Para remover um atributo de pipeline:

1. Na tabela de atributos, localize o atributo que deseja excluir
2. Na coluna **Actions**, clique no ícone de três pontos (`...`)
3. No menu dropdown, clique em **Delete** (ícone de lixeira em vermelho)
4. Confirme a exclusão no diálogo que aparecer

**Atenção:** A exclusão é permanente e todos os dados coletados através deste atributo serão perdidos.

***

## Campos do Formulário em Detalhes

### Apply to (Aplicar a) - Obrigatório

* **Campo:** **Apply to** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Dropdown (menu suspenso)
* **Descrição:** Define onde o atributo será aplicado
* **Opções Disponíveis:**
  * **Conversas:** Atributos aplicados às conversas
  * **Contatos:** Atributos aplicados aos contatos
  * **Pipeline:** Atributos aplicados a pipelines, estágios ou itens
* **Texto de Ajuda:** Exibe uma descrição explicando o contexto selecionado
* **Localização:** Primeiro campo do formulário

**Nota:** Quando "Pipeline" é selecionado, um campo adicional "Pipeline Type" será exibido.

### Pipeline Type (Tipo de Pipeline) - Obrigatório (apenas para Pipeline)

* **Campo:** **Pipeline Type** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Dropdown (menu suspenso)
* **Descrição:** Define se o atributo se aplica ao pipeline, estágio ou item
* **Opções Disponíveis:**
  * **Pipeline:** Atributos aplicados ao pipeline como um todo
  * **Stage:** Atributos aplicados aos estágios do pipeline
  * **Item:** Atributos aplicados aos itens (deals/leads) do pipeline
* **Texto de Ajuda:** "Select whether this attribute applies to the pipeline, stage, or item."
* **Localização:** Segundo campo do formulário, exibido apenas quando "Pipeline" é selecionado em "Apply to"

### Display Name (Nome de Exibição) - Obrigatório

* **Campo:** **Display Name** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Campo de texto simples
* **Descrição:** Nome amigável que será exibido aos usuários
* **Exemplos:** "Prioridade do Lead", "Cargo", "Motivo do Contato"
* **Recomendação:** Use nomes descritivos e claros que facilitem a identificação do atributo
* **Localização:** Terceiro campo do formulário (ou segundo, se não for Pipeline)

### Attribute Key (Chave do Atributo) - Obrigatório

* **Campo:** **Attribute Key** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Campo de texto simples
* **Descrição:** Chave técnica usada para identificar o atributo na API
* **Texto de Ajuda:** "The key will be used to identify this attribute in the API. Use only lowercase letters, numbers and underscores."
* **Regras:**
  * Use apenas letras minúsculas, números e underscores
  * Não use espaços ou caracteres especiais
  * Geralmente é gerado automaticamente a partir do Display Name
* **Exemplos:** `prioridade_do_lead`, `cargo`, `motivo_do_contato`
* **Localização:** Quarto campo do formulário (ou terceiro, se não for Pipeline)

### Description (Descrição) - Obrigatório

* **Campo:** **Description** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Área de texto (textarea)
* **Descrição:** Explicação detalhada do propósito do atributo
* **Exemplos:**
  * "Define a prioridade da oportunidade no pipeline de vendas."
  * "Indicates the contact's position or role within the company."
  * "Identify the main reason why the customer contacted you."
* **Recomendação:** Seja claro e objetivo sobre o que o atributo representa
* **Localização:** Quinto campo do formulário (ou quarto, se não for Pipeline)

### Type (Tipo) - Obrigatório

* **Campo:** **Type** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Dropdown (menu suspenso)
* **Descrição:** Define o tipo de dado que o atributo aceitará
* **Opções Disponíveis:**
  * **Texto:** Campo de texto simples
    * **Descrição:** "Campo de texto simples"
    * Permite qualquer texto livre
  * **Número:** Campo numérico
  * **Data:** Campo de data
  * **Booleano:** Campo verdadeiro/falso
  * **Lista:** Lista de valores pré-definidos
* **Texto de Ajuda:** Exibe uma descrição do tipo selecionado
* **Localização:** Sexto campo do formulário (ou quinto, se não for Pipeline)

### Regex Validation (Validação Regex) - Opcional

Esta seção permite adicionar validação por expressão regular para garantir que os valores inseridos sigam um padrão específico.

* **Seção:** **"Regex Validation"**
* **Descrição:** "Add a regex pattern to validate the values of this attribute"
* **Toggle Switch:** Interruptor no canto superior direito da seção
  * **Desativado:** Validação regex não será aplicada
  * **Ativado:** Validação regex será aplicada (indicado por cor verde/turquesa)

Quando o toggle está ativado, dois campos adicionais são exibidos:

#### Regex Pattern (Padrão Regex)

* **Campo:** **Regex Pattern**
* **Tipo:** Campo de texto simples
* **Descrição:** Expressão regular que define o padrão de validação
* **Exemplos:**
  * `^(Baixa|Media|Alta)$` - Aceita apenas "Baixa", "Media" ou "Alta"
  * `^.{2,}$` - Aceita qualquer texto com no mínimo 2 caracteres
  * `^.{5,}$` - Aceita qualquer texto com no mínimo 5 caracteres
* **Recomendação:** Teste o padrão regex antes de salvar para garantir que funciona como esperado

#### Regex Cue (Dica Regex)

* **Campo:** **Regex Cue**
* **Tipo:** Área de texto (textarea)
* **Descrição:** Mensagem de ajuda exibida aos usuários quando preenchem o campo
* **Texto de Ajuda:** "This cue will be displayed to users when they fill in the field"
* **Exemplos:**
  * "Use apenas: Baixa, Media ou Alta"
  * "Please provide the contact's job title (minimum 2 characters)."
  * "Describe the reason for contacting us (minimum 5 characters)."
* **Recomendação:** Seja claro e específico sobre o formato esperado

***

## Tipos de Atributos Disponíveis

### Texto (Text)

* **Descrição:** Campo de texto simples
* **Uso:** Permite inserir qualquer texto livre
* **Exemplos de uso:**
  * Nome do cargo do contato
  * Motivo do contato
  * Observações gerais
* **Validação:** Pode ser combinado com regex para restringir o formato ou tamanho

### Número (Number)

* **Descrição:** Campo numérico
* **Uso:** Permite inserir valores numéricos
* **Exemplos de uso:**
  * Valor estimado de uma oportunidade
  * Número de funcionários da empresa
  * Pontuação de satisfação

### Data (Date)

* **Descrição:** Campo de data
* **Uso:** Permite selecionar ou inserir uma data
* **Exemplos de uso:**
  * Data de aniversário do contato
  * Data prevista de fechamento da oportunidade
  * Data de último contato

### Booleano (Boolean)

* **Descrição:** Campo verdadeiro/falso
* **Uso:** Permite marcar como verdadeiro ou falso
* **Exemplos de uso:**
  * Cliente VIP (sim/não)
  * Aceita receber marketing (sim/não)
  * Oportunidade qualificada (sim/não)

### Lista (List)

* **Descrição:** Lista de valores pré-definidos
* **Uso:** Permite selecionar um valor de uma lista pré-definida
* **Exemplos de uso:**
  * Prioridade (Baixa, Média, Alta)
  * Status (Ativo, Inativo, Pendente)
  * Fonte do lead (Website, Referência, Campanha)

***

## Validação por Expressão Regular (Regex)

A validação por regex permite garantir que os valores inseridos nos atributos sigam um padrão específico, melhorando a qualidade e consistência dos dados coletados.

### Quando Usar Regex

* **Valores Pré-definidos:** Quando você quer restringir a entrada a valores específicos (ex: "Baixa", "Media", "Alta")
* **Formato Específico:** Quando você precisa de um formato específico (ex: código de produto, número de telefone)
* **Tamanho Mínimo/Máximo:** Quando você precisa garantir um tamanho mínimo ou máximo de texto
* **Padrões Complexos:** Quando você precisa validar padrões mais complexos (ex: emails, URLs, códigos)

### Exemplos de Padrões Regex

#### Valores Pré-definidos

```
^(Baixa|Media|Alta)$
```

* Aceita apenas "Baixa", "Media" ou "Alta"
* Regex Cue: "Use apenas: Baixa, Media ou Alta"

#### Tamanho Mínimo

```
^.{2,}$
```

* Aceita qualquer texto com no mínimo 2 caracteres
* Regex Cue: "Please provide at least 2 characters."

```
^.{5,}$
```

* Aceita qualquer texto com no mínimo 5 caracteres
* Regex Cue: "Describe the reason for contacting us (minimum 5 characters)."

#### Formato de Email

```
^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
```

* Valida formato de email básico
* Regex Cue: "Please provide a valid email address."

### Dicas para Regex

* **Teste Antes:** Sempre teste seu padrão regex antes de salvar para garantir que funciona como esperado
* **Seja Específico:** Use Regex Cue para explicar claramente o formato esperado aos usuários
* **Documentação:** Considere documentar padrões regex complexos para facilitar manutenção futura
* **Performance:** Padrões regex muito complexos podem afetar a performance, use com moderação

***

## Considerações Finais

* **Nomenclatura Consistente:** Use nomes de exibição e chaves consistentes para facilitar a organização e busca
* **Descrições Claras:** Escreva descrições claras e objetivas que expliquem o propósito de cada atributo
* **Validação Apropriada:** Use validação regex quando necessário para garantir qualidade dos dados, mas não seja excessivamente restritivo
* **Categorização:** Organize os atributos nas categorias apropriadas (Conversas, Contatos, Pipeline) para facilitar o gerenciamento
* **Revisão Regular:** Revise periodicamente os atributos existentes para garantir que continuam relevantes e atualizados
* **Documentação:** Documente atributos personalizados complexos ou com padrões regex específicos para facilitar o uso pela equipe
* **Integração API:** Lembre-se de que o Attribute Key é usado na API - mantenha consistência e evite alterações desnecessárias
* **Impacto em Dados:** Considere o impacto em dados existentes antes de alterar o Type ou excluir um atributo
* **Uso Estratégico:** Use atributos personalizados para coletar informações que agregam valor ao seu processo de negócio

Os atributos personalizados são uma ferramenta poderosa para estender a funcionalidade do sistema e coletar informações específicas do seu negócio, permitindo uma gestão mais completa e personalizada de conversas, contatos e oportunidades de vendas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.