Clientes: atributos customizados

Além dos campos padrão (nome, email, telefone), o ShopIA permite criar atributos customizados — dados específicos do seu negócio. Esta página descreve quando usar, como criar e onde aplicar.

Atributos vs tags

Use tag para "cliente é VIP" (sim/não).

Use atributo para "cliente tem CNPJ X", "tamanho de roupa M", "data de aniversário 1990-05-15".

Tipos de atributo

Criando atributo

1. Configurações > Clientes > Atributos customizados.
2. Novo atributo.
3. Defina:

- Nome (ex: cnpj, aniversario, tamanho_camiseta) - Tipo - Obrigatório (sim/não) - Valor padrão (opcional) - Visível em UI (sim/não — alguns atributos são internos)

1. Salve.

O atributo passa a aparecer em Clientes > [Cliente] > Atributos.

Aplicando

Manualmente no cliente

1. Clientes > [Cliente] > Atributos.
2. Edite o valor.
3. Salve.

Via formulário de checkout

Atributos podem ser capturados no checkout se a plataforma (Woo/Shopify) tiver o campo:

• WooCommerce custom field → mapeia para atributo ShopIA
• Shopify customer metafield → mapeia para atributo ShopIA

Configuração: Configurações > Plataforma > Mapeamento de campos.

Via captura de leads

Componentes de captura podem coletar atributos extras (ex: tamanho preferido). Detalhes em Tipos de popup.

Via importação CSV

Adicione colunas no CSV:

email,nome,cnpj,aniversario
[email protected],João,12.345.678/0001-90,1990-05-15

Detalhes em Importar clientes via CSV.

Usando atributos

Em segmentação

Clientes onde aniversario for este mês
Clientes onde cnpj não nulo (B2B)
Clientes onde tamanho_camiseta = "M"

Em personalização de mensagem

Tags de substituição em conteúdo:

Olá {{customer_first_name}}! Hoje é seu aniversário 🎂

Outros atributos seguem padrão {{customer_atributo}}:

Em {{customer_aniversario}} fizemos algo especial...

Em automações

Win-back para aniversariantes do mês:

• Filtro: aniversario = mês atual
• Disparo: 7 dias antes do aniversário

Crie em Otto > Automações > Aniversário.

<!-- TODO: confirmar com Gabriel se automação de aniversário é entrega ativa ou roadmap -->

Atributos do sistema (não customizáveis)

ShopIA já mantém:

• email, nome, telefone, sobrenome
• endereço, cidade, UF, CEP
• data de cadastro
• última compra, primeiro pedido
• valor total gasto
• ticket médio
• frequência de compra
• LTV calculado
• score de engajamento

Estes são automáticos, não atributos custom — você não cria nem edita manualmente.

Atributos calculados

Alguns atributos podem ser derivados de regras:

nivel = "ouro" se total_gasto > 10000
nivel = "prata" se total_gasto > 3000
nivel = "bronze" caso contrário

Configuração: Configurações > Clientes > Atributos calculados.

ShopIA recalcula em background (~1 hora) sempre que dados de cliente mudam.

Limites

Boas práticas

Use nome semanticamente claro

Ruim: campo1, extra2, info3.

Bom: cnpj, tamanho_camiseta, aniversario.

Documente o que cada atributo representa

Em Configurações > Clientes > Atributos > [Atributo] > Descrição, escreva:

• O que é
• Como é populado
• Exemplos válidos

Útil para nova equipe entender.

Privacidade

Atributos podem conter dados sensíveis (CPF, CNPJ, endereço extra). Trate como dados pessoais:

• LGPD aplica
• Acesso restrito conforme papel
• Cliente pode pedir exclusão (atributo é apagado junto)

Detalhes em LGPD: responsabilidades do lojista.

Não sobrecarregue

50 atributos é teto. Mas além de 10-15 ativos, você perde de vista qual usa qual. Faça revisão trimestral.

Excluindo atributo

1. Configurações > Clientes > Atributos > [Atributo] > Excluir.
2. Confirme.

Atenção: exclusão remove o atributo de todos os clientes. Não é reversível. Use com cautela. Se quiser deixar de usar mas preservar dados, arquive em vez de excluir.

Importação e atributo

Ao importar CSV com colunas que viram atributos:

• Se atributo não existe ainda, ShopIA pergunta se quer criar
• Se existe, popula valor
• Tipos são validados (data inválida vira erro)

Detalhes em Importar clientes via CSV.

Export e atributo

Export de clientes inclui todos os atributos custom como colunas. Útil para análise externa (Excel, BI).

Sandbox

Atributos custom funcionam em sandbox normal — só envios bloqueados, dados normais.

Casos práticos

Caso 1: B2B com CNPJ

• Atributo cnpj (texto, obrigatório para B2B)
• Tag b2b aplicada em clientes com CNPJ preenchido
• Newsletter B2B segmentada por tag

Caso 2: aniversário automatizado

• Atributo aniversario capturado no checkout
• Automação de aniversário 7 dias antes
• Cupom personalizado

Caso 3: tamanho preferido (moda)

• Atributo tamanho_camiseta (lista)
• Newsletter de novo produto filtra por tamanho disponível
• Recomendação personalizada

Veja também

• Tags personalizadas para clientes
• Segmentação de clientes
• Importar clientes via CSV