Crie e rastreie 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.

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 para começar, 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 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 só serão aceitas se vierem de uma solicitação autenticada (via REST API ou token web JSON 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, você pode editá-lo e fazer a alteração:

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 (a data e hora em que algo acontece) ex. "converted_at"

Coisas para lembrar:

Nomes de chaves 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 podemos aceitar objetos, hashes aninhados e 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 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.
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 começa com "0", use um atributo String.
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 o contrário), o nome original não pode ser reutilizado. Arquive o atributo errado e crie um novo com um nome ligeiramente diferente. Atributos de Conversa são separados e podem compartilhar 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 (ex.: "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 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 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 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, o 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 o REST API só podem atualizar valores de atributos existentes — não podem criar novas definições de atributos. Para adicionar um novo atributo, vá em Configurações > Dados > Pessoas e crie 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 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 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 nosso 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 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 totalmente excluídos, mas você pode arquivá-los. Dados arquivados não aparecem como filtro nas suas listas de user ou lead, 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 capacidade maior 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 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 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 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 via API em um atributo personalizado falham quando uso a integração Jira?

Atualizações via API em 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 via API são direcionadas para o atributo Jira em vez do seu atributo personalizado — e atualizações em atributos Jira são bloqueadas, causando falha na requisição.

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

Criar e rastrear atributos de dados personalizados (CDAs)