Principal Funcionalidades explicadas Como criar e usar atributos personalizados?

Como criar e usar atributos personalizados?

Última atualização em May 21, 2026

A Wootdesk permite rastrear informações adicionais sobre seus contatos e conversas além dos dados padrão, como nome, e-mail e localização. Essas informações extras são chamadas de atributos personalizados (custom attributes).

Alguns exemplos de atributos personalizados:

  • Plano de assinatura

  • Data de cadastro

  • Produto mais comprado

  • Última transação

  • Link do pedido

  • Status da conta

Esses atributos ajudam sua equipe a segmentar clientes, automatizar fluxos e ter mais contexto durante o atendimento.


Como criar um atributo personalizado?

Passo 1.

No painel da Wootdesk, vá em:

Configurações → Atributos Personalizados

Depois clique em “Adicionar atributo personalizado”.


Passo 2.

Preencha as informações do atributo.

Exemplo:

  • Aplica-se a: Contato ou Conversa

  • Nome de exibição: Plano

  • Chave (Key): plan

  • Descrição: Plano atual do cliente

  • Tipo: Texto, Número, Data, Lista, Checkbox ou Link

Observação: não é possível criar dois atributos com a mesma chave.


Passo 3.

Clique em “Criar”.

Pronto. O novo atributo personalizado ficará disponível em toda a plataforma.


Como usar atributos personalizados em conversas?

Passo 1.

Abra uma conversa no painel da Wootdesk.

Na barra lateral direita, encontre a seção:

Informações da Conversa


Passo 2.

Clique em “Adicionar atributos”.

Escolha o atributo desejado na lista.


Passo 3.

Preencha o valor do atributo conforme o tipo configurado.

Exemplos:

  • Plano: Premium

  • Pedido: #4921

  • Renovação: 2026-06-10

Você também pode editar, copiar ou remover atributos depois.


Como usar atributos personalizados em contatos?

Existem duas formas.


1. Definindo atributos via SDK

Se você utiliza o widget da Wootdesk no seu site, pode enviar atributos automaticamente pelo SDK.

Exemplo:

window.$wootdesk.setCustomAttributes({
  plan: "premium",
  signupDate: "2026-05-21",
  totalOrders: 15
});

Esses dados aparecerão automaticamente no painel do contato e da conversa.


Remover um atributo personalizado

window.$wootdesk.deleteCustomAttribute("signupDate");

2. Definindo atributos manualmente no painel

Você também pode adicionar atributos diretamente pela lateral do contato.

Passos:

  1. Abra um contato

  2. Vá até Atributos do Contato

  3. Clique em Adicionar atributo

  4. Escolha o atributo criado

  5. Preencha o valor


Tipos de atributos suportados

A Wootdesk suporta:

  • Texto

  • Número

  • Data

  • Lista

  • Checkbox

  • Link


Exemplos práticos

SaaS

  • Plano atual

  • Trial ativo

  • Data de renovação

E-commerce

  • Último pedido

  • Valor gasto

  • Produto favorito

Suporte técnico

  • Prioridade

  • SLA

  • Ambiente do cliente


Exemplo avançado com SDK

window.$wootdesk.setCustomAttributes({
  company: "Acme Inc",
  plan: "enterprise",
  monthlyRevenue: 12000,
  onboardingCompleted: true
});

Dica importante

Use atributos personalizados junto com:

  • automações

  • etiquetas (labels)

  • bots

  • filtros

  • segmentos de contatos

Isso permite criar fluxos extremamente poderosos dentro da Wootdesk.