Webhook d'emploi
L’intégration webhook d’emploi permet à Nextal d’envoyer les données d’emploi à n’importe quel point d’accès HTTP externe dès qu’un événement d’emploi se produit. C’est ainsi que les équipes maintiennent un site Web externe, une couche d’intégration ATS ou un entrepôt de données synchronisés avec les offres d’emploi Nextal — sans interrogation. Vous contrôlez l’URL cible, la méthode d’authentification des requêtes et, optionnellement, la structure de la charge utile.
Ce que ça fait
- Envoie une requête HTTP à votre point d’accès lorsque des données d’emploi changent.
- Prend en charge cinq modes d’authentification : Aucune, Authentification de base, Jeton Bearer, JWT et Clé API.
- Par défaut, envoie l’objet emploi complet de Nextal. Optionnellement, permet une correspondance de champs personnalisée pour remodeler la charge utile selon le schéma attendu par votre point d’accès.
- Accepte un chemin d’identifiant de réponse pour que Nextal puisse extraire et stocker l’identifiant du système externe à partir de la réponse.
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 Job Webhook Sync.
- Cliquez sur Modifier pour ouvrir le panneau de configuration.
- Cochez Activer Job Webhook Sync.
- 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 — une expression de chemin JSON (ex.
$.data.id) pointant vers l’identifiant unique dans la réponse du point d’accès. - 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 de charge utile personnalisée, cochez Utiliser la correspondance de champs personnalisée et associez les champs d’emploi standard aux chemins JSON attendus. Vous pouvez également ajouter des champs personnalisés pour injecter des valeurs fixes à des chemins arbitraires.
- Cliquez sur Enregistrer.
Paramètres
Paramètres principaux
| Paramètre | Description |
|---|---|
| Activer Job Webhook Sync | Interrupteur principal de l’intégration. |
| URL du webhook | Le point d’accès HTTPS qui reçoit les données d’emploi. Obligatoire. |
| Chemin d’identifiant de réponse | Une expression de chemin JSON pour extraire l’identifiant externe du corps de la réponse (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 du jeton. |
| Clé API | Nom de la clé (ex. X-API-Key), 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 d’emploi Nextal aux chemins JSON attendus par votre point d’accès :
| Champ Nextal | Exemple de chemin cible |
|---|---|
| id | $.job.id |
| title | $.job.title |
| shortDescription | $.job.description |
| fullDescription | $.job.fullDescription |
| location | $.job.location |
| minSalary | $.job.salary.min |
| maxSalary | $.job.salary.max |
| contractType | $.job.contractType |
| language | $.job.language |
| jobPublicURL | $.job.jobPublicURL |
| jobApplicationPublicURL | $.job.jobApplicationPublicURL |
| featurePhoto | $.job.featurePhoto |
Vous pouvez également ajouter des champs personnalisés pour injecter des valeurs statiques à n’importe quel chemin JSON de la charge utile (par exemple, définir $.source à nextal).
Conseils
- Utilisez HTTPS. Les charges utiles d’emploi peuvent contenir des données salariales et d’autres informations sensibles — utilisez toujours un point d’accès sécurisé.
- Commencez sans correspondance de champs personnalisée. La charge utile par défaut est un objet emploi complet avec lequel la plupart des intégrations peuvent travailler directement.
- Utilisez le chemin d’identifiant de réponse lorsque votre point d’accès attribue ses propres identifiants. Cela permet à Nextal d’envoyer le bon identifiant lors des mises à jour ultérieures.
- Les jetons JWT sont générés par requête. Chaque appel webhook sortant génère un nouveau JWT signé avec le secret et l’algorithme configurés.