Utiliser mon site carrière pour diffuser mes annonces
Lorsque vous diffusez une offre sur des jobboards depuis Nicoka, le candidat qui veut postuler est redirigé par défaut vers la page de l'offre sur votre site carrière Nicoka. Si vos offres sont publiées sur votre propre site web, vous pouvez rediriger les candidats vers la page de l'offre sur votre site. Voici la procédure.
1. Les prérequis : l'intégration par l'API
Votre site web doit être relié à Nicoka par l'API : il récupère les offres depuis Nicoka et renvoie les candidatures dans votre espace Nicoka. Cette intégration est réalisée par la personne qui gère votre site web (votre webmaster), à partir de la documentation de l'API : https://api.nicoka.com/.
Les points d'accès (« endpoints ») à utiliser :
- /jobs : récupère les offres d'emploi de votre espace Nicoka ;
- /jobs/apply : crée la candidature du candidat sur l'offre, directement dans votre espace Nicoka ;
- /jobs/openApplicationApply : crée une candidature spontanée (facultatif, si votre site en propose).
Les deux points d'accès de candidature n'acceptent que des envois de formulaire (méthode POST).
2. L'adresse de chaque offre sur votre site
Pour rediriger les candidats, Nicoka reconstruit automatiquement l'adresse de chaque offre sur votre site, à partir d'un modèle d'adresse propre à votre site. Ainsi, chaque annonce diffusée sur un jobboard pointe vers la bonne page.
Pour que chaque adresse corresponde à une seule offre, elle doit contenir au moins un identifiant unique et stable de l'offre :
- l'identifiant unique du job (uid) : une valeur générée automatiquement par Nicoka, toujours unique ;
- l'identifiant du job (id) : le numéro interne du job dans Nicoka ;
- la référence du job (référence) : le code que vous saisissez vous-même sur le job, à condition qu'il soit unique.
Le libellé du job peut compléter l'adresse, mais il ne suffit pas seul : deux offres peuvent porter le même libellé, et un libellé peut changer.
Exemple : https://www.mon-domaine.fr/offres/1234-chef-de-projet, où 1234 est l'identifiant du job.
3. Contacter le support
Une fois l'intégration API terminée, contactez l'équipe support à support@nicoka.com en lui indiquant l'adresse des offres sur votre site et la façon dont elle est construite. Le support règle le modèle d'adresse de votre espace et active la redirection vers votre site ; vous pouvez ensuite diffuser vos offres.