Configurer le système d'accès Comydo

Avec l’intégration Comydo, les participants utilisent leur billet personnel edoobox sur un lecteur de porte configuré. edoobox vérifie si la personne possède actuellement une participation confirmée correspondante. Comydo commande le système de fermeture connecté.

Un scan autorisé peut également définir un état de présence. L’installation physique du lecteur, de la porte et du système de fermeture est réalisée avec Comydo ou votre partenaire d’installation.

Vérifier les conditions et le plugin

Le plugin Comydo est disponible et activé pour votre compte dans le Plugin Manager.
Vous disposez de droits d’écriture sur les paramètres. Les droits de lecture permettent de consulter les connexions existantes ; la configuration, les modifications et Vérifier l’accès nécessitent des droits d’écriture.
Les billets personnels sont configurés et les personnes concernées possèdent des réservations confirmées.
Les dates prévues, les attributions d’offres et les salles sont renseignées.
Comydo peut joindre l’adresse affichée par edoobox et envoyer une demande de vérification authentifiée.

Ouvrez Paramètres globaux → Intégrations → Systèmes d’accès. Si les détails du plugin apparaissent d’abord, vérifiez son activation dans le Plugin Manager.

Distinguer connexion, accès, lecteur et règle

Niveau	Tâche	Exemple
Connexion	Contient l’adresse et la clé pour Comydo.	Centre sportif
Accès / salle	Regroupe les lecteurs, les règles d’autorisation et l’état de présence facultatif.	Halle Nord – Entrée
Lecteur	L’appareil concret auquel un billet est présenté.	Lecteur Nord
Règle d’accès	Détermine les réservations autorisées et les plages horaires.	Créneaux de halle réservés avec accès 20 minutes avant

Un accès peut comprendre plusieurs lecteurs et règles. Dans sa connexion, un lecteur appartient à un seul accès. Une connexion commune suffit souvent pour plusieurs portes ; une autre connexion possède sa propre adresse et sa propre clé.

Créer une connexion Comydo

Dans l’intégration Comydo, sélectionnez Configurer et attribuez un nom compréhensible.
Enregistrez la connexion. L’état Configuré · pas encore activé est prévu pour la préparation.
Copiez l’URL du webhook affichée.
Renseignez dans Comydo l’URL complète pour une requête POST avec JSON ainsi que le jeton Bearer affiché.
Conservez le jeton en lieu sûr. Il n’est affiché qu’à ce moment-là.
Ouvrez Gérer pour préparer les accès, les lecteurs et les règles.

Aucun compte API Comydo supplémentaire n’est nécessaire pour cette connexion. Le remplacement du jeton sous Paramètres avancés → Remplacer le jeton invalide immédiatement l’ancienne clé. Actualisez ensuite la configuration Comydo avant d’attendre à nouveau des scans normaux.

Créer un accès et définir son effet sur la présence

Dans la connexion, sélectionnez Ajouter un accès.
Attribuez un nom, par exemple « Halle Nord – Entrée ».
Sélectionnez État de présence lors du scan ou Ne pas modifier la présence.
Enregistrez et ouvrez l’accès avec Gérer.

Pour les scans de sortie, créez un accès distinct avec son propre lecteur et l’état de sortie souhaité. Le sens n’est pas déduit du seul lecteur ni de son nom.

Attribuer des lecteurs

Manuellement : sélectionnez Ajouter un lecteur, saisissez le nom et l’identifiant d’appareil fourni par Comydo, puis enregistrez l’attribution à l’accès ouvert. Les identifiants d’appareil comportent de 8 à 20 caractères hexadécimaux. N’utilisez pas le même identifiant pour un deuxième accès.

Détection automatique : dans l’accès, sélectionnez Détecter automatiquement le lecteur. Effectuez un scan de test sur le nouvel appareil. Dès que la requête Comydo authentifiée arrive, Nouveau lecteur détecté apparaît. Sélectionnez Attribuer le lecteur, vérifiez l’accès et confirmez.

Un appareil détecté n’obtient une autorisation d’accès qu’après votre attribution. Si la fenêtre de configuration expire, relancez la détection. « Dernier scan » confirme la réception d’un scan ; consultez le résultat dans le journal d’accès.

Définir la règle d’accès et la plage horaire

Dans l’accès, sélectionnez Ajouter une règle.
Attribuez un nom compréhensible.
Choisissez l’autorisation selon un ensemble d’offres ou une salle.
Attribuez l’offre souhaitée, une catégorie ou un niveau de compte approprié, ou la salle.
Définissez l’accès avant le début et après la fin du créneau. Les valeurs autorisées vont de 0 à 1440 minutes par paliers de cinq minutes.
Enregistrez et vérifiez l’état d’activation de la règle.

