Atributos personalizados para contatos

Q: Posso editar ou renomear um atributo personalizado depois de cria-lo?

Sim. Acesse Configuracoes > Atributos Personalizados, localize o atributo e atualize o nome de exibição, a descrição, o tipo ou as opções da lista. A chave e o campo Aplica-se a não podem ser alterados. Os dados existentes armazenados nesse atributo serao preservados.

Q: Posso criar custom attributes em conversas também?

Sim. Escolhe Conversa em Aplica-se a ao criar. Útil pra tags ticket-específicas tipo 'razão de escalação' ou 'área de produto' que não se aplicam ao cliente geral.

Atualizado em 20 de out. de 20266 min de leitura

Português

Nesta página

Custom attributes deixam você guardar dados estruturados extras em contatos ou conversas, além dos campos default. Exemplos: plan tier do contato, lifetime value, NPS score; em conversas, área de produto ou razão de escalação. Escolhe tipo (text, number, list, date, checkbox, link), dá um nome, o campo aparece em cada painel de contato ou conversa. Regras de automação podem checar os valores, e seus próprios sistemas podem preenchê-los via API.

Os atributos personalizados permitem armazenar dados adicionais sobre os contatos, alem dos campos padrao. Seja para acompanhar o plano de assinatura de um cliente, o idioma preferido ou o ID da conta, os atributos personalizados dao a sua equipe a flexibilidade de capturar as informacoes que mais importam para o seu fluxo de trabalho. Os atributos personalizados estão disponíveis nos planos Business e Enterprise, e quem os cria são os administradores.

Por que usar atributos personalizados?

Cada empresa coleta diferentes pontos de dados sobre seus clientes. Os campos padrao de contato (nome, e-mail, telefone) cobrem o basico, mas raramente contam a historia toda. Os atributos personalizados permitem:

Personalizar conversas exibindo detalhes relevantes (por exemplo, tipo de plano ou porte da empresa) diretamente na barra lateral do contato.
Automatizar com regras de automação que checam os valores dos atributos como condição.
Manter uma unica fonte de verdade, para que os agentes nao precisem alternar entre ferramentas para encontrar informacoes importantes.

Criando atributos personalizados

Siga estes passos para adicionar um novo atributo personalizado:

Acesse Configuracoes > Atributos Personalizados.
Clique em Novo atributo.
Em Aplica-se a, escolha se o atributo é para Contato ou Conversa.
Digite um Nome de exibição descritivo (por exemplo, Plano de assinatura). A chave (por exemplo, subscription_plan) é gerada a partir dele e não pode ser alterada depois.
Selecione o Tipo (Texto, Número, Link, Data, Lista ou Caixa de seleção). Para uma lista, digite cada opção em Opções e pressione Enter.
Clique em Criar atributo. O novo atributo aparece imediatamente no painel direito de cada conversa e, para contatos, na aba Atributos do contato.

Melhores praticas

Use nomes claros e consistentes. Mantenha uma convencao de nomenclatura (como letras minusculas com underscores) para que os atributos sejam faceis de identificar de relance.
Escolha o tipo de dado certo. Selecionar "lista" para um campo com um conjunto fixo de opcoes (por exemplo, niveis de plano) evita erros de digitacao e mantem os dados limpos.
Evite duplicar campos padrao. Antes de criar um atributo, verifique se a informacao ja nao esta capturada por um campo nativo.
Revise periodicamente. Exclua atributos que nao estejam mais em uso para manter a interface organizada para seus agentes.

Problemas comuns e solucao de problemas

O atributo nao aparece? Confirme se voce selecionou o modelo correto (Contato vs. Conversa) ao cria-lo.
Entradas de dados inconsistentes? Considere trocar um tipo de texto livre por um tipo de lista para padronizar os valores em toda a sua equipe.
Criou uma duplicata por acidente? Exclua o atributo extra em Configuracoes > Atributos Personalizados antes que os agentes comecem a preenche-lo, para evitar fragmentacao de dados.

Perguntas frequentes

