API pour partenaires ATS

Votre ATS envoie une candidature à Omogen. Omogen contacte le candidat, mène l'entretien, puis appelle votre URL avec le résultat.

L'essentiel

Quoi	Valeur
URL de l'API	https://api.omogen.ai/api/v1/integration-partner
Authentification	Authorization: Bearer <clé API> et OM-PARTNER: <clé partenaire>
Envoyer une candidature	POST /applications
Recevoir le résultat	l'événement report_generated sur votre URL

Mise en place en 4 étapes

1. Créer l'intégration

Dans Omogen, ouvrez Intégrations, cliquez sur Ajouter une intégration, puis choisissez API personnalisée. Une seule information est demandée : l'URL qui recevra les résultats.

2. Copier vos clés

Omogen génère vos deux clés à la création. Copiez-les depuis la section Connexion : vous les retrouverez à tout moment dans la fiche de l'intégration.

3. Régler et tester la réception des résultats

Dans la section Webhooks, ajoutez l'en-tête que votre URL attend (souvent x-api-key) et une adresse à prévenir si votre URL ne répond plus. Cliquez ensuite sur Envoyer un webhook de test : Omogen appelle votre URL et affiche sa réponse.

Le test n'envoie aucune donnée candidat

Votre URL reçoit {"event_type": "test", "timestamp": "…", "message": "…"}. Répondez 2xx et ignorez-le. Enregistrez vos modifications avant de tester : le test utilise la configuration enregistrée.

4. Envoyer une première candidature

Chaque candidature désigne son offre par son ID API. Copiez-le depuis la liste des offres (menu ⋯ → Copier l'ID API), ou récupérez tous les ID avec GET /jobs.

curl -X POST https://api.omogen.ai/api/v1/integration-partner/applications \
  -H "Authorization: Bearer <clé API>" \
  -H "OM-PARTNER: <clé partenaire>" \
  -H "Content-Type: application/json" \
  -d '{
    "external_application_id": "APP-456",
    "external_candidate_id": "CAND-789",
    "job_opportunity_id": "550e8400-e29b-41d4-a716-446655440000",
    "first_name": "Marie",
    "last_name": "Dubois",
    "phone": "+33612345678",
    "email": "marie.dubois@example.com"
  }'

Omogen répond 201 avec le process_id de l'entretien lancé. À la fin de l'entretien, votre URL reçoit le résultat : voir Recevoir les résultats.

Et ensuite

Vous voulez…	Page
Lire le résultat d'un entretien, gérer les échecs d'envoi, utiliser OAuth 2.0	Recevoir les résultats
Envoyer vos propres ID d'offres plutôt que ceux d'Omogen	Associer les candidatures aux offres
Connaître tous les champs, codes d'erreur et variables candidat	Référence

Lien d'invitation candidat

Avec un mode par invitation, le candidat choisit lui-même son créneau. La réponse à POST /applications contient alors son lien dans data.invitation_link.

deployment_template	Omogen envoie le lien par
email-invitation	email
sms-invitation	SMS
whatsapp-invitation	WhatsApp
invitation-link-only	rien : vous affichez le lien vous-même

Pour les modes à appel direct (single-call, sms-then-call, 3-days…), invitation_link vaut null. GET /interview-params liste les modes disponibles pour votre organisation.

Une question ?

gillian@omogen.ai