Crie e rastreie atributos de dados personalizados (CDAs) sobre seus users e leads, com base em critérios específicos para o 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.

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 na ferramenta e podem precisar de ajuda no onboarding, você 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 reproduzidas
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 requisiçã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 só serão aceitas se vierem de uma requisição autenticada (via REST API ou JSON web token no Messenger). Requisiçõ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 requisiçã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 requisiçõ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 app store. 👌

Se precisar alterar o formato ou descrição do atributo que acabou de criar, você 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 se suas chaves sempre 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 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á enviando 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 já 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"

Coisas para lembrar:

Nomes de chave são sensíveis a maiúsculas e minúsculas, e não podem conter pontos ('.'), cifrões ('$'), caracteres como ~`!@#%^&*'{}[]|\'" ou o caractere NULL. — Se um caractere não suportado for usado, o atributo será criado com um sublinhado em seu lugar.
Valores de dados devem ser enviados como strings JSON, números ou booleanos (true ou false). Não aceitamos objetos, hashes aninhados ou formatos de dados em array.
Valores de string de texto podem conter até 255 caracteres. Isso se aplica apenas a atributos personalizados e não a atributos de dados de conversas.
Você pode limpar 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.
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 precisar coletar uma sequência de números, como um código postal estadual que inclui "0" no início, use um atributo String.
Atributo "Nome do Plano" da empresa: O Intercom inclui um atributo de sistema embutido chamado "Nome do Plano" para empresas. Ele não aparece em 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 (ex. "Plano de Assinatura") para evitar isso.

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

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

Importante: Recebemos nossos dados de geolocalização baseados 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 solicitar 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 VPN ou estejam viajando no momento, o que explicaria por que a localização aparece 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 region e suas abreviações aqui.

Outros métodos

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

Importante: Atributos de dados personalizados devem ser criados no Intercom antes que qualquer integração ou app de terceiros possa atualizar seus valores. Integrações e a REST API só podem atualizar 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 manualmente primeiro.

O que são dados de qualificação personalizados?

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 ping, precisa adicionar os pares chave/valor ao seu snippet 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 pré-determinados.

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 entenderem 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 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 valores via REST API.

Arquivar atributos de dados

Atributos de dados personalizados não podem ser totalmente excluídos, 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 não precisa.

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

Escolha um dado que deseja arquivar. Clique no ícone de edição ao lado 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 maior capacidade 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 é 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 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 precisar de um campo de país que possa ser atualizado manualmente por um user ou admin, você deve criar um atributo personalizado para esse fim.

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

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

Para corrigir isso, renomeie seu atributo personalizado para que não duplique nenhum nome de atributo Jira. Note que 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 único.

Criar e rastrear atributos de dados personalizados (CDAs)