Connecter ses outils

L’onglet Paramètres → Intégrations s’adresse aux personnes chargées des échanges avec les autres outils du CFA. Faites préciser le besoin et les données nécessaires avant de créer un accès.

VOIR LES GESTES3 étapes · à votre rythme

Lancez la lecture, faites une pause ou ouvrez les repères numérotés. « Voir en grand » ouvre le parcours dans un lecteur plus large, même si le navigateur refuse le plein écran. Les actions montrées utilisent des données de démonstration.

Lire les 3 étapes sans le lecteur

1. Identifier les échanges existants

   Consultez les outils connectés, les droits et le journal avant d’ajouter un nouvel accès.

   Un usage précis par accès. Faites définir les données nécessaires avec votre interlocuteur technique.

2. Définir une clé de lecture

   Donnez un nom reconnaissable puis choisissez uniquement les droits utiles. La valeur du secret ne doit jamais apparaître dans un guide.

   Limiter le périmètre. La création d’un accès réel nécessite la vérification des droits et du destinataire.

3. Préparer les événements sortants

   Renseignez l’adresse du destinataire et les événements utiles. Contrôlez ensuite la réception dans le journal.

   Vérifier le destinataire. Cette démonstration ne crée aucun webhook et ne transmet aucune donnée.

Ce chapitre est le seul du guide à employer le vocabulaire technique de l’écran. Une API est le moyen utilisé par deux logiciels pour échanger des données selon un accès défini. Un webhook est un message envoyé à un outil destinataire lorsqu’un événement sélectionné survient.

Créer une clé de lecture

1. Ouvrez la section des clés API.
2. Choisissez la création d’une clé et donnez-lui un nom reconnaissable, lié à son usage.
3. Sélectionnez uniquement les droits nécessaires au besoin.
4. Vérifiez le périmètre avant de créer l’accès.
5. Copiez la valeur dans le moyen de stockage prévu pour les secrets de votre organisation : elle n’est affichée qu’une fois.

Ces clés servent à la lecture. Ne les copiez pas dans une documentation publique, une capture, un e-mail ordinaire ou un ticket d’assistance. Si vous perdez une valeur, sa régénération invalide l’ancienne : prévoyez la mise à jour de l’outil qui l’utilise.

Révoquer désactive définitivement la clé concernée. Vérifiez le nom et les usages avant de confirmer.

Déclarer un webhook

Un webhook prévient un outil externe lorsqu’un événement choisi se produit. Préparez l’adresse publique du système destinataire avec la personne qui l’administre.

Renseignez l’URL, sélectionnez les événements utiles et vérifiez le destinataire. Les événements proposés couvrent l’accord OPCO, le rejet, la facture payée et la création d’un apprenti. Le secret fourni à la création sert au contrôle des messages par le destinataire.

Après activation, consultez le journal des appels pour distinguer une configuration enregistrée d’une réception effective. Une suspension ou une désactivation peut laisser des événements non transmis ; leur réactivation ne rejoue pas automatiquement les événements perdus.

Modifier ou arrêter un échange

Vérifiez les outils consommateurs avant de changer une URL ou une sélection d’événements. L’écran ne propose pas de rotation du secret d’un webhook existant. Après modification, contrôlez un nouvel événement attendu dans le journal et auprès du destinataire. Pour arrêter un échange, utilisez les commandes de désactivation ou de suppression appropriées, après vérification des dépendances.

Le guide montre les écrans sans créer de clé ni transmettre de secret. La configuration de l’outil externe et le développement de son traitement relèvent de votre interlocuteur technique.