O Chatwoot permite que você acompanhe informações adicionais sobre suas conversas e contatos além dos atributos de dados padrão como nome, e-mail e localização. Essas informações adicionais são chamadas de atributos personalizados e podem ser qualquer coisa que você queira acompanhar. Abaixo estão alguns exemplos de atributos personalizados.

* Plano de assinatura

* Data de assinatura

* Data de cadastro

* Item mais pedido

* Link do produto pedido

* Data da última transação

Atributos de dados personalizados permitem anexar informações adicionais a uma conversa ou cliente, como histórico de compras ou status da conta. Essas informações podem ser usadas para entender melhor e segmentar sua base de clientes.

> A única diferença entre atributos personalizados e padrão é que os atributos de dados padrão são atualizados automaticamente.

## Como criar um atributo personalizado?

**Passo 1.** Vá até **Configurações → Atributos Personalizados.** Clique no botão **“Adicionar Atributo Personalizado”**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNVU2VHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--bf9d0ecb12923237206d44ac87d256ee0171a918/find%20custom%20attributes%20setting.png)

**Passo 2.** Um modal será aberto pedindo detalhes sobre o novo atributo personalizado. Preencha esses detalhes. Veja um exemplo:

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNWM2VHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6550c53c975336f9567da4dd9ab4b7e1243d6498/adding%20custom%20attribute%20example.png)

Esses são os campos necessários para criar o atributo personalizado:

1. **Aplica-se a**

   Tipo do atributo (Conversa/Contato).

2. **Nome de exibição**

   Age como um rótulo ao mostrar o atributo personalizado.

3. **Chave**

   Identificador único anexado ao atributo personalizado.

4. **Descrição**

   Descrição do atributo personalizado.

5. **Tipo**

   Texto, Número, Link, Data, Lista e Caixa de seleção.

**Nota**: Você não pode criar um atributo personalizado com a mesma chave duas vezes na conta.

**Passo 3.** Depois de inserir os detalhes, clique no botão ”**Criar”**. Se a solicitação for bem-sucedida, uma mensagem "Atributo personalizado adicionado com sucesso" será exibida.

## Como usar um atributo personalizado de conversa?

Você pode adicionar atributos personalizados de conversa a uma conversa a partir da barra lateral da conversa. Siga os passos descritos abaixo.

**Passo 1.** No seu painel, ao abrir uma conversa específica, você encontrará uma seção que diz “Informações da Conversa”. Clique no sinal de `+` para expandi-la.

**Passo 2.** Você verá uma opção chamada “Adicionar Atributos” seguida de um menu suspenso com todos os Atributos Personalizados da sua conta. Use a barra de pesquisa para filtrar pelo nome do atributo que procura. Ou clique em um deles para selecionar. Se precisar criar um novo, use o botão “Criar novo atributo” no mesmo menu.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeFU3VHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8c46a22f31d1622907dba24b73a3ca57752eb358/using%20custom%20attribute%20in%20a%20conversation.png)

**Passo 3.** De acordo com o tipo de atributo que você adicionou (lista, caixa de seleção, texto etc.), preencha-o como desejar. Aqui estão alguns exemplos:

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBL0k2VHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--11d2fafc07b5c2bb8de31129fb8029e288fce4a5/populating%20a%20custom%20attribute%202.png)

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeDA3VHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--40761b8b33df07666e53546e830cb5b2f3430b82/populate%20a%20custom%20attribute%20for%20conversation.png)

Para editar/excluir/copiar um atributo, passe o mouse sobre ele para ver as opções.

## Como usar um atributo personalizado de contato?

Existem duas maneiras de definir atributos personalizados para contatos.

### Definir atributos via método SDK

Para definir um atributo personalizado do contato, chame o método `setCustomAttributes` da seguinte forma.

```
window.$chatwoot.setCustomAttributes({
  key: value,
  // Key is a unique identifier which is already defined while creating a custom attribute
  // Value should be based on type (Currently support Number, Date, String and Number)
  // Double-check that your keys always have a JSON-valid value
  // You need to flatten nested JSON structure while using this function
});
```

**Exemplo**:

```
window.$chatwoot.setCustomAttributes({
  key: value,
  // Key is a unique identifier which is already defined while creating a custom attribute
  // Value should be based on type (Currently support Number, Date, String and Number)
  // Double-check that your keys always have a JSON-valid value
  // You need to flatten nested JSON structure while using this function
});
```

Você pode visualizar esses atributos no painel lateral do contato/conversa.

Para excluir um atributo personalizado, use deleteCustomAttribute da seguinte forma.

```
window.$chatwoot.deleteCustomAttribute("attribute-key");
```

**Exemplo**:

```
window.$chatwoot.deleteCustomAttribute("signUpDate");
```

**Nota**: Antes da versão v1.22, todos os atributos eram exibidos como texto. Por favor, crie uma nova definição para exibir o valor corretamente.

### Definir atributos via painel lateral do contato

Para adicionar Atributos de Contato, siga o mesmo procedimento descrito acima para atributos personalizados de conversas, mas use a seção `Atributos de Contato` da barra lateral do chat. Veja como seria:

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMVE3VHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b22bc9c2b99020928d96dddf3abe65f6cfd0e902/contact%20attribute.png)

De acordo com o tipo de atributo que você adicionou (lista, caixa de seleção, texto etc.), preencha-o como desejar. Veja um exemplo:

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeFk3VHc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9e376e43cee0a804de3ea1c9a3d4c110a4d8c0cb/populating%20a%20custom%20attribute.png)