Principal Recursos explicados Como criar e usar atributos personalizados?

Como criar e usar atributos personalizados?

Última atualização em Feb 05, 2025

Gerenciando Atributos Personalizados no FalAIChat

O FalAIChat permite rastrear informações adicionais sobre conversas e contatos, além dos dados padrão como nome, e-mail e localização.

📌 Essas informações adicionais são chamadas de "Atributos Personalizados" e podem incluir:

Plano de assinatura
Data de inscrição
Última compra
Item mais pedido
Status da conta

📌 Os atributos personalizados ajudam a segmentar e entender melhor seus clientes.

Diferença entre Atributos Personalizados e Padrão

  • Os atributos padrão são atualizados automaticamente.

  • Os atributos personalizados são criados e preenchidos manualmente.


Como Criar um Atributo Personalizado no FalAIChat?

Passo 1:
Acesse Configurações → Atributos Personalizados e clique no botão "Adicionar Atributo Personalizado".

Passo 2:
Preencha os detalhes do atributo no modal que será aberto.

📌 Campos obrigatórios:

🔹 Aplica-se a: Defina se o atributo será para Conversas ou Contatos.
🔹 Nome de Exibição: Nome visível no painel.
🔹 Chave: Identificador único do atributo.
🔹 Descrição: Explicação sobre o atributo.
🔹 Tipo: Escolha entre Texto, Número, Link, Data, Lista ou Caixa de Seleção.

📌 Importante: Não é possível criar um atributo com a mesma chave duas vezes.

Passo 3:
Clique em "Criar" para salvar.

📌 Se o atributo for criado com sucesso, aparecerá a mensagem "Atributo personalizado adicionado com sucesso".


Como Usar um Atributo Personalizado em uma Conversa?

📌 Os atributos personalizados de conversa podem ser adicionados na barra lateral da conversa.

Passo 1:
Abra uma conversa no painel e vá até a seção "Informações da Conversa".

Passo 2:
Clique no botão "+" (Adicionar Atributos) para visualizar a lista de atributos disponíveis.

📌 Você pode:

  • Usar a barra de pesquisa para encontrar o atributo desejado.

  • Criar um novo atributo clicando em "Criar Novo Atributo".

Passo 3:
Com base no tipo do atributo (lista, caixa de seleção, texto, etc.), preencha as informações necessárias.

📌 Para Editar, Excluir ou Copiar um atributo, basta passar o mouse sobre ele e selecionar a ação desejada.


Como Usar um Atributo Personalizado em um Contato?

📌 Os atributos personalizados também podem ser aplicados a contatos de duas formas:

1️⃣ Via SDK (Código)
2️⃣ Pelo Painel do FalAIChat


1️⃣ Definir Atributos Personalizados via SDK

🔹 Para definir atributos personalizados programaticamente, use o método setCustomAttributes.

📌 Exemplo de Código:

javascriptCopyEditwindow.$falaichat.setCustomAttributes({
  subscriptionPlan: "Premium",
  signUpDate: "2023-05-10",
  lastPurchase: "2024-02-01"
});

📌 Observações:
✅ A chave do atributo precisa ser única e já cadastrada.
✅ O valor deve estar no formato correto (Texto, Número, Data, etc.).
✅ JSON aninhado precisa ser achatado antes do uso.


Como Excluir um Atributo Personalizado via SDK?

📌 Use o método deleteCustomAttribute para remover um atributo.

javascriptCopyEditwindow.$falaichat.deleteCustomAttribute("signUpDate");

📌 Isso removerá o atributo "signUpDate" do contato.


2️⃣ Definir Atributos Personalizados pelo Painel do FalAIChat

📌 Siga os mesmos passos para adicionar atributos personalizados a uma conversa.

Passo 1:
Abra o Painel de Contato e vá até a seção "Atributos do Contato".

Passo 2:
Clique no botão "+" (Adicionar Atributos) e selecione um atributo da lista.

Passo 3:
Preencha os detalhes do atributo (texto, número, caixa de seleção, etc.).

📌 Agora, os atributos do contato ficarão visíveis no painel do FalAIChat!


🚀 Agora você pode criar, gerenciar e utilizar atributos personalizados no FalAIChat para segmentar melhor seus clientes! 🎉