Crie e acompanhe atributos de dados personalizados (CDAs) sobre seus users e leads, com base em critérios específicos do seu negócio. Você pode usar esses dados para filtrar e criar segmentos de clientes, além de enviar mensagens e campanhas direcionadas. Também pode usá-los como dados de qualificação para qualificar leads e trial users.

O que é um atributo de dados personalizado?

Um atributo de dados personalizado (CDA) rastreia fatos sobre seus clientes — como o plano que alguém possui ou quando se inscreveu — ao contrário de um evento, que rastreia ações recorrentes do cliente.

O que isso não faz

Atributos de dados personalizados são os campos que você cria em Configurações > Dados > Pessoas. Alguns campos em uma conversa ou ticket, como Followers, são incorporados ao Inbox em vez de criados como atributos de dados personalizados, portanto, você não pode arquivá-los como atributos de dados personalizados.

Aqui está um exemplo: Se seu produto é uma ferramenta de gerenciamento de projetos, você poderia rastrear dados sobre o número de arquivos que cada user possui. Então, se quiser enviar mensagens para users que ainda não começaram a adicionar arquivos à ferramenta e podem precisar de ajuda na integração, poderia configurar uma mensagem direcionada a users com "arquivos menos que 1".

Os CDAs mais comuns configurados no Intercom são sobre desenvolvimento do cliente, como:

Plano de preço
Valor das compras
Número de colegas adicionados
Número de músicas tocadas
Data de término da assinatura

Importante:

O valor signed_up deve ser enviado ao Intercom através da sua integração. Esse valor indica o momento em que um user se inscreveu no seu serviço.

Você pode escolher atualizar o valor por:

enviar para nós o parâmetro created_at timestamp no snippet intercomSettings.
definir o valor para signed_up_at se você estiver usando nossa REST API.
usar uma importação CSV, mapeando uma das colunas importadas como data de inscrição.

O Intercom definirá automaticamente o valor para a data signed_up apenas nos seguintes casos:

SDKs (Android/iOS) e users não identificados
users criados através do snippet JS sem valor created_at

Nesses casos, os users terão o horário de inscrição definido para o momento da solicitação de criação. Em todos os outros casos, o valor deverá ser definido por você.

Criar atributos de dados personalizados

Para criar um novo atributo no Intercom, vá para Configurações > Dados > Pessoas e clique em + Criar atributo. Dê um nome ao seu novo atributo, uma descrição e selecione o tipo de dado que ele armazenará.

Impedir atualizações de atributo via Messenger

Se "Atualizações de Atributo" estiver ativado, as atualizações desse atributo serão aceitas apenas se vierem de uma solicitação autenticada (via REST API ou JSON web token no Messenger). Solicitações não autenticadas serão ignoradas.

Essa configuração pode ser ativada ou desativada para cada atributo e não afeta atualizações de outras fontes como nossa Public API, importações CSV, etc. Todos os atributos que não tiverem isso ativado estarão abertos a atualizações inseguras.

Nota:

Recomendamos que você ative "Atualizações de Atributo" para evitar atualizações não autorizadas dos seus dados. Você pode então configurar Segurança do Messenger com JWTs para permitir que esses campos sejam atualizados com segurança via Messenger.
Os atributos só são protegidos contra atualizações inseguras via Messenger se a configuração estiver ativada para cada atributo individualmente.
Atualizações de atributos via Messenger só serão processadas se a solicitação for autenticada com JWT. Usar o método legado de Verificação de Identidade (User hash) não funcionará e nenhuma atualização será processada para solicitações que tentem atualizar atributos protegidos que incluam user_hash em vez de JWTs.

Clique em salvar e o atributo será adicionado à sua lista de atributos. Ele ainda não estará preenchido para nenhum dos seus clientes, você precisará enviá-lo ao Intercom via snippet JavaScript, API ou um app da nossa loja de apps. 👌

Se precisar alterar o formato ou descrição do atributo que você acabou de criar, pode editá-lo e fazer a mudança:

Importante: O nome do atributo de dados personalizado não pode ser alterado após a criação. Você precisará arquivar o atributo existente e criar um novo.

Atualizar atributos personalizados via Messenger

Atributos de dados personalizados podem ser atualizados usando o snippet de código Javascript do Messenger.

Ao atualizar atributos personalizados via messenger, verifique sempre se suas chaves têm um valor JSON válido que seja uma string (texto), número ou booleano (true ou false). Isso significa usar aspas duplas em torno de strings de texto e enviar NULL para casos em que não exista valor para um user.

Você também pode nos enviar datas ou URLs. Pode rastrear URLs como uma string de texto, por exemplo, "http://www.google.com". O Intercom reconhecerá isso e automaticamente transformará em um hyperlink. Rastreie datas enviando um timestamp unix em segundos. Se você criar um nome de chave que termine com “_at”, trataremos automaticamente como uma data em vez de um número (veja "last_order_at" abaixo). Saiba como datas funcionam no Intercom aqui.

Importante: Certifique-se de que está passando UNIX em segundos e não em milissegundos.

Aqui estão alguns exemplos de pares de chave e valor de atributos de dados:

