Comment activer l'intégration avec PinPoint ?

Dans l'application PinPoint

1/ Activation de l'intégration PinPoint API

2/ Création d'un webhook

Dans l'application AssessFirst

3/ Activation de PinPoint sur la marketplace

Dans l'application PinPoint

4/ Modifier l'url du webhook

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.