![Fluxo para criar um atributo personalizado em Configurações, preencher seus campos, salvá-lo e depois usá-lo na barra lateral da conversa ou do contato, inclusive via SDK.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcjhRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1aa81b3b21b1cf67a159b9cec06ea5fd89fdb695/1718031362-como-criar-e-usar-atributos-personalizados.png)

Além dos atributos de dados padrão — como nome, e-mail e localização — você pode acompanhar informações adicionais sobre suas conversas e contatos. Essas informações extras são chamadas de **atributos personalizados** e podem ser qualquer coisa que você queira registrar. Veja alguns exemplos:

* Plano de assinatura
* Data de assinatura
* Data de cadastro
* Item mais pedido
* Link do produto pedido
* Data da última transação

Atributos personalizados permitem anexar informações adicionais a uma conversa ou contato, como histórico de compras ou status da conta. Você pode usar esses dados para entender e segmentar melhor sua base de clientes.

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

## Como criar um atributo personalizado

**Passo 1.** Vá para **Configurações → Atributos Personalizados** e clique no botão **Adicionar atributo personalizado**.

![tela Configurações → Atributos Personalizados com o botão Adicionar atributo personalizado em destaque](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBc0FRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1fa3c82da961f05af39b7ee60c6088ca0d65ffdb/ui-atributos.png)

**Passo 2.** Uma janela será aberta solicitando os detalhes do novo atributo. Preencha os campos.

Estas são as entradas necessárias para criar o atributo personalizado:

1. **Aplica-se a** — Tipo do atributo (**Conversa** ou **Contato**).
2. **Nome de exibição** — Rótulo usado ao exibir o atributo personalizado.
3. **Chave** — Identificador exclusivo associado ao atributo personalizado.
4. **Descrição** — Descrição do atributo personalizado.
5. **Tipo** — Texto, Número, Link, Data, Lista ou Caixa de seleção.

**Observação:** você não pode criar dois atributos personalizados com a mesma chave na mesma conta.

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

## Como usar um atributo personalizado de conversa

Você pode adicionar atributos personalizados de conversa diretamente na barra lateral da conversa. Siga os passos abaixo.

**Passo 1.** No seu painel, ao abrir uma conversa, localize a seção **Informações da Conversa** e clique no sinal **`+`** para expandi-la.

**Passo 2.** Todos os atributos personalizados de conversa serão listados. Ao lado de cada um há um ícone de lápis; clique nele para editar o valor como desejar — a alteração é salva na conversa automaticamente.

Para editar, excluir ou 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 pela barra lateral do contato

Siga o mesmo procedimento descrito acima para os atributos de conversa, mas use a seção de atributos na barra lateral do contato.

Conforme o tipo do atributo (lista, caixa de seleção, texto, etc.), preencha o valor como desejar.

### Definir atributos pelo método do SDK

No chat no site, você também pode definir atributos de contato via SDK. Para isso, chame o método **`setCustomAttributes`** da seguinte forma:

```
window.$chatwoot.setCustomAttributes({
  // A chave é o identificador único já definido ao criar o atributo personalizado.
  // O valor deve respeitar o tipo definido no painel: texto/link/lista, número, data ou checkbox.
  // Garanta que cada chave tenha um valor válido em JSON.
  // Estruturas JSON aninhadas precisam ser achatadas antes de usar esta função.
  planoAssinatura: "Premium",
  dataCadastro: "2025-01-15"
});
```

Você pode visualizar esses atributos no painel lateral de contato ou de conversa.

Para excluir um atributo personalizado, use **`deleteCustomAttribute`** da seguinte forma:

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

## Dica

Os campos personalizados criados aqui também ficam disponíveis para outros recursos — por exemplo, os formulários de pré-chat do chat no site. Veja [**Como usar formulários de pré-chat?**](1727264106-como-usar-formularios-de-pre_chat) para incluí-los na coleta de dados antes do atendimento.