1/ Création du module des modèles prédictifs
2/ Attacher le module PM au module Poste à Pourvoir
3/ Créer les champs de résultats au module Application
5/ Créer un Déclencheur de Webhook
6/ Activation de l’intégration
7/ Activation de l'intégration dans la marketplace AssessFirst
8/ Ajouter une variable AF Token
1/ Création du module des modèles prédictifs
Pour accueillir les modèles prédictifs AF, il faut créer un module custom
→ Aller dans Configuration -> Personnalisation -> Modules
→ Cliquer sur “Créer un module”
→ Entrer les “noms” du module avec les critères :
- Forme au pluriel : AssessFirst PMs
- Forme au singulier : AssessFirst PM
→ Configurer les champs du module en supprimant les champs inutiles et en ajoutant un champ “Une seule ligne” portant comme nom “Uuid”.
Récupérer le nom “technique” du module dans l’URL, une fois sur la page de gestion des champs. Ce nom sera à entrer lors de l'activation sur la marketplace AssessFirst (Etape 8). 
Dans notre cas, cela sera “CustomModule1”
2/ Attacher le module PM au module Poste à Pourvoir
Pour lier les modèles prédictifs AF au Jobs dans l’ATS
→ Aller dans Configuration / Personnalisation / Modules
→ Cliquer le module dans la liste “Postes à pourvoir”
→ Créer (en glisser-déposer) une nouvelle section “Assessfirst”
→ Ajouter dans cette nouvelle section un champ de type “Recherche” :
- Libellé du champ : AssessFirst Predictive Model
- Type de consultation : AssessFirst PMs (modèle précédemment créé)
- Titre de la liste : AssessFirst Predictive Model
→ Cliquer sur “Terminer”
→ Cliquer sur “Enregistrer la mise en page”
3/ Créer les champs de résultats au module Application
Pour permettre l'affichage des résultats AF d’un Candidat lors d’une candidature.
→ Aller dans Configuration -> Personnalisation -> Modules
→ Cliquer le module dans la liste “Applications”
→ Ajouter une nouvelle section “AssessFirst”
→ Ajouter les champs suivants (en respectant bien les noms des champs et la casse):
| Nom du champ | Type |
|---|---|
| SWIPE Score | Une seule ligne |
| SWIPE Report | URL |
| DRIVE Score | Une seule ligne |
| DRIVE Report | URL |
| BRAIN Score | Une seule ligne |
| BRAIN Report | URL |
| Adequacy Score | Une seule ligne |
| Adequacy Report | URL |
| A-Player Score | Une seule ligne |
| Results link | URL |
→ Cliquer sur “Enregistrer la mise en page”
4/ Créer un Webhook
Pour configurer les éléments du webhook AF à déclencher lors de l’invitation d’un candidat :
→ Aller dans Configuration -> Automatisation -> Action
→ Cliquer sur l’onglet “Webhooks”
→ Cliquer “Configurer Webhook” :
- Nom : Application - Assessfirst send Invite
- URL à notifier : [AFBaseURL]/integrations/zohorecruit/send-invitation
- [AFBaseURL] de production -> app.assessfirst.com
- [AFBaseURL] de test -> simu.assessfirst.com
- Méthode : Poster
- Type : Général
- Module : Applications
→ Ajouter les Paramètres URL suivants :
| Nom du paramètre | Type | Valeur |
|---|---|---|
| jobId | Postes à pourvoir | Id Poste à pourvoir |
| applicationStatus | Applications | Statut de l'application |
| requesterEmail | Utilisateurs | Adresse e-mail |
| requesterId | Postes à pourvoir | Id propriétaire Poste à pourvoir |
| candidateId | Candidats | Id Candidat |
| candidateLastname | Candidats | Nom |
| candidateFirstname | Candidats | Prenom |
| candidateEmail | Candidats | Adresse e-mail |
| applicationId | Applications | Id Application |
| AFToken | General | Assessfirst Token |
→ Cliquer sur “Enregistrer”
5/ Créer un Déclencheur de Webhook
Une fois le webhook créé, il est nécessaire de définir une règle de flux de travail précisant les critères de déclenchement.
→ Aller dans Configuration -> Automatisation -> Règles de flux de travail
→ Cliquer sur “Créer une règle” :
- Module : Applications
- Nom de la règle : Call AF Webhook
→ Créer la règle de déclenchement :
→ Gérer une éventuelle condition :
→ Ajouter une “Action instantanée” de type Webhook et sélectionner le Webhook précédemment créé :
→ Cliquer sur “Associer”
→ Cliquer sur “Enregistrer”
6/ Activation de l’intégration
⚠️ Avant de lancer l’activation chez AF, il faut générer un code OAuth sur Zoho qui n’est valable que 10 minutes 🕐
Pour générer le code Oauth sur Zoho :
→ Se connecter sur Zoho Developer Console
→ Cliquer sur “ADD CLIENT”
→ Choisir le type “Self Client”
⇒ Récupérer le Client ID et le Client Secret
→ Cliquer ensuite sur l’onglet “Generate Code”
⇒ Scope : ZohoRecruit.users.all,ZohoRecruit.org.all,ZohoRecruit.settings.all,ZohoRecruit.modules.all
⇒ Time Duration : 10 Minutes
⇒ Scope Description : AssessFirst App
⇒ Select Portal : Recruit + Organisation
=> Récupérer le Oauth code pour l’activation dans la marketplace AssessFirst.
7/ Activation de l'intégration dans la marketplace AssessFirst
Si vous êtes Administrateur et que vous disposez d'une licence API, vous allez pouvoir activer l'intégration dans la marketplace AssessFirst :
1. Cliquez sur l’icône en haut à droite pour accéder à vos paramètres et sélectionnez Intégrations
2. Cliquez sur Zoho
3. Cliquez sur activer
Entrer les paramètres suivant :
-> Client id : Client ID récupéré précédemment
-> Client secret : Client Secret récupéré précédemment
-> Zoho Account URL : par défaut https://accounts.zoho.eu (cf : https://www.zoho.com/recruit/developer-guide/apiv2/access-refresh.html)
-> Authorization code : Ouath code récupéré à la partie 7
-> Custom module value : Valeur récupérée à l'étape 1
-> Domain URL -> Par défaut https://recruit.zoho.eu
Lorsque vous validez, un token AssessFirst va être généré, vous devrez le coller dans Zoho pour finaliser l'intégration.
8/ Ajouter une variable AF Token
Pour ajouter le token d’identification AssessFirst :
→ Aller dans Configuration -> Espace Développeur -> Variables recruit
→ Cliquer “Créer une nouvelle variable” :
- Nom de la variable : Assessfirst Token
- Type : une seule ligne
- Valeur : Coller le token qui a été généré sur la marketplace AssessFirst
→ Cliquer sur “Enregistrer”
Pour savoir comment utiliser l'intégration avec Zoho, cliquez ici.