Como criar e usar atributos personalizados

O sistema permite que você registre informações extras sobre conversas e contatos, além dos campos padrão como nome, e-mail e localização. Essas informações adicionais são chamadas de atributos personalizados (custom attributes).

Exemplos de atributos personalizados

• Plano de assinatura

• Data de inscrição

• Item mais comprado

• Link do produto comprado

• Última transação

Esses dados ajudam a entender melhor seus clientes e a segmentar seu atendimento com mais eficiência.

🔎 Diferença: os atributos padrão são atualizados automaticamente, enquanto os atributos personalizados são definidos manualmente.

Como criar um atributo personalizado

Passo 1: Acesse as configurações de atributos

Vá para:
Configurações → Atributos personalizados → Adicionar atributo personalizado

Passo 2: Preencha os dados do novo atributo

Você verá um modal com os seguintes campos:

• Aplica-se a:
  Se o atributo será aplicado a Conversas ou Contatos.

• Nome para exibição:
  O nome do campo que será exibido no painel.

• Chave (key):
  Identificador único do atributo. Ex: plano_assinatura

  ⚠️ Não é possível repetir chaves na mesma conta.

• Descrição:
  Um breve texto explicativo sobre o que representa o atributo.

• Tipo:
  Escolha entre: Texto, Número, Link, Data, Lista ou Caixa de seleção (checkbox).

Clique em Criar.
Se o cadastro for bem-sucedido, a mensagem "Atributo personalizado adicionado com sucesso" será exibida.

Como usar um atributo personalizado em conversas

1. No painel, abra uma conversa qualquer.

2. No painel lateral, vá até Informações da conversa e clique no botão +.

3. Clique em “Adicionar atributos”.

   • Use a busca ou selecione um dos atributos existentes.

   • Caso necessário, clique em “Criar novo atributo” direto pelo menu.

1. Preencha o campo de acordo com o tipo definido (texto, data, lista, etc.).

1. Você pode editar, copiar ou excluir o valor passando o mouse sobre o campo.

Como usar um atributo personalizado em contatos

Você pode adicionar atributos a contatos de duas formas:

Opção 1: Usando o método via SDK

Para definir atributos personalizados em tempo real com JavaScript:

window.$chatwoot.setCustomAttributes({
  plano_assinatura: "Premium",
  data_inscricao: "2024-04-01"
});

✅ Os valores devem estar em formato válido JSON.
🔁 Tipos suportados: texto, número, data.
🔍 Chaves precisam corresponder à chave criada nas configurações.

Para excluir um atributo via SDK:

window.$chatwoot.deleteCustomAttribute("data_inscricao");

Opção 2: Via painel lateral de contato

1. Acesse Contatos e clique em um contato da lista.

2. No painel lateral, vá até Atributos do contato.

3. Clique no botão + para adicionar ou editar um atributo.

4. Preencha os campos conforme o tipo definido.

   

Você pode adicionar quantos atributos personalizados quiser, e usá-los como base para segmentação, relatórios, automação, ou apenas para manter o histórico completo do cliente.