Taqt (Skiply) - Ubiqod Key

Avec Ubiqod Key, Taqt (Skiply) propose une solution de pointage basée sur un QR code à usage unique. Ce code est affiché sur un écran epaper qui change à intervalles réguliers. Le collaborateur scanne le QR code grâce à son smartphone.

Deux options sont possibles :

• Taqt (Skiply) vérifie la validité du token (technique). Si le token est valide, le collaborateur est redirigé vers l'interface Taqt (Skiply) et se connecte avec son identifiant pour enregistrer son horodatage. Taqt (Skiply) envoie l'horodatage de pointage à Timesquare en temps réel pour la personne qui s'est connectée. Le pointage est alors disponible directement dans Timesquare.
• Le collaborateur est redirigé vers My Timesquare et se connecte avec ses identifiants My Timesquare habituels. Timesquare contrôle le timeout paramétré. Si le contrôle est valide, Taqt (Skiply) envoie l'horodatage du pointage à Timesquare en temps réel pour la personne qui s'est connectée. Le pointage est alors disponible directement dans Timesquare.

Pour en savoir plus sur la marketplace, je me réfère au site Holy-Dis.

Vérifier l'activation de l'application

Je peux vérifier si Taqt (Skiply) est activé.

Activer Taqt (Skiply)

Pour activer Taqt (Skiply), je prends contact avec les équipes Holy-Dis.

Option 1 : connexion du collaborateur à Taqt (Skiply)

Le collaborateur scanne le QR code grâce à son smartphone. Taqt (Skiply) vérifie la validité du token (technique). Si le token est valide, il est redirigé vers l'interface Taqt (Skiply) et se connecte avec son identifiant pour enregistrer son horodatage. Taqt (Skiply) envoie l'horodatage du pointage à Timesquare en temps réel pour la personne qui s'est connectée. Le pointage est alors disponible directement dans Timesquare.

Pour utiliser le pointage par scan de Taqt (Skiply), il est nécessaire de s'assurer que le smartphone utilisé dispose des fonctionnalités habituelles pour scanner un QR code (appareil photo ou encore application à télécharger). Pour en savoir plus, se reporter à la page Solidarite-numerique.fr.

Schéma simplifié de l'infrastructure avec connexion à Taqt (Skiply) (en bleu ce qui relève de Taqt (Skiply), en orange ce qui relève de Timesquare)

Paramétrer Taqt (Skiply) et Timesquare pour l'intégration des pointages

L'administrateur crée les identifiants de badgeuses (trackers) dans l'interface Taqt (Skiply). Ces identifiants de badgeuses doivent être créés dans Timesquare depuis la page Configuration / Gestion des temps / Badgeuses. L'identifiant interne de la badgeuse dans Timesquare doit correspondre au label de la balise tracker défini dans le paramétrage de Taqt (Skiply) (exemple QRCODEHD01).

L'administrateur crée les badges des personnes (pincode) dans l'interface Taqt (Skiply). Ces badges doivent être créés et affectés aux personnes concernées dans Timesquare depuis la page Administratif / Affectations / Badges. Ils peuvent également être importés. Le code du badge dans Timesquare doit correspondre au pincode de la balise Data / Pincode / Code défini dans le paramétrage de Taqt (Skiply) (exemple 4321).

L'administrateur paramètre les types de pointage dans l'interface Taqt (Skiply). Le type de pointage correspond à la balise data / action / code défini dans le paramétrage de Taqt (Skiply).

Intégrer les pointages issus de Taqt (Skiply)

Les pointages par QR code issus de Taqt (Skiply) sont récupérés par Timesquare en temps réel. A chaque nouveau pointage, le webhook de Taqt (Skiply) appelle un Web Service Timesquare. Ces pointages bruts sont immédiatement disponibles dans la section Liste pointage du bloc du bas de l'écran de Suivi du réalisé. Une fois le traitement des pointages effectué (toutes les nuits), ils seront disponibles dans le réalisé pointé après traitement.

Les informations utilisées par Timesquare, transmises par le Web Service, sont les suivantes :

• Identifiant interne de la badgeuse / label du tracker
• Code du badge de la personne / pincode
• Date et heure du pointage / timestamp
• Type de pointage / action / code

Si le code PIN (badge) est inexistant dans Timesquare, ou que le salarié saisit un code PIN erroné au moment du pointage, il n’est pas possible de récupérer les pointages.

