Démarrage rapide

Une intégration suit toujours le même parcours : votre ATS ouvre une session de configuration, le recruteur règle l’évaluation dans une iframe, puis vous assignez cette évaluation aux candidats. Skillee mène l’échange et renvoie le résultat à votre outil.

Avant de commencer

Il vous faut l’identifiant d’entreprise (company_id) que Skillee vous remet à l’activation : 32 caractères hexadécimaux, par exemple abc123def4567890abc123def4567890.

Les appels se font sur https://api-charlee2.skillee.ai. L’hôte historique https://api-charlie.skillee.ai sert la même application : une intégration existante n’a rien à changer.

Authentification

Chaque appel porte l’identifiant d’entreprise dans l’en-tête Authorization :

Authorization: Bearer abc123def4567890abc123def4567890

Certaines routes acceptent aussi company_id dans le corps ou en paramètre de requête. Quand l’identifiant est présent aux deux endroits, les deux valeurs doivent être identiques, sinon l’appel est refusé en 401. Une valeur qui n’est pas faite de 32 caractères hexadécimaux est refusée en 400.

Attention

L’identifiant d’entreprise est un secret : n’appelez l’API que depuis votre serveur, jamais depuis le navigateur du recruteur.

Le parcours

1. Ouvrir la session de configuration. Votre serveur envoie l’offre à Skillee et reçoit l’adresse de l’iframe. L’appel est idempotent : la même offre retombe toujours sur le même recrutement.

   curl https://api-charlee2.skillee.ai/partners/beetween/assessment-builder-sessions \
     -H "Authorization: Bearer $COMPANY_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "offerId": "OFFER-2026-001",
       "jobTitle": "Préparateur de commandes",
       "jobDescription": "CDI à Lyon, horaires de journée, cariste apprécié…"
     }'

   { "iframeUrl": "https://…" }

2. Afficher l’iframe. Le recruteur choisit l’agent, le canal et les questions, puis valide. L’iframe envoie alors à votre page l’identifiant de l’évaluation, le testId. Voir Iframe de configuration.

3. Enregistrer le testId avec l’offre dans votre ATS. Il désigne l’évaluation pour toutes les assignations à venir.

4. Assigner l’évaluation à un candidat. Skillee le contacte aussitôt.

   curl https://api-charlee2.skillee.ai/partners/beetween/assessments \
     -H "Authorization: Bearer $COMPANY_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "assessmentId": "<testId>",
       "applicant": {
         "firstName": "Marie",
         "lastName": "Dupont",
         "email": "marie.dupont@example.com",
         "phone": "+33612345678"
       },
       "recruiter": { "email": "recruteur@entreprise.fr" }
     }'

   { "id": "…" }

   Voir Assigner des candidats pour les lots, l’idempotence et les crédits.

Les résultats

Skillee renvoie à votre ATS l’avancement de chaque candidat : en attente, répondu (avec le score et le rapport) ou en échec (avec le motif). Ce retour passe par la connexion que notre équipe configure avec vous à l’activation ; il n’y a rien à interroger de votre côté.

Sans iframe

Si vous construisez votre propre écran de configuration, appelez directement POST /partners/charlee/v2/list/assessments pour lire les évaluations existantes d’une offre, puis POST /partners/charlee/v2/create/interview pour en créer ou en modifier une. La réponse de cette dernière porte l’interview_id, qui joue le rôle du testId. Les deux routes sont décrites dans la référence de l’API.

Pour aller plus loin

Iframe de configuration

Assigner des candidats

Codes d'erreur

Référence de l'API