Principal Explicando funcões Como criar e usar atributos personalizados?

Como criar e usar atributos personalizados?

Última atualização em Aug 19, 2025

O Trino AI permite que você rastreie informações adicionais sobre suas conversas e contatos, além dos atributos de dados padrão, como nome, e-mail e localização. Essas informações adicionais são chamadas de atributos personalizados e podem ser qualquer coisa que você queira rastrear. Abaixo, alguns exemplos de atributos personalizados.

  • Plano de assinatura

  • Data de inscrição

  • Data de inscrição

  • Item mais pedido

  • Link do produto pedido

  • Data da última transação

Atributos de dados personalizados permitem que você adicione 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. Acesse Configurações → Atributos. Clique no botão "Criar Atributo Personalizado" .

Passo 2. Um modal será aberto, solicitando detalhes sobre o novo atributo personalizado. Preencha os dados. Veja 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

    Atuar como um rótulo ao renderizar um 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.

Passo 3. Após inserir 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 a uma conversa na barra lateral. Siga os passos descritos abaixo.

Passo 1. No seu painel, ao abrir uma conversa específica, você encontrará uma seção chamada "Informações da Conversa". Clique no **+**ícone para expandi-la.

Passo 2. Você verá os Atributos disponíveis, seguida por um menu suspenso com todos os Atributos Personalizados da sua conta. Clique em um para selecioná-lo.

Como usar um atributo personalizado de contato?

Há duas maneiras de definir atributos personalizados para contatos.

Definir atributos via método SDK

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

window.$trinoai.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.$trinoai.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.$trinoai.deleteCustomAttribute("attribute-key");

Exemplo :

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

Observação : 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 os atributos personalizados da conversa, mas use a sessão atributos do contato da barra lateral do seu chat.

Marque a "caixinha" desejado, e o atributo já estará aplicado ao contato