Aller au contenu principal

Développeurs : clés API, webhooks et intégrations

La page Organisation > Développeurs regroupe tout ce qui permet de connecter RecrutAuto à votre système d'information.

Clés API d'organisation

Les clés API permettent d'appeler l'API REST et le serveur MCP au nom de l'organisation :

  • format : ra_live_… (production), ra_test_… (test) et ra_scim_… (clé de provisioning SCIM — voir SSO et SCIM) ;
  • la clé n'est affichée qu'une seule fois à la création — stockez-la dans votre gestionnaire de secrets ;
  • chaque clé peut être révoquée indépendamment ;
  • disponibilité : 1 clé en Business, illimitées en Enterprise.

Pour un usage individuel (scripts personnels, connecteur MCP), préférez les jetons personnels.

Webhooks sortants — Business et Enterprise

Les webhooks notifient votre SI en temps réel (candidat qualifié, réponse reçue, rendez-vous planifié…) :

  1. Depuis Organisation > Développeurs, ajoutez une URL de webhook
  2. Sélectionnez les événements à recevoir
  3. Vérifiez la signature avant de traiter chaque livraison : l'en-tête X-RecrutAuto-Signature vaut t=<timestamp>,v1=<signature> ; la signature est le HMAC-SHA256, avec votre secret, de la chaîne "{timestamp}.{corps JSON}". Rejetez les livraisons dont l'horodatage est trop ancien (fenêtre de fraîcheur).
  4. Les échecs sont réessayés 5 fois avec un délai croissant (de 1 minute à 12 heures) ; les livraisons sont consultables depuis la page

Intégrations Slack et Microsoft Teams — Business et Enterprise

Recevez les notifications de l'organisation (réponses de candidats, entretiens planifiés…) directement dans un canal :

  1. Organisation > Développeurs > Intégrations
  2. Choisissez Slack ou Teams et suivez l'autorisation OAuth
  3. Sélectionnez le canal de destination et les types d'événements
info

Les intégrations ATS (BoondManager, Greenhouse, Lever…) restent configurées par recruteur — voir Intégrations ATS.