Comptes de services & Webhooks

Accédez à Configuration › Comptes de Service.

Cliquez sur Ajouter un compte de service.

Renseignez le nom du compte — utilisez un nom explicite identifiant le système externe (ex : « Banque A Compta »). Une adresse e-mail peut être ajoutée : elle est facultative et sert d'identifiant stable au compte pour les échanges entre serveurs.Convention : un compte par système externe. Ne jamais partager un compte entre plusieurs outils.

Validez. Le compte est créé mais pas encore exploitable — il faut ajouter une clé API (bloc suivant).

Ouvrez le compte de service créé précédemment.

Dans l’onglet Clés API, cliquez sur Ajouter une clé API.

Renseignez la Date de fin de validité : une échéance à trois mois est proposée par défaut. Pour une clé sans échéance, cochez Illimitée.Bonne pratique : aligner l’expiration sur l’année scolaire (ex : 1er septembre) pour forcer un renouvellement annuel.

Validez. La clé est affichée une seule fois. Copiez-la immédiatement et transmettez-la à l’équipe technique du système externe.⚠ Attention — Si la clé est perdue, il faudra en générer une nouvelle. L’ancienne ne peut pas être réaffichée.

Le système externe utilisera cette clé dans le header HTTP X-Lucius-Api-Key pour s’authentifier auprès de l’API Neil.

Ouvrez la section Droits d’accès de la fiche du compte de service.

Définissez le Scope : écoles, niveaux, années scolaires, matières auxquels le compte a accès.Principe du moindre privilège : ne donner accès qu’aux données strictement nécessaires.

Configurez les Permissions : sélectionnez dans l’arbre de droits uniquement les actions nécessaires (ex : lecture factures, lecture inscriptions).L’arbre est identique à celui des rôles utilisateurs (Rôles & droits d'accès). Un compte de service se configure exactement comme un profil humain.

Dans la même section, définissez si besoin une période d’autorisation (date de début / fin) pour limiter l’accès dans le temps.

Validez. Le compte est maintenant opérationnel avec un périmètre contrôlé.

Accédez à Configuration › Webhooks.

Cliquez sur Ajouter un webhook.

Renseignez le nom (ex : « Inscription → Banque A ») et une description.

Saisissez l’URL de destination fournie par le système externe (endpoint qui recevra les notifications).

Sélectionnez la méthode HTTP (POST dans la majorité des cas).

Ajoutez des headers HTTP si requis par le système destinataire (ex : clé d’authentification, Content-Type).Les headers permettent au système externe de vérifier que la requête vient bien de Neil.

Validez. Le webhook est créé mais aucun événement n’est encore sélectionné — il ne notifiera rien tant que vous n’en aurez pas choisi (bloc suivant).

Ouvrez le webhook créé précédemment.

Accédez à l’onglet Événements.

Parcourez les 413 événements regroupés par domaine (Configuration, Pédagogie, Scolarité, Marketing, RH, Comptabilité).

Cochez uniquement les événements pertinents pour le système destinataire.Ex. pour Banque A : secretariat.registrations.register_formula (nouvelle inscription) et accounting.invoices.create (nouvelle facture).

Validez. Le webhook commencera à envoyer des notifications en temps réel dès qu’un événement coché se produira.⚠ Vérification — Après la première notification, consultez les événements du webhook pour vérifier que le système externe répond correctement.

Ouvrez le compte de service ou le webhook concerné.

Utilisez l’action Activer ou Désactiver.Désactiver un compte de service coupe immédiatement l’accès API du système externe — sans supprimer la configuration.

Pour les clés API individuelles, la même logique s’applique : vous pouvez désactiver une clé sans supprimer le compte.Utile lors d’un renouvellement de clé : créez la nouvelle, transmettez-la, puis désactivez l’ancienne.