Como criar e usar atributos personalizados?
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
