Use este artigo para entender como o Intercom lida com datas — tanto como enviar atributos de data do seu próprio sistema quanto como as datas são exibidas no seu workspace.
Existem muitos motivos diferentes para rastrear datas no Intercom. O Intercom já rastreia algumas datas por padrão, como quando seus users se inscrevem ou são vistos pela primeira vez no seu site. Leia mais sobre os dados que o Intercom rastreia automaticamente aqui.
Nota: A primeira seção deste artigo (envio de atributos de data) é destinada a desenvolvedores ou colegas com perfil técnico configurando o Intercom. A segunda seção (quais datas você vê no app) se aplica a todos os colegas.
Você também pode enviar datas para o Intercom como atributos personalizados de user. Por exemplo, você pode rastrear a data em que um user assinou um dos seus produtos ou a data em que cancelou a assinatura.
Depois de enviar esses atributos de data para o Intercom, você pode enviar uma Mensagem de Suporte Proativo para users que cancelaram há uma semana ou enviar um Tour do Produto para users recém-assinados para ajudar na integração.
Rastreamento de atributos de data no Intercom
Existem duas maneiras de rastrear atributos de data no Intercom sobre seus users:
1. Se você criar um nome de atributo personalizado que termine com “_at”, nós automaticamente o trataremos como uma data em vez de um número (veja "last_order_at" abaixo).
window.intercomSettings = {
email: "bob@example.com",
user_id: "123",
app_id: "abc1234",
"last_order_at" : 1350466020, // Send dates in unix timestamp format and end key names with "_at"
}
2. Alternativamente, você pode criar atributos de data em Configurações > Dados > Pessoas no seu workspace.
Escolha o formato Data ao criar esses atributos. Quando começar a enviar dados para esses atributos no Intercom, certifique-se de enviar as datas como um timestamp Unix (um número inteiro que representa o número de segundos desde 1º de janeiro de 1970 UTC — apenas segundos, não milissegundos) ou no formato DD/MM/AAAA.
Recomendamos que você não permita atualizações ou criação de atributos via Messenger, pois isso pode representar um risco de segurança. Saiba mais aqui.
O que é um timestamp Unix e por que é necessário?
Atributos de data devem idealmente ser enviados para o Intercom como um timestamp Unix. Um timestamp Unix é um número inteiro que representa o número de segundos desde 1º de janeiro de 1970 UTC — por exemplo, 1350466020 representa 17 de outubro de 2012 às 12:27 UTC. Toda linguagem de programação tem formas de calcular esses timestamps. O Intercom aceita apenas timestamps em segundos — milissegundos são rejeitados. O Intercom também aceita timestamps formatados em ISO 8601 (por exemplo, 2012-10-17T12:27:00Z) se não for possível gerar um timestamp Unix.
Timestamps Unix são sempre o formato preferido para atributos de data no Intercom, pois fornecem um ponto específico no tempo, podendo ser traduzidos entre fusos horários. Se você não souber ou não puder gerar o timestamp exato, também pode enviar atributos de data no formato DD/MM/AAAA. Assim, filtros como “Inscrito há mais de 30 dias” ainda funcionarão corretamente — embora não tão especificamente — para Mensagens de Suporte Proativo, Workflows e mais.
Como as datas são exibidas no app Intercom?
A maioria das datas na interface do Intercom é exibida no fuso horário local do seu navegador, então o que você vê pode ser diferente do que um colega vê em outro fuso horário. Por exemplo, um carimbo de data e hora de uma conversa mostrado como 4 de maio para você pode aparecer como 3 de maio para um colega cujo navegador está configurado para um fuso horário anterior.
Por exemplo, a data em que um user foi visto pela primeira vez, exibida no fuso horário local do visualizador:
Ou o carimbo de data e hora exibido ao passar o mouse sobre o ícone do canal na Inbox:
O fuso horário do seu workspace é usado separadamente para coisas como agendar mensagens e definir horário comercial. Se você e um colega em outro fuso horário virem exibições de datas diferentes para o mesmo registro de user ou conversa, isso é esperado — seus navegadores estão em fusos horários diferentes.