window.intercomSettings = {
  email: "bob@example.com",
  user_id: "123",
  app_id: "abc1234",
  created_at: 1234567890,
  "subdomain": "intercom", // Put quotes around text strings
  "teammates": 4, // Send numbers without quotes
  "active_accounts": 12,
  "last_order_at" : 1350466020, // Send dates in unix timestamp format and end key names with "_at"
  "custom_domain": null // Send null when no value exists for a user
}

Importante: Não use um objeto aninhado custom_attributes: {} ao passar CDAs via snippet JS do Messenger. Esse formato (ex. custom_attributes: { lead_source: "Intercom" }) é válido apenas para a REST API. Quando passado via window.intercomSettings ou window.Intercom("boot", ...), o Messenger descartará silenciosamente esses valores e eles não serão atualizados no backend. Sempre passe CDAs como chaves de nível superior diretamente no objeto de configurações, como mostrado no exemplo acima. O atributo também deve existir no Intercom antes que qualquer valor seja aceito via Messenger.

Diferentes tipos de CDAs que você pode enviar para o Intercom

String (ou seja, palavras) Ex. URLs, nome do plano, tipo de user, etc.
Número (inteiro)
Booleano (true / false)
Timestamp (data e hora em que algo acontece) ex. "converted_at"

Nota: Campos de data e hora são tratados como datas apenas em relatórios e filtros, então os filtros funcionam por dia, não por hora, minuto ou segundo. Atributos personalizados de data/hora podem não aparecer em relatórios para métricas que não suportam isso.

Coisas para lembrar:

