Utilisez cet article pour comprendre comment Intercom gère les dates — comment envoyer des attributs de date depuis votre propre système et comment les dates sont affichées dans votre workspace.
Il existe de nombreuses raisons de suivre les dates dans Intercom. Intercom suit déjà certaines dates par défaut, comme lorsque vos users s'inscrivent ou sont vus pour la première fois sur votre site web. En savoir plus sur les données que Intercom suit automatiquement ici.
Note : La première section de cet article (envoi des attributs de date) est destinée aux développeurs ou aux coéquipiers techniques configurant Intercom. La deuxième section (les dates que vous voyez dans l'application) s'applique à tous les coéquipiers.
Vous pouvez également envoyer à Intercom des dates en tant que attributs personnalisés des users. Par exemple, vous pourriez suivre la date à laquelle un user s'est abonné à l'un de vos produits ou la date à laquelle il a annulé son abonnement.
Une fois que vous envoyez ces attributs de date à Intercom, vous pouvez envoyer un Message de Support Proactif aux users qui ont annulé il y a une semaine, ou envoyer un Tour de Produit aux users nouvellement abonnés pour les aider dans leur intégration.
Suivi des attributs de date dans Intercom
Il existe deux façons de suivre les attributs de date dans Intercom concernant vos users :
1. Si vous créez un nom d'attribut personnalisé qui se termine par « _at », nous le traiterons automatiquement comme une date plutôt qu'un nombre (voir « last_order_at » ci-dessous).
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. Alternativement, vous pouvez créer des attributs de date depuis Paramètres > Données > People dans votre workspace.
Choisissez le format Date lors de la création de ces attributs. Lorsque vous commencez à envoyer des données Intercom pour ces attributs, assurez-vous d'envoyer les dates soit en timestamp Unix (un entier représentant le nombre de secondes écoulées depuis le 1er janvier 1970 UTC — secondes seulement, pas millisecondes) soit au format JJ/MM/AAAA.
Nous recommandons de ne pas autoriser les mises à jour ou créations d'attributs via le Messenger car cela peut représenter un risque de sécurité. En savoir plus ici.
Qu'est-ce qu'un timestamp Unix et pourquoi est-il nécessaire ?
Les attributs de date doivent idéalement être envoyés à Intercom sous forme de timestamp Unix. Un timestamp Unix est un entier représentant le nombre de secondes écoulées depuis le 1er janvier 1970 UTC — par exemple, 1350466020 représente le 17 octobre 2012 à 12h27 UTC. Chaque langage de programmation dispose de méthodes pour calculer ces timestamps. Intercom n'accepte que les timestamps en secondes — les millisecondes sont rejetées. Intercom accepte également les timestamps au format ISO 8601 (par exemple, 2012-10-17T12:27:00Z) si la génération d'un timestamp Unix n'est pas possible.
Les timestamps Unix sont toujours le format préféré pour les attributs de date dans Intercom, car ils fournissent un point précis dans le temps, ce qui permet de les traduire entre fuseaux horaires. Si vous ne connaissez pas ou ne pouvez pas générer le timestamp exact, vous pouvez aussi envoyer les attributs de date à Intercom au format JJ/MM/AAAA. Ainsi, des filtres comme « Inscrit il y a plus de 30 jours » fonctionneront toujours correctement — même si moins précisément — pour les Messages de Support Proactif, Workflows et plus.
Comment les dates sont-elles affichées dans l'application Intercom ?
La plupart des dates dans l'interface Intercom sont affichées dans le fuseau horaire local de votre navigateur, donc ce que vous voyez peut différer de ce qu'un coéquipier voit dans un fuseau horaire différent. Par exemple, un horodatage de conversation affiché comme le 4 mai pour vous peut apparaître comme le 3 mai pour un coéquipier dont le navigateur est réglé sur un fuseau horaire plus tôt.
Par exemple, la date à laquelle un user a été vu pour la première fois, affichée dans le fuseau horaire local du spectateur :
Ou l'horodatage affiché en survolant l'icône du canal dans l'Inbox :
Le fuseau horaire de votre workspace est utilisé séparément pour des choses comme la planification des messages et la définition des heures de bureau. Si vous et un coéquipier dans un fuseau horaire différent voyez des affichages de dates différents pour le même enregistrement user ou conversation, c'est normal — vos navigateurs sont dans des fuseaux horaires différents.