Além dos atributos de dados padrão — como nome, e-mail e localização — você pode acompanhar informações adicionais sobre suas conversas e contatos. Essas informações extras são chamadas de atributos personalizados e podem ser qualquer coisa que você queira registrar. Veja alguns exemplos:
- Plano de assinatura
- Data de assinatura
- Data de cadastro
- Item mais pedido
- Link do produto pedido
- Data da última transação
Atributos personalizados permitem anexar informações adicionais a uma conversa ou contato, como histórico de compras ou status da conta. Você pode usar esses dados para entender e segmentar melhor sua base de clientes.
A única diferença entre atributos personalizados e padrão é que os atributos padrão são atualizados automaticamente pelo sistema.
Como criar um atributo personalizado
Passo 1. Vá para Configurações → Atributos Personalizados e clique no botão Adicionar atributo personalizado.
Passo 2. Uma janela será aberta solicitando os detalhes do novo atributo. Preencha os campos.
Estas são as entradas necessárias para criar o atributo personalizado:
- Aplica-se a — Tipo do atributo (Conversa ou Contato).
- Nome de exibição — Rótulo usado ao exibir o atributo personalizado.
- Chave — Identificador exclusivo associado ao atributo personalizado.
- Descrição — Descrição do atributo personalizado.
- Tipo — Texto, Número, Link, Data, Lista ou Caixa de seleção.
Observação: você não pode criar dois atributos personalizados com a mesma chave na mesma conta.
Passo 3. Depois de preencher os detalhes, clique no botão Criar. Se a solicitação for bem-sucedida, a mensagem "Atributo personalizado adicionado com sucesso" será exibida.
Como usar um atributo personalizado de conversa
Você pode adicionar atributos personalizados de conversa diretamente na barra lateral da conversa. Siga os passos abaixo.
Passo 1. No seu painel, ao abrir uma conversa, localize a seção Informações da Conversa e clique no sinal + para expandi-la.
Passo 2. Todos os atributos personalizados de conversa serão listados. Ao lado de cada um há um ícone de lápis; clique nele para editar o valor como desejar — a alteração é salva na conversa automaticamente.
Para editar, excluir ou copiar um atributo, passe o mouse sobre ele para ver as opções.
Como usar um atributo personalizado de contato
Existem duas maneiras de definir atributos personalizados para contatos.
Definir atributos pela barra lateral do contato
Siga o mesmo procedimento descrito acima para os atributos de conversa, mas use a seção de atributos na barra lateral do contato.
Conforme o tipo do atributo (lista, caixa de seleção, texto, etc.), preencha o valor como desejar.
Definir atributos pelo método do SDK
No chat no site, você também pode definir atributos de contato via SDK. Para isso, chame o método setCustomAttributes da seguinte forma:
window.$chatwoot.setCustomAttributes({
// A chave é o identificador único já definido ao criar o atributo personalizado.
// O valor deve respeitar o tipo definido no painel: texto/link/lista, número, data ou checkbox.
// Garanta que cada chave tenha um valor válido em JSON.
// Estruturas JSON aninhadas precisam ser achatadas antes de usar esta função.
planoAssinatura: "Premium",
dataCadastro: "2025-01-15"
});
Você pode visualizar esses atributos no painel lateral de contato ou de conversa.
Para excluir um atributo personalizado, use deleteCustomAttribute da seguinte forma:
window.$chatwoot.deleteCustomAttribute("dataCadastro");
Dica
Os campos personalizados criados aqui também ficam disponíveis para outros recursos — por exemplo, os formulários de pré-chat do chat no site. Veja Como usar formulários de pré-chat? para incluí-los na coleta de dados antes do atendimento.