Webhook candidat embauché
Le webhook candidat embauché envoie une requête HTTP à un point d’accès externe au moment où le statut d’un candidat dans Nextal passe à embauché. C’est la manière standard de déclencher des flux de travail en aval — créer un dossier d’employé dans un SIRH, lancer l’intégration dans un système tiers, ou mettre à jour un entrepôt de données — sans saisie manuelle.
Ce que ça fait
- Envoie un HTTP POST à votre point d’accès lorsqu’un candidat est marqué comme embauché dans Nextal.
- Prend en charge cinq modes d’authentification : Aucune, Authentification de base, Jeton Bearer, JWT et Clé API.
- Par défaut, envoie l’objet candidat complet. Optionnellement, permet une correspondance de champs personnalisée pour remodeler la charge utile.
- Accepte un chemin d’identifiant de réponse pour que Nextal puisse extraire et stocker l’identifiant du système externe.
Prérequis
- Un point d’accès HTTP (HTTPS fortement recommandé) capable de recevoir des requêtes POST.
- Les identifiants d’authentification pour ce point d’accès, selon le mode requis.
Comment activer
- Accédez à Administration → Intégrations et repérez la fiche Candidate Hired Webhook.
- Cliquez sur Modifier pour ouvrir le panneau de configuration.
- Cochez Activer le webhook candidat embauché.
- Saisissez l’URL du webhook — l’URL HTTPS complète de votre point d’accès.
- Optionnellement, saisissez un chemin d’identifiant de réponse (ex.
$.data.id). - Choisissez un type d’authentification et remplissez les champs correspondants (voir Paramètres ci-dessous).
- Si votre point d’accès nécessite une structure spécifique, cochez Utiliser la correspondance de champs personnalisée et associez les champs candidat aux chemins JSON attendus. Vous pouvez également ajouter des champs personnalisés pour injecter des valeurs fixes.
- Cliquez sur Enregistrer.
Paramètres
Paramètres principaux
| Paramètre | Description |
|---|---|
| Activer le webhook candidat embauché | Interrupteur principal de l’intégration. |
| URL du webhook | Le point d’accès HTTPS qui reçoit les données du candidat lors d’un événement d’embauche. Obligatoire. |
| Chemin d’identifiant de réponse | Une expression de chemin JSON pour extraire l’identifiant du système externe (ex. $.data.id). Optionnel. |
Authentification
| Type d’authentification | Champs requis |
|---|---|
| Aucune | Aucun identifiant. |
| Authentification de base | Nom d’utilisateur et mot de passe. |
| Jeton Bearer | Valeur du jeton. |
| JWT | Algorithme (HS256 / HS384 / HS512 / RS256 / RS384 / RS512), secret JWT, et optionnellement une charge utile JSON pour les revendications. |
| Clé API | Nom de la clé, valeur de la clé et emplacement (en-tête ou paramètre de requête). |
Correspondance de champs (optionnelle)
Lorsque Utiliser la correspondance de champs personnalisée est activé, vous pouvez associer les champs candidat Nextal aux chemins JSON attendus :
| Champ Nextal | Exemple de chemin cible |
|---|---|
| firstName | $.candidate.firstName |
| lastName | $.candidate.lastName |
$.candidate.email | |
| phone | $.candidate.phone |
Vous pouvez également ajouter des champs personnalisés pour injecter des valeurs statiques (par exemple, définir $.event à hired).
Conseils
- Utilisez HTTPS. Les charges utiles candidat contiennent des informations personnelles — utilisez toujours un point d’accès sécurisé et authentifié.
- Commencez sans correspondance personnalisée. La charge utile par défaut est l’objet candidat complet, suffisant pour la plupart des intégrations.
- Utilisez le chemin d’identifiant de réponse lors de la création de dossiers dans un SIRH externe. Si le système en aval crée un dossier d’employé et retourne son identifiant, le stocker dans Nextal permet de référencer le bon dossier lors des mises à jour futures.
- Ce webhook se déclenche une fois par événement d’embauche. Si vous devez mettre à jour un candidat déjà embauché dans le système externe, un mécanisme séparé sera nécessaire.
- Testez avec un candidat non-production en premier. Créez un candidat test, marquez-le comme embauché et vérifiez que la charge utile atteint correctement votre point d’accès.