Skip to main content

📝 Atributos Personalizados (Custom Attributes)

Crie campos personalizados para armazenar informações específicas do seu negócio em conversas e contatos.

📋 O que são Atributos Personalizados?

Atributos são campos de dados extras que você define: Diferença de Labels:
  • 🏷️ Labels: Tags simples (ex: #vip, #urgente)
  • 📝 Atributos: Campos com valores (ex: Plano: “Premium”, Valor: “R$ 500”)

✨ Tipos de Atributos

Texto

Texto livre

Número

Valores numéricos

Data

Datas

Link

URLs

Lista

Opções predefinidas

Checkbox

Sim/Não

🆕 Criar Atributo

  1. “Configurações”“Atributos Personalizados”
  2. Escolha escopo:
    • Contato: Atributo do cliente
    • Conversa: Atributo da conversa
  3. “Novo Atributo”
  4. Configure:
Nome da exibição: Plano do Cliente
Chave (key): plano (para API)
Tipo: Lista
Valores: Free, Basic, Premium, Enterprise
Descrição: “Plano atual do cliente”
  1. Salvar

📊 Atributos de Contato

Armazenam informações do cliente.

Exemplos Comuns

Segmentação:
Dados de Negócio:
Preferências:

Como Preencher

Manualmente:
  1. Abra contato
  2. Seção “Atributos”
  3. Preencha valores
  4. Salvar
Via API:
Via Integração: Automático quando sincronizado com CRM, e-commerce, etc.

💬 Atributos de Conversa

Armazenam informações específicas daquela conversa.

Exemplos Comuns

E-commerce:
Suporte:
Vendas:

🔍 Filtrar e Buscar

Filtrar Contatos

Filtrar Conversas


🤖 Automações com Atributos

Regras Baseadas em Atributos

Exemplo 1: Priorizar VIPs
Exemplo 2: SLA por Valor
Exemplo 3: Roteamento por Região

Preencher Automaticamente


📧 Personalização com Atributos

Em Mensagens

Use atributos em templates:

Em Campanhas

Segmente por atributos:

📊 Relatórios com Atributos

Agrupar por Atributo

Performance por Segmento


🔗 Integração com APIs

Enviar Atributos

Criar contato com atributos:
Atualizar atributos:

Buscar por Atributos


🎯 Casos de Uso

E-commerce

SaaS

Imobiliária


💡 Melhores Práticas

Nomenclatura

Snake_case para key: data_cadastro não Data Cadastro
Display name amigável: “Data de Cadastro”
Consistência: Padronize em toda equipe

Organização

Não exagere: 10-15 atributos por escopo
Use listas: Melhor que texto livre
Valide inputs: Evite erros de digitação
Documente: O que cada atributo significa

Performance

Indexe: Atributos usados em filtros
Cache: Dados acessados frequentemente
Limpe: Remova atributos não usados

🚀 Próximos Passos

Automações

Use atributos em regras automáticas

API Reference

Integre atributos via API