Como criar e usar atributos personalizados?
O Yuzap permite rastrear 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 estão listados alguns exemplos de atributos personalizados.
Plano de assinatura
Data de inscrição
Data de cadastro
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 melhor e segmentar 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. Uma janela modal será aberta, solicitando detalhes sobre o novo atributo personalizado. Preencha esses detalhes. Aqui está um exemplo:
Estas são as entradas necessárias para criar o atributo personalizado:
Aplica-se a Tipo de atributo (Conversa/Contato).
Nome de exibição Atua como um rótulo ao renderizar o atributo personalizado.
Chave Identificador único anexado ao atributo personalizado.
Descrição Descrição do atributo personalizado.
Tipo Texto, Número, Link, Data, Lista e Caixa de seleção.
Nota: Você não pode criar um atributo personalizado com a mesma chave duas vezes na conta.
Passo 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 a partir da barra lateral da conversa. 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 sinal + para expandi-la.
Passo 2. Você verá uma opção chamada “Adicionar Atributos” seguida por uma lista suspensa de todos os Atributos Personalizados em sua conta. Use a barra de pesquisa para filtrar pelo nome do atributo que você está procurando. Ou clique em um para selecioná-lo. Se precisar criar um novo, use o botão “Criar novo atributo” na mesma lista suspensa.
Passo 3. Com base no tipo de atributo que você adicionou (lista, caixa de seleção, texto, etc.), preencha-o conforme desejado. 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 via método SDK
Para definir um atributo personalizado de contato, chame o método setCustomAttributes da seguinte forma.
window.$yuzap.setCustomAttributes({
key: value,
// Key é um identificador único que já foi definido ao criar um atributo personalizado
// Value deve ser baseado no tipo (Atualmente suporta Número, Data, String e Número)
// Verifique novamente se suas chaves sempre têm um valor JSON válido
// Você precisa achatar a estrutura JSON aninhada ao usar esta função
});Exemplo:
window.$yuzap.setCustomAttributes({
key: value,
// Key é um identificador único que já foi definido ao criar um atributo personalizado
// Value deve ser baseado no tipo (Atualmente suporta Número, Data, String e Número)
// Verifique novamente se suas chaves sempre têm um valor JSON válido
// Você precisa achatar a estrutura JSON aninhada ao usar esta função
});Você pode visualizar esses atributos no painel lateral de contato/conversa.
Para excluir um atributo personalizado, use deleteCustomAttribute da seguinte forma.
window.$yuzap.deleteCustomAttribute("chave-do-atributo");Exemplo:
window.$yuzap.deleteCustomAttribute("dataCadastro");Nota: Antes da versão v1.22, todos os atributos eram renderizados como texto. Por favor, crie uma nova definição para exibir o valor corretamente.
Definir atributos via painel lateral de contato
Para adicionar Atributos de Contato, siga o mesmo procedimento descrito acima para atributos personalizados de conversa, mas use a seção Atributos de Contato da barra lateral do chat. Ficaria assim:
Com base no tipo de atributo que você adicionou (lista, caixa de seleção, texto, etc.), preencha-o conforme desejado. Aqui está um exemplo:
Atualizado