O RockZap® 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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeHFsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e46dfd7d73113656e704b5293ba36bee57ace26e/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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeGlsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d3762a92e49d6c2dc47cf5f6c9466ed04c24f743/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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeHlsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--66e2a83a11b6d1cecb0d51d6da7875ff7fac202e/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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeHVsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2034b6728a1511c76b5dfe2c6f76b0379e37fc0e/populating-20a-20custom-20attribute-202.png)

![](https://app.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeGFsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b40a2fec4a3c163324b22ed210e02a9cdd2bfe35/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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeGVsRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d8d2dd0270718ab9d6f412deaa99daca6435e79e/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.rockzap.com.br/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBeG1sRFE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--900bd187fc5ccc1359f8167208cf5a15620a4bc8/populating-20a-20custom-20attribute.png)