Une catégorie ou le niveau de compte comprend également les offres sous-jacentes ajoutées ultérieurement. L’accès reste toutefois réservé aux personnes ayant effectivement une réservation confirmée pour un créneau correspondant. Pour les multi-offres, la règle doit correspondre à la sous-offre réservée ; le conteneur n’accorde aucun accès général.

La plage s’applique à chaque créneau réservé. Elle n’accorde pas d’accès continu entre deux jours de cours et ne maintient pas une porte ouverte en permanence. Les listes d’attente, réservations MustPay non confirmées, réservations annulées et séances non réservées sont refusées. Une facture impayée ne bloque pas à elle seule une participation normale déjà confirmée. Avant l’utilisation, adaptez la règle de paiement souhaitée au processus de réservation.

Présences modifiées par un scan réussi

Si un état de présence est défini, un scan autorisé actualise tous les créneaux confirmés actuellement en cours de la personne dans le compte. Cela peut inclure un créneau simultané d’une autre offre. Le créneau qui a autorisé l’accès pendant la période avant ou après est également pris en compte.

Les autres créneaux futurs et les séances non réservées ne sont pas globalement marqués comme suivis. Un état défini peut être remplacé par un autre scan autorisé avec un état différent. Les scans refusés ne modifient aucune présence. Si la présence prévue ne peut pas être enregistrée, l’accès n’est pas autorisé non plus.

Vérifier et activer l’accès

Vérifiez que la connexion, l’accès, le lecteur et au moins une règle correspondante sont actifs.
Sous Vérifier l’accès, sélectionnez le lecteur et saisissez un code de billet personnel.
Vérifiez le résultat avec une participation confirmée, une liste d’attente, une réservation annulée et un créneau en dehors de la plage horaire.
Effectuez ensuite un scan de test réel sur l’appareil connecté.
Contrôlez la réaction de la porte, le journal d’accès et, le cas échéant, la présence.

Vérifier l’accès utilise l’heure actuelle du serveur, n’ouvre aucune porte et ne modifie aucune présence. La vérification tient également compte des connexions désactivées et affiche un refus correspondant. Elle ne remplace donc pas un test sur la porte réelle.

Clarifier les refus dans le journal

Message	Point de contrôle
Connexion désactivée	État d’activation de la connexion sélectionnée.
Lecteur ou accès inconnu ou désactivé	Identifiant d’appareil, attribution et états d’activation des deux éléments.
Billet ou personne inactive	Code-barres personnel actuel et profil du participant.
Aucune participation confirmée correspondante dans la plage horaire	Réservation, créneau précis, sous-offre, salle et marge horaire.
La présence n’a pas pu être enregistrée	Vérifier l’état de présence et le créneau concerné ; l’accès n’est pas autorisé.

Le journal d’accès affiche les vérifications de la connexion sélectionnée et, le cas échéant, de l’accès sélectionné. Au maximum 200 entrées sont enregistrées par connexion, sans codes de billet ni jetons. L’interface charge un extrait actuel limité du compte ; avec plusieurs connexions, moins d’entrées peuvent apparaître. La source distingue un appel réel de lecteur d’une vérification de test. Utilisez le journal pour l’analyse actuelle des erreurs.

Dans une réservation d’entreprise, la personne de contact ne possède pas automatiquement le droit d’accès. C’est la personne effectivement inscrite qui compte. Nommez les places ouvertes à temps et vérifiez l’association individuelle au billet.

Enregistré, mais vue non actualisée

Si un message indiquant que les données d’accès n’ont pas été chargées apparaît après l’enregistrement, la modification peut déjà être enregistrée. Sélectionnez Actualiser et vérifiez la connexion existante avant de créer quoi que ce soit à nouveau. Un jeton nouvellement affiché doit être conservé en lieu sûr dès le premier enregistrement ; il ne s’affiche plus après le rechargement. Remplacez-le uniquement de manière ciblée s’il manque réellement, puis actualisez Comydo.

Exemple : entrée et sortie d’une salle d’entraînement

Une salle d’entraînement utilise une connexion et deux accès. Le lecteur d’entrée vérifie les créneaux confirmés de la salle avec une avance de 20 minutes et définit « Présent ». La sortie possède son propre lecteur, une règle adaptée avec délai après le créneau et définit l’état de sortie souhaité. L’équipe teste les deux sens avec la même personne confirmée ainsi qu’un créneau non réservé.