Os nomes das chaves são sensíveis a maiúsculas e minúsculas e não podem conter pontos ('.'), sinais de dólar ('$'), caracteres como ~`!@#%^&*'{}[]|\" ou o caractere NULL. — Se um caractere não suportado for usado, o atributo será criado com um sublinhado em seu lugar.
Os valores dos dados devem ser enviados como strings JSON, números ou booleanos (true ou false). Não podemos aceitar objetos, hashes aninhados e formatos de dados em array.
Os valores de strings de texto podem conter até 255 caracteres. Isso se aplica apenas a atributos personalizados e não a atributos de dados de conversa.
Você pode limpar os valores de dados existentes enviando strings vazias.
O Intercom rastreia automaticamente vários atributos padrão. Verifique-os antes de criar atributos personalizados.
O limite suave é de 250 CDAs ativos.
Os valores numéricos não podem começar com "0". Inteiros são números inteiros, então "01234" deve ser inserido como "1234". Se você precisar coletar uma sequência de números, como um código postal estadual que inclui um "0" no início, deve usar um atributo String.
Os atributos de Pessoas e Empresas compartilham um namespace de nomes: Um nome de atributo personalizado usado em Pessoas não pode ser reutilizado em Empresas, e vice-versa — mesmo que o atributo existente esteja arquivado. Isso significa que, se você criar acidentalmente um atributo em Pessoas que pretendia para Empresas (ou vice-versa), o nome original não pode ser reutilizado. Arquive o atributo incorreto e crie um novo com um nome ligeiramente diferente. Os atributos de conversa são separados e podem compartilhar um nome com atributos de Pessoas ou Empresas sem conflito.
Atributos personalizados não podem ser excluídos: Atributos personalizados só podem ser arquivados — não excluídos permanentemente pela interface. O suporte do Intercom não pode excluí-los por você.
Atributo "Plan Name" da Empresa: O Intercom inclui um atributo de sistema embutido chamado "Plan Name" para empresas. Ele não aparece nas Configurações, mas aparece na barra lateral da conversa. Se você criar um atributo personalizado para empresa com o mesmo nome, ambos aparecerão na barra lateral — causando duplicação aparente. Use um nome distinto (por exemplo, "Subscription Plan") para evitar isso.

Depois de atualizar seu trecho de código e começar a rastrear os dados, você deve:

Ative a verificação de identidade para seus users.
Crie descrições para cada atributo para ajudar seus colegas a entendê-los.

Importante: Recebemos nossos dados de geolocalização com base no endereço IP do User de um serviço terceirizado chamado Maxmind. Não temos controle sobre esses dados e não é possível atualizá-los via API, mas você pode optar por enviar uma solicitação de correção de dados através desta página se acreditar que estão incorretos.

Além disso, é possível que esses users estejam usando uma VPN ou estejam viajando no momento, o que explicaria por que a localização parece incorreta.

Quanto ao atributo "region": para os Estados Unidos, "region" se refere ao Estado. Em outros países pode variar - por exemplo, no Canadá "region" se refere à Província.

Você pode ver uma lista de todos os valores de região e suas abreviações aqui.

Outros métodos

Também é possível rastrear e atualizar atributos personalizados sobre seus users, com importações CSV, a REST API do Intercom, ou muitos aplicativos de terceiros.

Importante: Os atributos de dados personalizados devem ser criados no Intercom antes que qualquer integração ou aplicativo de terceiros possa atualizar seus valores. Integrações e a REST API só podem atualizar os valores de atributos existentes — não podem criar novas definições de atributos. Para adicionar um novo atributo, vá para Configurações > Dados > Pessoas e crie-o manualmente primeiro.

O que é dado de qualificação personalizado?

Dados de qualificação são um conjunto especial de atributos que você pode atualizar manualmente nos perfis dos seus clientes conforme os qualifica. Você pode configurá-los via um formulário simples no Intercom. Se pretende atualizar esses dados manualmente, não precisa fazer mais nada.

Se quiser rastrear esses dados via um ping, precisa adicionar os pares chave/valor ao seu trecho de código intercomSettings, assim como faria com outros dados personalizados.

Para criar novos dados de qualificação personalizados, vá para Configurações > Dados > Pessoas > Qualificação de leads.

Role para baixo e clique em Adicionar dados e depois em + Criar novos dados no menu suspenso.

Aqui você pode criar um nome (que é sua chave) e escolher um formato para os valores que irá coletar (Texto, Número, Verdadeiro ou Falso, ou Lista).

Se escolher o formato Lista, não é uma estrutura de array, mas sim uma lista de seleções onde os valores são predeterminados.

Nota: É possível definir o valor de um atributo de lista para um valor que você não configurou manualmente para a lista usando nossa REST API. Esse valor não será adicionado como uma opção permanente para essa lista ao alterar o valor manualmente e pode ser perdido se um colega alterar esse valor manualmente.

Por fim, você pode adicionar uma descrição para ajudar seus colegas a entender os dados.

Escolha nomes simples para seus dados de qualificação personalizados. Se decidir qualificar esses dados via Messenger, os clientes verão esses nomes no Messenger.

Importante: Atributos de lista suspensa selecionáveis manualmente em Dados de Pessoas são limitados a 35 opções por atributo. Esse limite não pode ser removido. Se precisar de mais de 35 valores, use um atributo de texto e defina os valores via REST API.

Arquivar atributos de dados

Atributos de dados personalizados não podem ser excluídos completamente, mas você pode arquivá-los. Dados arquivados não aparecerão como filtro nas suas listas de users ou leads, então é uma boa forma de limpar dados que você não precisa.

Vá para Configurações > Dados > Pessoas.

Escolha um dado que você gostaria de arquivar. Clique no ícone de edição ao lado dele e depois clique em Arquivar na caixa pop-up. Você pode desarquivá-los se mudar de ideia, mas não pode excluir completamente atributos de dados personalizados.

Para encontrar seus atributos personalizados arquivados, basta rolar até o final da página.

Se quiser desarquivar seu atributo personalizado, abra o atributo e clique em "Desarquivar".

Entendendo os limites e melhores práticas dos CDAs

Atributos de dados personalizados (CDAs) têm limites por workspace para manter desempenho ideal.

Há um limite de 250 CDAs de Pessoas e Empresas por workspace, mas você pode arquivar atributos não usados para liberar espaço.

Ao criar novos atributos, considere estas melhores práticas:

Crie atributos que tenham ampla aplicação entre os users.
Evite criar atributos para situações pontuais.
Considere usar Eventos como alternativa para cenários específicos.
Utilize tags quando apropriado, pois elas não têm as mesmas limitações.

Revise regularmente o uso dos seus CDAs para garantir uma gestão eficiente do workspace. Se precisar de capacidade aumentada após implementar estratégias de otimização, aumentos adicionais de limite podem estar disponíveis mediante solicitação.

Nota: Se você está enviando dados sobre seus users via Messenger, recomendamos fortemente que você proteja seu Messenger. Veja mais:

Autenticando seus users com JSON web tokens (JWTs)

Perguntas frequentes

Como o atributo 'Country' é preenchido e com que rapidez ele é atualizado para uso em workflows?

O atributo 'Country' é preenchido e atualizado automaticamente com base no endereço IP do user. Isso acontece instantaneamente sempre que um user está ativo no seu app ou interage com o Messenger. Como os dados estão disponíveis em tempo real, você pode usá-los para ramificar imediatamente um workflow assim que um user iniciar uma conversa.

O atributo 'Country' pode ser editado manualmente?

Não, o atributo 'Country' é um campo gerado pelo sistema e não pode ser editado manualmente. Se você precisar de um campo de país que possa ser atualizado manualmente por um usuário ou um administrador, deve criar um atributo personalizado para esse fim.

Por que minhas atualizações de API para um atributo personalizado estão falhando quando uso a integração com Jira?

Atualizações de API para atributos personalizados podem falhar silenciosamente se um atributo personalizado compartilhar o mesmo nome que um atributo do Jira. Quando existem nomes duplicados, as solicitações de atualização de API são direcionadas para o atributo do Jira em vez do seu atributo personalizado — e as atualizações para atributos do Jira são bloqueadas, causando a falha da solicitação.

Para corrigir isso, renomeie seu atributo personalizado para que ele não duplique nenhum nome de atributo do Jira. Note que os nomes de atributos personalizados não podem ser alterados após a criação, então você precisará arquivar o atributo existente e criar um novo com um nome exclusivo.

Criar e acompanhar atributos de dados personalizados (CDAs)