Principal Recursos explicados Como criar e usar atributos personalizados?

Como criar e usar atributos personalizados?

Última atualização em Jun 10, 2024

Chatwoot permite rastrear informações adicionais sobre suas conversas e contatos além dos atributos de dados padrão, como nome, email e localização. Essas informações adicionais são chamadas de atributos personalizados e podem ser qualquer coisa que você queira rastrear. Listados abaixo estão alguns exemplos de atributos personalizados.

  • Plano de assinatura

  • Data de assinatura

  • Data de inscrição

  • Item mais pedido

  • Link do produto pedido

  • Data da última transação

Atributos de dados personalizados permitem anexar informações adicionais a uma conversa ou cliente, como histórico de compras ou status da conta. Essas informações podem ser usadas para entender e segmentar melhor sua base de clientes.

A única diferença entre atributos personalizados e padrão é que os atributos de dados padrão são atualizados automaticamente.

Como criar um atributo personalizado?

Passo 1. Vá para Configurações → Atributos personalizados. Clique no botão “Adicionar atributo personalizado” .

Passo 2. Um modal será aberto, solicitando detalhes sobre o novo atributo customizado. Preencha esses detalhes. Aqui está um exemplo:

Estas são as entradas necessárias para criar o atributo personalizado:

  1. Aplica-se a

    Tipo de atributo (Conversa/Contato).

  2. Nome de exibição

    Atue como um rótulo ao renderizar o atributo personalizado.

  3. Chave

    Identificador exclusivo anexado ao atributo personalizado.

  4. Descrição

    Descrição do atributo personalizado.

  5. Tipo

    Texto, número, link, data, lista e caixa de seleção.

Observação : você não pode criar um atributo personalizado com a mesma chave duas vezes na conta.

Etapa 3. Depois de inserir os detalhes, clique no botão “ Criar”  . Se a solicitação for bem-sucedida, uma mensagem "Atributo personalizado adicionado com sucesso" será exibida.

Como usar um atributo personalizado de conversa?

Você pode adicionar atributos personalizados de conversa a uma conversa na barra lateral da conversa. Siga as etapas descritas abaixo.

Passo 1. No seu painel, ao abrir uma determinada conversa, você encontrará uma seção que diz “Informações da Conversa”. Clique no **+**sinal para expandi-lo.

Passo 2. Você verá uma opção que diz “Adicionar atributos” seguida por um menu suspenso de todos os atributos personalizados em sua conta. Use a barra de pesquisa para restringir o nome do atributo que você está procurando. Ou clique em um para selecioná-lo. Se você precisar criar um novo, use o botão “Criar novo atributo” no mesmo menu suspenso.

Passo 3. Com base no tipo de atributo que você adicionou (lista, caixa de seleção, texto, etc.), preencha-o como desejar. Aqui estão alguns exemplos:

Para editar/excluir/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 por meio do método SDK

Para definir um atributo personalizado de contato, chame  setCustomAttributes o método da seguinte maneira.

window.$chatwoot.setCustomAttributes({
  key: value,
  // Key is a unique identifier which is already defined while creating a custom attribute
  // Value should be based on type (Currently support Number, Date, String and Number)
  // Double-check that your keys always have a JSON-valid value
  // You need to flatten nested JSON structure while using this function
});

Exemplo :

window.$chatwoot.setCustomAttributes({
  key: value,
  // Key is a unique identifier which is already defined while creating a custom attribute
  // Value should be based on type (Currently support Number, Date, String and Number)
  // Double-check that your keys always have a JSON-valid value
  // You need to flatten nested JSON structure while using this function
});

Você pode visualizar esses atributos no painel lateral de contato/conversa.

Para excluir um atributo personalizado, use deleteCustomAttribute da seguinte maneira.

window.$chatwoot.deleteCustomAttribute("attribute-key");

Exemplo :

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

Nota : Antes da versão v1.22, todos os atributos eram renderizados como texto. Crie uma nova definição para exibir o valor corretamente.

Definir atributos por meio do painel lateral de contato

Para adicionar atributos de contato, siga o mesmo procedimento descrito acima para atributos personalizados de conversa, mas use a **Contact Attributes**seção da barra lateral do bate-papo. Seria assim:

Com base no tipo de atributo que você adicionou (lista, caixa de seleção, texto, etc.), preencha-o como desejar. Aqui está um exemplo:

  1. Como criar um atributo personalizado?

  2. Como usar um atributo personalizado de conversa?

  3. Como usar um atributo personalizado de contato?

  4. Definir atributos via método SDK

  5. Definir atributos por meio do painel lateral de contato