Intégrations
API et webhooks
L’écran API et intégrations relie InTeach à vos autres outils : SIRH, portail RH, outil de reporting, automate. Vous y créez les accès techniques ; le développement se fait ensuite avec la documentation développeur.
Avant de commencer
- Le module API et intégrations est actif pour votre organisation.
- Vous êtes administrateur et travaillez dans l’espace Expert : l’écran est dans la barre latérale, entrée API et intégrations.

(1) Adresses de l’API, (2) onglets, (3) Nouveau client.
Créer un client pour l’API
- Onglet Clients OAuth, cliquez sur Nouveau client.
- Saisissez un Nom et une Description qui disent à quoi il sert (« Synchronisation SIRH », par exemple).
- Choisissez l’Usage API publique, si la question est posée.
- Cochez les Autorisations strictement nécessaires, par exemple Lire les utilisateurs et Créer des apprenants.
- Laissez URI de redirection vide pour une intégration sans utilisateur.
- Cliquez sur Créer le client. Copiez le secret, rangez-le dans un coffre de secrets, cochez « J’ai copié le secret et je l’ai rangé en lieu sûr », puis Terminer.
Transmettez l’identifiant et le secret au développeur par un canal sûr, jamais par e-mail en clair. Il commence par le guide de démarrage.
Le menu de chaque client propose Modifier, Renouveler le secret (l’ancien reste valable de 0 à 168 heures, 24 heures par défaut), Révoquer ce secret et Révoquer le client, définitivement.
Recevoir des événements par webhook
- Onglet Webhooks, cliquez sur Nouvel abonnement.
- Saisissez l’URL de destination, en HTTPS, fournie par l’outil qui reçoit les événements.
- Cochez les Événements : une inscription créée (
enrollment.created.v1), une activité terminée (activity.completed.v1). - Cliquez sur Créer l’abonnement et transmettez le secret de signature au développeur.
- Cliquez sur Envoyer un test et vérifiez la réception dans Voir les livraisons.

(1) Nouvel abonnement.
InTeach réessaie une livraison échouée pendant environ deux heures. Après 15 échecs consécutifs, l’abonnement est désactivé : corrigez la destination puis cliquez sur Réactiver.
Surveiller les appels
L’onglet Journal des appels liste les appels reçus par l’API pendant 90 jours. Un client qui n’apparaît plus dans le journal ne sert sans doute plus : révoquez-le.
En cas de problème
| Message | Cause et solution |
|---|---|
| Le module « API et intégrations » n’est pas actif | Demandez son activation à votre interlocuteur InTeach |
| Choisissez au moins une autorisation | Cochez au moins une autorisation |
| L’URL doit commencer par https:// | Les webhooks n’acceptent que des destinations HTTPS publiques |
| L’abonnement s’est désactivé seul | La destination a échoué 15 fois de suite ou a répondu 410 |