Agent de Synchronisation

Synchronisation automatique des données de présence depuis les appareils biométriques ZKTeco vers le cloud AttendUX.

Guide d'Utilisation Agent de Synchronisation

Aperçu

L'Agent de Synchronisation AttendUX est une application Windows légère qui relie vos appareils ZKTeco locaux à la plateforme cloud AttendUX.

Il fonctionne en arrière-plan, récupérant périodiquement les enregistrements de présence de vos appareils ZKTeco et les téléversant automatiquement sur votre serveur.

Conseil : L'Agent n'a besoin d'être installé que sur UN SEUL ordinateur connecté au même réseau local que vos appareils ZKTeco.

Téléchargement et Installation

Téléchargez l'installateur de l'Agent et suivez l'assistant de configuration :

1

Télécharger l'Installateur

Téléchargez la dernière version de l'Agent de Synchronisation : Télécharger Attendux-Sync-Agent.exe

2

Exécuter l'Installateur

Double-cliquez sur le fichier téléchargé et suivez l'assistant d'installation. Acceptez les paramètres par défaut.

3

Lancer l'Agent

Après l'installation, l'Agent démarrera automatiquement. Vous verrez son icône dans la barre des tâches.

AttendUX Sync Agent — Setup

AttendUX Sync Agent

v2.1.0 · Windows Desktop

Installation Complete!
Launch Agent
Close
Capture : Installateur de l'Agent

Configuration

Configurez l'Agent avec les détails de votre serveur et les informations de l'appareil :

Champ Description Exemple
URL du ServeurL'adresse de votre serveur AttendUXhttps://votreentreprise.attendux.com
Code EntrepriseVotre identifiant d'entreprise uniqueCOMP-001
Clé APIClé d'authentification depuis Paramètres → Intégrationssk_live_xxx...
Intervalle de SynchronisationFréquence de synchronisation (en minutes)5
IP de l'AppareilAdresse IP locale de l'appareil ZKTeco192.168.1.201
AttendUX Sync Agent — Config
Configuration
https://company.attendux.com
COMP-001
sk_live_xxxxxxxxxxxxx
192.168.1.201
5 min
Connected · Last sync: 2 min ago
Save & Sync Now
Capture : Configuration de l'Agent

Comment Fonctionne la Synchronisation

Le processus de synchronisation suit ces étapes automatiquement :

1

Connexion à l'Appareil

L'agent se connecte à votre appareil ZKTeco via le réseau local en TCP/IP.

2

Récupération des Nouveaux Enregistrements

Il récupère tous les nouveaux pointages depuis la dernière synchronisation.

3

Téléversement vers le Cloud

Les enregistrements sont envoyés de manière sécurisée à votre serveur via HTTPS et associés automatiquement aux employés.

Conseil : L'Agent conserve un journal local de toutes les synchronisations. Consultez l'onglet Journaux si vous soupçonnez des enregistrements manquants.

Exécution en tant que Service

Pour une fiabilité maximale, configurez l'Agent pour s'exécuter en tant que service Windows afin qu'il démarre automatiquement au démarrage.

Ouvrez les paramètres de l'Agent et activez "Exécuter en tant que Service Windows". Cela garantit la synchronisation même sans utilisateur connecté.

Avertissement : L'ordinateur exécutant l'Agent doit rester allumé et connecté au même réseau que les appareils ZKTeco.

Dépannage

Problèmes courants de synchronisation et solutions :

Impossible de se connecter à l'appareil

Vérifiez l'IP de l'appareil, assurez-vous qu'il est allumé et que l'ordinateur et l'appareil sont sur le même réseau. Essayez de pinguer l'IP.

Aucune donnée synchronisée

Vérifiez que la clé API est correcte et non expirée. Vérifiez que l'URL du serveur inclut https://. Confirmez que l'appareil a de nouveaux enregistrements.

Enregistrements en double

L'agent a une déduplication intégrée. Si des doublons apparaissent, videz le cache de l'agent et resynchronisez. Assurez-vous qu'une seule instance est en cours.