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
- Acesse as Configurações da conta e abra a seção de atributos personalizados.
- Crie uma nova definição e escolha onde ela se aplica: contato ou conversa.
- Informe um nome de exibição (o que a equipe vê) e o sistema gera uma chave estável.
- Selecione o tipo do campo (veja a tabela abaixo).
- Para listas, informe os valores possíveis; salve a definição.
- 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.