Atributos personalizados (Custom Attributes)

Os campos padrão de um contato (nome, e-mail, telefone, identificador, empresa) cobrem o básico. Mas toda operação tem informações próprias que precisam ser armazenadas de maneira estruturada: uma imobiliária quer saber a "faixa de imóvel desejada"; uma escola, a "série do filho"; um SaaS B2B, o "plano contratado" e o "MRR".

Para isso existem os atributos personalizados — campos definidos pela sua conta que aparecem no perfil de todos os contatos (ou de todas as conversas, conforme o caso).

Modelos: contato vs. conversa

Cada atributo personalizado pertence a um modelo específico:

• Atributo de contato — viaja junto com o cadastro do cliente (CNPJ, plano, origem). Persiste entre conversas.
• Atributo de conversa — pertence a uma conversa específica (motivo do contato, canal de origem da campanha). Não é replicado em conversas futuras.

Defina o modelo correto na criação. Ambos aparecem no painel lateral, mas são armazenados separadamente.

Criando um atributo personalizado

1. Acesse Configurações → Atributos personalizados.
2. Clique em Adicionar atributo.
3. Preencha:

4. Clique em Criar.

A partir desse momento o campo aparece automaticamente no perfil de todos os contatos (ou conversas) da conta.

A chave técnica não pode coincidir com nomes de campos padrão como name, email, phone_number, identifier, country_code, city, created_at, last_activity_at, referer ou blocked. O sistema bloqueia o cadastro nesse caso.

Tipos de atributo disponíveis

Os tipos suportados pelo sistema são:

Dica: para "plano contratado", "origem do lead", "estágio do funil" e similares, prefira lista suspensa. Isso evita variações ("face", "facebook ads", "FB Ads") que quebram relatórios e segmentações.

Preenchendo atributos no perfil

Depois de criados, os atributos aparecem no painel lateral direito ao abrir um contato ou uma conversa. Basta clicar para editar — o salvamento é imediato. Em telas de criação manual, os atributos também ficam disponíveis logo após o cadastro inicial.

Atributos podem ser preenchidos por:

• Atendentes diretamente no painel.
• Automações que rodam ao mover cards no Kanban ou ao receber mensagens.
• Importação CSV em massa.
• API pública (para integrações com sistemas externos).
• Capitão IA, quando configurado para extrair dados das conversas.

Usando atributos em filtros, segmentos e automações

A grande vantagem de transformar dados livres em atributos estruturados é poder operar sobre eles:

• Filtros de contatos — "mostrar todos com plano = Pro e mrr > 500".
• Segmentos dinâmicos — listas reaproveitáveis baseadas em filtros.
• Automações — "quando plano mudar para Cancelado, mover card para a coluna Churn".
• Capitão IA — atributos entram no contexto que a IA usa.
• Relatórios — quebra de métricas por atributo.
• Templates — uso como variável no corpo de mensagens.

Editando ou removendo

• Renomear o nome de exibição é seguro.
• Alterar a chave técnica quebra automações, filtros e templates que apontam para ela.
• Remover apaga o valor preenchido em todos os contatos. A operação é irreversível.

Antes de remover, exporte os contatos afetados (veja Importação CSV) ou ao menos documente os valores para futura referência.

Boas práticas

• Nomeie de forma clara: "Faixa de imóvel" é melhor que "Faixa1".
• Use lista suspensa sempre que houver opções fechadas — garante consistência.
• Reserve texto livre para casos genuinamente abertos: observações, códigos de sistemas externos.
• Documente — anote internamente o significado de cada atributo, especialmente quando vários times preenchem.

Próximos passos

• Importação CSV — preencher atributos em massa.
• Segmentos dinâmicos — combinar atributos em consultas reaproveitáveis.
• Mesclar contatos — entender como atributos se comportam ao fundir duplicatas.