Posso editar ou renomear um atributo personalizado depois de cria-lo?

Sim. Acesse Configuracoes > Atributos Personalizados, localize o atributo e atualize o nome de exibição, a descrição, o tipo ou as opções da lista. A chave e o campo Aplica-se a não podem ser alterados. Os dados existentes armazenados nesse atributo serao preservados.

Quais tipos de campo posso criar?

Seis: text (entrada livre), number (inteiro/decimal), list (dropdown de opções predefinidas), date, checkbox (boolean), link (URL clicável).

Devo usar list ou text pra valor com poucas opções?

List. Sempre list quando o valor é restrito. Text convida typos ('Premium' vs 'premium' vs 'PREM') que quebram condições de regras de automação. Lists mantêm dados normalizados.

Posso criar custom attributes em conversas também?

Sim. Escolhe Conversa em Aplica-se a ao criar. Útil pra tags ticket-específicas tipo 'razão de escalação' ou 'área de produto' que não se aplicam ao cliente geral.

Como bulk-update valores de custom attribute?

Via API (tokens de API exigem o plano Enterprise) ou por importação CSV: um administrador abre Configurações > Importação e migração, escolhe a importação CSV e mapeia a coluna para Atributo personalizado. O valor é salvo com o cabeçalho da coluna como chave, então dá à coluna o nome da chave do atributo (por exemplo subscription_plan). Contatos existentes com o mesmo e-mail ganham os valores como updates.

O bot AI pode ler custom attributes?

O Copilot sim: ele lê o contato com os custom attributes quando te ajuda numa conversa. As instruções do bot Fynn não têm placeholders para valores de atributos como {{contact.attributes.plan}}. O Fynn usa os atributos de um contato só num chat ao vivo com um visitante que o seu site verificou, só quando Contacts está ativado em Data Access, nas configurações do bot, e só os atributos que o seu site assinou (veja a documentação do widget para desenvolvedores). Aí o Fynn pode dizer ao cliente o que esses atributos dizem. Atributos enviados sem assinatura, ou definidos no painel ou pela API, nunca chegam ao Fynn e ficam só com a sua equipe.

Valores de custom attribute são visíveis ao cliente?

Não. São metadata interna only. Clientes nunca veem direto, mas o Fynn pode dizer a um visitante verificado o que os atributos assinados pelo seu site dizem (veja a pergunta sobre o bot de IA acima). Se você quer surfar pro cliente, constrói o display você mesmo no widget ou em e-mails transacionais.

Posso renomear um attribute depois que já tem dados?

Sim. Só o nome de exibição muda; a chave e os valores salvos continuam iguais. Útil quando você percebe que o naming inicial estava off.

O que acontece quando deleto um attribute que tem dados?

Só o atributo em si é excluído, e isso não dá para desfazer. Os valores já salvos continuam nos contatos e conversas e aparecem somente leitura abaixo dos outros atributos.

Tem cap rígido no número de attributes?

Sem cap rígido. Acima de uns 30 a 50 atributos, a sidebar do contato fica cluttered. Revisa anualmente e exclui o que não usa. Um atributo do tipo lista aceita até 100 opções.

Posso usar custom attributes em automation rules?

Sim. Rules podem dar match em valores de attribute ('se contact.plan = Enterprise → atribuir ao time enterprise'). Um dos patterns mais úteis pra roteamento plan-tier-aware. Regras e macros não conseguem definir nem mudar valores de atributos.

Mudanças em attribute são rastreadas no audit log?

Em parte. No Enterprise, o audit log registra que os atributos de uma conversa foram alterados, com quem e quando, mas sem o valor antigo e o novo. Mudanças em atributos de contato não são registradas.

Posso mostrar attributes no chat widget público?

Não, attributes ficam no lado do agente. Seu site pode definir atributos de contato pelo widget com window.deskwoot.identify, mas só com a Verificação de identidade configurada na caixa de entrada.

Este guia foi útil?

Continue lendo

Perguntar ao Fynn sobre este guia

Receba uma resposta curta deste guia e do resto da Central de Ajuda.