API MentivisOS

MentivisOS expose une API RESTful qui permet d'intégrer ses fonctionnalités de formation adaptative, de gestion des compétences et de certification dans vos outils existants.

L'API couvre : - La gestion des apprenants (création, mise à jour, synchronisation) - Les parcours de formation adaptatifs et leur déclenchement - Le suivi des progressions et des résultats - La délivrance de certificats et badges - L'export des données de compétences vers vos systèmes cibles

L'API est accessible à l'adresse : https://api.mentivisos.com/v1

Authentification

Toutes les requêtes API nécessitent un jeton d'accès (Bearer token) inclus dans l'en-tête Authorization :

Authorization: Bearer <votre_clé_api>

Les clés API sont disponibles depuis votre tableau de bord MentivisOS, rubrique "Développeurs" > "Clés API".

Taux de limites

• 1000 requêtes / heure pour le plan Essential
• 5000 requêtes / heure pour le plan Business
• 20 000 requêtes / heure pour le plan Enterprise

Encodage

Toutes les requêtes et réponses utilisent JSON. Veillez à définir l'en-tête Content-Type: application/json.

Idempotence

Les requêtes de création peuvent inclure un en-tête Idempotency-Key pour éviter les doublons en cas de rejeu.

L'intégration avec les ATS (Applicant Tracking Systems) permet de synchroniser les données de formation directement dans le parcours candidat.

Taleez

Taleez est un ATS collaboratif français adopté par les PME et ETI. L'intégration avec MentivisOS permet : - Création automatique d'un parcours de formation adaptatif lorsqu'un candidat atteint un certain statut (ex: "Entretien validé") - Envoi des résultats de formation vers le profil candidat Taleez via l'API REST de Taleez - Synchronisation des compétences évaluées dans le référentiel MentivisOS vers les champs personnalisés Taleez

Flatchr

Flatchr propose des fonctionnalités d'IA générative et de multidiffusion. L'intégration MentivisOS : - Déclenche des modules de pré-embauche (onboarding anticipé) via webhook - Remonte les taux de complétion et les scores dans le tableau de bord Flatchr - Alimente le scoring des candidats avec les résultats des évaluations MentivisOS

JobAffinity

JobAffinity est un ATS pour TPE/PME et administrations. L'intégration : - Carte mentale des compétences synchronisée entre les deux outils - Import automatique des candidats depuis JobAffinity vers un parcours de pré-qualification - Export du passeport compétences vers le dossier candidat

HelloWork Recruteur

HelloWork Recruteur (anciennement App Recruteur) est le 1er acteur privé français de l'emploi. - Publication d'offres jumelée à un lien vers un parcours de découverte MentivisOS - Réception des résultats des assessments directement dans la base candidats - Enrichissement du CV avec les compétences validées via MentivisOS

L'intégration avec les SIRH permet de maintenir un référentiel compétences à jour et de piloter la formation depuis l'outil RH central.

Eurécia

Eurécia propose une suite RH complète avec module ATS, onboarding et gestion des talents. - Synchronisation du référentiel de compétences entre Eurécia et MentivisOS - Déclenchement automatique de parcours après l'entretien professionnel - Remontée des formations suivies dans le dossier collaborateur Eurécia

Empowill

Empowill est un logiciel RH spécialisé dans la gestion des talents en PME/ETI. - Plans de développement synchronisés avec les parcours MentivisOS - Suivi des certifications obligatoires dans le tableau de bord Empowill - Import des évaluations de compétences post-formation

Kelio

Kelio est un SIRH complet utilisé par les ETI et grands comptes. - Export des données de formation vers Kelio pour la gestion administrative - Synchronisation des plannings de formation via API - Remontée des heures de formation dans le DIF/CPF

Sage RH

Sage RH est déployé dans plus de 40 000 entreprises en France. - Connecteur dédié pour l'échange de données de formation - Synchronisation automatique des collaborateurs et de leur matricule - Alimentation du plan de développement des compétences

Personio

Personio est un SIRH adopté par les PME en hypercroissance. - Intégration via API REST pour la création et mise à jour des profils - Synchronisation des attributs personnalisés (compétences, certifications) - Workflow automatisé déclenchant un parcours d'intégration dès l'embauche

Pennylane est une plateforme française de gestion financière tout-en-un : facturation, comptabilité, trésorerie, notes de frais et paie.

L'intégration entre MentivisOS et Pennylane permet d'automatiser le volet financier de la formation :

Facturation des formations

• Les sessions de formation validées génèrent automatiquement une facture client dans Pennylane via l'API Company
• Synchronisation des produits et tarifs de formation (catalogue MentivisOS → base produits Pennylane)
• Rattachement des factures aux bons de commande et devis signés

Suivi des coûts

• Les coûts pédagogiques (formateurs, plateforme, ressources) sont synchronisés dans les écritures comptables
• Les notes de frais des formateurs importées depuis Pennylane sont rattachées aux sessions de formation
• Tableaux de bord analytiques : coût par apprenant, par module, par département

Certification OAuth 2.0

• L'intégration utilise le flux OAuth 2.0 Pennylane (Company API)
• Un sandbox de test est disponible dans votre espace Pennylane
• Les webhooks Pennylane notifient MentivisOS des changements de statut de facture (payée, impayée, envoyée)

Référence technique

API Pennylane v2 : https://pennylane.readme.io/ Endpoints clés : /api/external/v2/customer_invoices, /api/external/v2/products, /api/external/v2/changelogs/customer_invoices

Les webhooks permettent à MentivisOS de notifier vos systèmes en temps réel lors d'événements clés.

Événements disponibles

• learning_path.completed — Un apprenant a terminé un parcours
• assessment.passed — Une évaluation a été réussie
• certificate.issued — Un certificat a été délivré
• learner.enrolled — Un apprenant a été inscrit à un parcours
• learner.skill_updated — Les compétences d'un apprenant ont été mises à jour

Configuration

Les webhooks sont configurables depuis le tableau de bord MentivisOS : 1. Rubrique "Développeurs" > "Webhooks" 2. Ajoutez l'URL de votre endpoint 3. Sélectionnez les événements à écouter 4. Validez avec le handshake de vérification

Signature

Chaque payload est signé avec HMAC-SHA256. L'en-tête X-Mentivis-Signature contient la signature à vérifier avec votre secret partagé.

Réponse attendue

Votre endpoint doit répondre en 2 secondes maximum avec un code HTTP 200. En cas d'échec, MentivisOS effectue jusqu'à 5 tentatives avec backoff exponentiel.

Un environnement de test est disponible pour valider vos intégrations sans impacter la production.

Environnement sandbox

URL de l'API : https://sandbox-api.mentivisos.com/v1 Les données sont réinitialisées chaque semaine.

Création d'un compte sandbox

1. Depuis votre tableau de bord MentivisOS, rubrique "Développeurs" 2. Cliquez sur "Créer un environnement de test" 3. Générez une clé API sandbox distincte de votre clé de production 4. Utilisez les données de démonstration préchargées (apprenants, parcours, modules)

Scénarios de test recommandés

• Création d'un apprenant → inscription à un parcours → suivi de progression
• Simulation d'un webhook entrant depuis votre ATS
• Synchronisation des compétences vers votre SIRH
• Génération de facture de formation vers Pennylane

Limitations sandbox

• 500 requêtes / heure
• Pas d'envoi d'emails réels
• Les webhooks sont simulés (consultables dans les logs)
• Les certificats générés portent la mention "TEST"