À la fin de chaque cours, MeetingHub arrête une feuille de présence : qui était là, combien de temps, avec quelles coupures. Votre système peut la récupérer pour la verser dans son propre dossier, ou l'envoyer au financeur au titre de l'émargement. Chaque champ est détaillé dans la référence : Feuilles de présence.
Il faut une clé de portée attendance:read. Dans les adresses ci-dessous, :institutionId est l'identifiant de votre établissement, rendu par GET /api/me.
La boucle complète
- Vous posez un webhook abonné à
attendance.closed. Voir Webhooks. - À la fin d'un cours, MeetingHub arrête la feuille et appelle votre webhook. L'appel porte l'identifiant du cours dans
sessionId. - Votre système récupère la feuille avec cet identifiant, le
:lessonId:GET /api/institutions/:institutionId/lessons/:lessonId/attendance.csv. - Il la verse dans votre système, et archive son code de vérification avec elle.
Le webhook ne contient pas la feuille elle-même : une liste de quatre cents noms n'a pas sa place dans une notification, et elle voyagerait à chaque réessai.
Quand la feuille est prête
La feuille est arrêtée automatiquement une fois la salle fermée — au plus tard 15 minutes après la fermeture — ou plus tôt, à la main, depuis MeetingHub ou par POST …/lessons/:lessonId/attendance/close avec une clé de portée schedule:write. Elle ne change plus ensuite.
Si vous appelez trop tôt, la réponse est 409 : aucune feuille n'existe encore pour ce cours. Attendez le webhook plutôt que de réessayer en boucle.
Un cours sans classe et sans aucun participant n'a pas de feuille : il n'y a personne à relever, et aucun webhook n'est envoyé pour lui.
Trois formats
| Route | Format | Pour quoi faire |
|---|---|---|
…/attendance | JSON | L'intégrer dans votre système, champ par champ |
…/attendance.csv | CSV | L'ouvrir dans un tableur, ou l'archiver telle quelle |
…/attendance.html | Page à imprimer | L'imprimer, ou l'enregistrer en PDF, pour un visa manuscrit |
Le CSV s'ouvre directement dans Excel en français : séparateur point-virgule, accents intacts. Les heures y sont en UTC.
Ce qu'une feuille contient
Pour le cours : la salle, la classe, le centre, l'heure et la durée prévues, l'effectif attendu et le nombre de personnes venues.
Pour chaque personne venue : son nom et son adresse, sa première entrée et sa dernière sortie, son temps de présence, le nombre de coupures d'au moins une minute, et la qualité de réception qu'elle a vécue. Une personne connectée plusieurs fois n'a qu'une ligne.
Le code de vérification
Chaque feuille porte un code de vérification, calculé par MeetingHub au moment où elle est arrêtée. Il permet de prouver, des mois plus tard, que la feuille n'a pas été modifiée. Archivez-le avec la feuille : il figure dans le JSON (champ signature), en bas de la page à imprimer, et dans l'en-tête du CSV.
Un financeur peut le contrôler lui-même, sans compte, sur la page /verification de votre instance : elle dit si la feuille est authentique ou si elle a été modifiée.