Como criar e usar atributos personalizados

Use este guia para criar e usar atributos personalizados em contatos ou conversas.

Para que servem

Atributos personalizados guardam dados que não existem nos campos padrão da IAra, como plano contratado, unidade de interesse, número do pedido, data de última compra ou etapa de onboarding.

Na tela: A criação de atributos personalizados fica em Configurações > Atributos personalizados.

Tipos de uso

• Contato: dados estáveis do cliente, como plano, unidade, documento ou origem.
• Conversa: dados específicos daquele atendimento, como motivo, prioridade, protocolo ou pendência.

Preencher pelo painel

1. Abra uma conversa ou contato.
2. Localize a área de atributos personalizados.
3. Clique para adicionar atributo.
4. Escolha o atributo existente ou crie um novo, se tiver permissão.
5. Preencha o valor conforme o tipo do campo.
6. Salve e confira se a informação aparece na barra lateral.

Preencher pelo SDK

Use setCustomAttributes quando seu site ou app já conhece dados do usuário.

window.$chatwoot.setCustomAttributes({
  plan: 'premium',
  accountId: 123,
  lastPurchaseDate: '2026-06-01',
});

As chaves devem existir ou seguir a configuração definida para atributos personalizados. Os valores precisam ser JSON válido.

Para remover um atributo:

window.$chatwoot.deleteCustomAttribute('plan');

Boas práticas

• Use nomes de atributos padronizados.
• Evite criar campos duplicados com nomes parecidos.
• Não coloque dados sensíveis sem necessidade operacional.
• Prefira valores objetivos, como premium, inadimplente, implantacao, vip.
• Revise periodicamente atributos que deixaram de ser usados.