Le fuseau horaire enregistré est celui du site auquel le tracker est associé. L'heure envoyée par Taqt (Skiply) contient l'information du fuseau horaire, qui est interprétée par Timesquare. 

Option 2 : Connexion du collaborateur à My Timesquare

Le collaborateur scanne le QR code grâce à son smartphone. Il est redirigé vers My Timesquare et se connecte avec ses identifiants My Timesquare habituels. Timesquare contrôle le timeout paramétré. Si le contrôle est valide, Timesquare récupère l'horodatage de pointage en temps réel pour la personne qui s'est connectée. Le pointage est alors disponible directement dans Timesquare.

Pour utiliser le pointage par scan de Taqt (Skiply), il est nécessaire de s'assurer que le smartphone utilisé dispose des fonctionnalités habituelles pour scanner un QR code (appareil photo ou encore application à télécharger). Pour en savoir plus, se reporter à la page Solidarite-numerique.fr.

Schéma simplifié de l'architecture avec connexion à My Timesquare (en bleu ce qui relève de Taqt (Skiply), en orange ce qui relève de Timesquare)

Paramétrer Taqt (Skiply) et Timesquare pour l'intégration des pointages

Taqt (Skiply) crée un token et un horodatage de pointage dans Taqt (Skiply). Ce token est envoyé en variable dans l'URL de connexion à My Timesquare. C'est grâce à ce token que Timesquare peut interroger la base Taqt (Skiply) pour récupérer l'horodatage associé.

Dans l'interface Taqt (Skiply), il est nécessaire de saisir l'URL de connexion de My Timesquare.

Les équipes techniques Holy-Dis enregistrent l'API Key fournie par Taqt (Skiply) dans un fichier de configuration. Pour des raisons de sécurité, l'API Key est cryptée.

Elles définissent également un timeout entre la connexion du collaborateur à My Timesquare et l'horodatage enregistré par Taqt (Skiply). Si le contrôle de ce timeout échoue, un message d'erreur s'affiche et le pointage n'est pas enregistré. Par défaut, le timeout est de 5mn.

Dans tous les cas, même si le pointage n'est pas autorisé / enregistré, l'horodatage, quant à lui, est enregistré dans les logs (pour une période de 3 mois).

Vérifier les interdictions de pointage

Si le contrôle du timeout aboutit correctement, Timesquare vérifie s'il y a des interdictions de pointages qui bloqueraient l'enregistrement du pointage.

• Si le pointage est autorisé, il est enregistré en base, un message de confirmation s'affiche.
• Si le pointage est interdit, il n'est pas enregistré en base, un message d'erreur s'affiche.

Schéma simplifié des interdictions de pointages

Intégrer les pointages issus de Taqt (Skiply)

Les pointages par QR code issus de Taqt (Skiply) sont récupérés par Timesquare en temps réel. A chaque nouveau pointage, le webhook de Taqt (Skiply) appelle un Web Service Timesquare. Ce Web Service contient en paramètre le token envoyé par Taqt (Skiply) dans l'URL de connexion à My Timesquare.

Ces pointages bruts récupérés par Web Services sont immédiatement disponibles dans la section Liste pointage du bloc du bas de l'écran de Suivi du réalisé. Par la suite, une fois le traitement des pointages effectué, ils seront disponibles dans le réalisé pointé après traitement. 

Les informations utilisées par Timesquare, transmises par le Web Service, sont les suivantes :

• Date et heure du pointage / timestamp

Gestion des crédits (Ubiqoins)

Il est possible que la gestion des crédits soit attribuée à Holy-Dis. Dans ce cas, la plateforme fonctionne de la manière suivante :

Depuis son interface Taqt (Skiply), le client peut déléguer à Holy-Dis la gestion des Ubiqod et par conséquent celle des Ubiqoins. Holy-Dis accepte la demande pour que ce soit effectif (sous réserve que cela a bien été prévu dans le cadre des accord commerciaux).

A partir de ce moment-là, les crédits (Ubiqoins) sont débités directement sur le compte de Holy-Dis.

Le client continue à gérer l'intégralité des paramètres, y compris l'activation / désactivation, mais Holy-Dis a également la possibilité à terme de révoquer la prise en charge (par exemple en fin de contrat).

Ressources disponibles

• www.skiply.eu
• Le blog Taqt (Skiply)
• Spécifications techniques
• Scanner un QR code avec son smartphone - Source : Solidarite-numerique.fr