Dans l'application PinPoint
1/ Activation de l'intégration PinPoint API
Dans l'application AssessFirst
3/ Activation de PinPoint sur la marketplace
Dans l'application PinPoint
1/ Activation de l'intégration PinPoint API
Dans PinPoint, Il va falloir activer l'intégration PinPoint API.
Allez dans, PinPoint -> Settings -> Integration -> Apps et activer l'intégration PinPoint API
Cliquer sur add et remplissez les champs suivant :
Name : AssessFirst
Permission à ajouter en Write en Read :
- Application
- Candidate
- Comment
- Custom Attributes
- Job
- User
- Customer Field (Read + Write + Delete)
Une fois la clé API créée, vous pouvez la récupérer, vous aurez ensuite besoin de l'ajouter dans la marketplace AssessFirst.
2/ Création d'un webhook
Dans PinPoint, Allez dans company -> Profile -> Webhooks
Cliquez sur le bouton -> Nouveau webhook
Créer le webhook avec l'url suivante -> https://app.assessfirst.com/integrations/webhook/pinpoint
Copiez le Singning Secret que vous devrez copier dans la marketplace AssessFirst et cochez l'un des 2 événements suivant :
- New application ou Application stage changed
2 possibilités :
- Vous souhaitez déclencher l'invitation d'un candidat dès qu'il postule à une offre que vous aurez sélectionné -> Cochez uniquement "New application"
- Vous souhaitez déclencher l'invitation sur un statut spécifique pour une offre que vous aurez sélectionné -> Cochez uniquement "Application stage changed"
3/ Activation de PinPoint sur la marketpalce
Dans l'application AssessFirst, si vous êtes Administrateur et que vous disposez d'une licence API, il vous est dorénavant possible de générer votre token API simplement, en suivant cette démarche via la marketplace :
1. Cliquez sur l’icône en haut à droite pour accéder à vos paramètres et sélectionnez Intégrations
2. Cliquez sur PinPoint
3. Cliquez sur Générer un token
Les champs à remplir :
- Tenant ID et sous domaine (ex : https://assess-first-sandbox.pinpointhq.com/admin)
- API key : Clé API récupérée dans la 1ère étape
- Signature secrète du webhook : Clé secrète récupérée à la 2ème étape
- Statut :
Si à l'étape 2, vous avez chochez :
- New application : Laisser la case vide
- Application stage changed - > Alors copier/coller le nom du statut sur laquelle vous voulez que l'invitation se déclenche sur PinPoint
Coller le nom exact du statut dans la case (Exemple "Phone Screen")
Une fois tous les champs remplis, vous pouvez valider, vous aurez une url qui va s'afficher, exemple "https://simu.assessfirst.com/integrations/webhook/pinpoint?company_uuid=0bf7cb0aa2734be5988035a794272cd4". Copiez cette url pour l'ajouter dans PinPoint (Etape 4)
4/ Modifier l'url du webhook
Dans PinPoint, retournez dans la partie Webhook et modifiez l'url du Webhook AssesFirst que vous aviez précédement créé.
Collez l'url que vous avez copié à l'étape 3.
Pour apprendre comment utiliser l'intégration avec PinPoint, cliquez ici.