## Visão geral

Os **atributos personalizados** são campos que você cria para guardar informações que a plataforma
não traz de fábrica — por exemplo, CPF/CNPJ, plano contratado, origem do lead, número de pedido ou
qualquer dado relevante para a sua operação.

Cada atributo é definido uma vez (com um nome, uma chave e um tipo) e passa a aparecer no painel
lateral das conversas e/ou no cadastro de contatos. Você pode usar atributos como critério de
**segmentos**, em **automações**, em **campanhas** e na importação por CSV.

## Pré-requisitos

- Uma conta ConversaLabs ativa.
- Permissão de administração para criar e editar definições de atributos.
- Defina o tipo de cada campo antes de criar (texto, número, data, lista, etc.).

## Passo a passo

1. Acesse as **Configurações** da conta e abra a seção de **atributos personalizados**.
2. Crie uma nova definição e escolha onde ela se aplica: **contato** ou **conversa**.
3. Informe um **nome de exibição** (o que a equipe vê) e o sistema gera uma **chave** estável.
4. Selecione o **tipo** do campo (veja a tabela abaixo).
5. Para listas, informe os valores possíveis; salve a definição.
6. Abra um contato ou conversa e preencha o novo atributo no painel lateral.

## Configurações & opções

A plataforma oferece estes tipos de atributo:

| Tipo | Para que serve |
| --- | --- |
| Texto | Texto livre (observações, códigos) |
| Número | Valores numéricos |
| Moeda | Valores monetários |
| Percentual | Porcentagens |
| Link | URLs clicáveis |
| Data | Datas |
| Lista | Escolha entre valores predefinidos |
| Caixa de seleção | Verdadeiro/falso |

- **Modelo do atributo**: contato (vale para a pessoa) ou conversa (vale para aquele atendimento).
- **Chave única**: cada chave é única por modelo e não pode conflitar com campos padrão.
- **Validação opcional**: alguns campos aceitam um padrão (regex) para garantir o formato.
- A ConversaLabs também usa atributos personalizados em outros módulos (CRM, catálogo, tarefas,
  agenda, entre outros), cada um na sua área de configuração.

## Casos de uso

- Guardar o **CPF/CNPJ** ou documento do cliente no contato.
- Marcar a **origem do lead** (anúncio, indicação, site) como uma lista.
- Registrar um **número de pedido** ou de protocolo na conversa.
- Criar segmentos como "clientes do plano Pro" usando um atributo de lista.

## Dicas, limites e boas práticas

- Escolha o **tipo certo** desde o início — mudar o tipo depois pode exigir reedição dos dados.
- Use **listas** em vez de texto livre para campos com poucas opções (evita variações como "WhatsApp"
  e "whats").
- Padronize a nomenclatura das chaves antes de importar grandes bases por CSV.
- Atributos de **contato** seguem a pessoa; atributos de **conversa** valem apenas para o atendimento.

## Solução de problemas

- **Não consigo criar o atributo**: a chave pode já existir ou conflitar com um campo padrão —
  use outro nome.
- **O valor não aparece na importação**: confira se o cabeçalho do CSV usa exatamente a chave do
  atributo.
- **O campo não aceita o valor**: pode haver uma validação de formato (regex) definida na definição.

## Veja também

- [Contatos: criar, importar (CSV) e segmentos](/hc/ajuda/articles/contacts-crm-contatos-import-segmentos-pt-br)
- [Empresas (companies) e vínculo com contatos](/hc/ajuda/articles/contacts-crm-empresas-pt-br)
- [CRM: pipelines, kanban e negócios (deals)](/hc/ajuda/articles/contacts-crm-crm-pipelines-kanban-negocios-pt-br)
- [Objetos personalizados (Custom Objects)](/hc/ajuda/articles/contacts-crm-custom-objects-pt-br)