Passer au contenu principal
Toutes les collectionsIntégrationsIntégrations de recrutementSAP SuccessFactors ATS
Instructions d'intégration SAP SuccessFactors – Module de recrutement
Instructions d'intégration SAP SuccessFactors – Module de recrutement
Sam Abello avatar
Écrit par Sam Abello
Mis à jour cette semaine

Champ d'application

La plateforme d'embauche à haut volume de Grayscale est conçue pour aider les recruteurs à rationaliser et automatiser une expérience candidat de haut niveau à l'échelle.La plateforme de recrutement conversationnelle de Grayscale facilite l'échange de textos avec les candidats depuis SAP SuccessFactors, tout en automatisant les tâches répétitives du processus d'embauche.Ce document décrit l'étendue des travaux pour mettre en œuvre notre solution dans votre ATS.


Étapes d'intégration

    1. Activer la synchronisation des transcriptions

    2. Ajouter une question de consentement SMS

    1. URL du serveur API

    2. Nom d'utilisateur SAP SuccessFactors

    3. Company ID

    4. Client ID

    5. Client Secret

    6. Question de consentement par SMS

      1. Field ID

      2. Option ID "Yes"

      3. Option "Non" ID


Avant l'intégration, nous devrons configurer quelques autorisations pour activer toutes les fonctionnalités dont nous avons besoin. Veuillez consulter les étapes décrites ci-dessous.


1.Configuration du profil du candidat


Remarque : Un utilisateur de SuccessFactors avec accès administratif devra accomplir ces tâches.

L'intégration Grayscale devra avoir accès à deux champs sur le profil du candidat pour la synchronisation des relevés de notes et la gestion du consentement SMS :

  1. La synchronisation des transcriptions utilise un Champ Standard intitulé "Commentaires"

  2. La gestion du consentement par SMS utilise un champ personnalisé

Pour activer les deux champs sur le Modèle de Profil Candidat :

  1. Recherchez et sélectionnez Gérer les modèles

  2. Depuis l'onglet Gestion du recrutement, sélectionnez Profil du candidat

  3. Clique sur le nom du modèle de profil que tu veux modifier

  4. Sur la page principale des Paramètres du modèle, faites défiler jusqu'en bas de l'écran. Sélectionnez le bouton {N} Champs définis. Cliquez pour modifier

  5. Pour activer la Synchronisation des Transcriptions

    1. Sélectionnez Ajouter > Ajouter un champ standard dans le menu déroulant en haut du modal

    2. Dans le nouveau formulaire de champ, entrez :

      1. Field id: “comments”

      2. Field type: “text”

      3. Libellé de champ : « Commentaires »

  6. Pour la gestion du consentement SMS

    1. Ajouter un nouveau Champ Personnalisé – collecter les valeurs pour l'ID de champ et l'ID de liste de sélection (prenez note de la structure des majuscules)

      1. Field id: Grayscale_sms_consent

      2. Type de champ : liste de sélection

      3. [Entrez le texte de la question de consentement SMS]

        1. Exemple :
          « Souhaitez-vous recevoir des messages texte du Recruteur pour ce poste en rapport avec le processus de recrutement – tels que des demandes d'entretien, des rappels, etc. ?
          Remarque : Sélectionner « non » ne vous éliminera pas de la considération pour ce poste. Des frais de messages et de données peuvent s'appliquer, selon votre forfait de téléphonie mobile. À tout moment, vous pouvez obtenir plus d'aide en répondant AIDE à ces messages, ou vous pouvez vous désinscrire complètement en répondant STOP.) »

      4. Description du champ : (facultatif) smsConsentPicklist

      5. Requis : Vrai*

        1. Nos recommandations pour configurer ce champ sont de le marquer comme obligatoire – mais il peut être laissé facultatif si cela perturberait autrement votre flux de travail actuel.

      6. Faux

      7. Est-ce sensible : Faux

      8. ID de liste de sélection : Sélectionnez une option de liste de sélection Oui/Non appropriée pour votre organisation

  7. Clique sur Terminé

  8. Dans la barre de menu du haut, clique sur Publier

  9. Confirmez les modifications en cliquant sur Oui

Note : Il est possible que certains avertissements s'affichent concernant la configuration du profil existant, mais les modifications auront été appliquées.

Vérifier les autorisations de synchronisation des transcriptions

Les transcriptions de conversation en Grayscale seront publiées sur le profil du candidat via l'API.Voici les autorisations de champ nécessaires pour que les transcriptions des conversations soient visibles sur le profil du candidat en interne :

  • Description : [Entrez une description pour l'autorisation de champ]

  • Type *: Lire la permission

  • Nom du groupe : [Sélectionnez un groupe dynamique pour lequel cette autorisation est applicable.Voici les groupes dynamiques définis dans l'instance.Si aucun nom de groupe n'est sélectionné, la permission s'appliquera par défaut au Candidat

  • Pays/Régions *: [Sélectionnez les pays/régions des candidats pour lesquels cette autorisation est applicable]

  • Sources *: N'IMPORTE

  • Champs * : • Commentaires sélectionnés

  • Éléments d'arrière-plan : Aucun

Les commentaires des candidats devraient maintenant être visibles sur le profil du candidat !


2. Attribuer des autorisations à l'utilisateur d'intégration


Pour s'assurer que Grayscale a accès aux données requises, attribuez des autorisations spécifiques à l'utilisateur d'intégration dans SAP SuccessFactors.

  1. Créer ou Sélectionner un Rôle:

    • Va à Admin Center > Gérer les rôles d'autorisation.

    • Crée un nouveau rôle (par exemple, "Grayscale Integration") ou sélectionne-en un existant.

  2. Attribuer des autorisations : Développez la section appropriée ci-dessous pour ajouter des autorisations

    • Dans le rôle, allez dans Permissions et trouvez les permissions sous leurs catégories respectives comme indiqué ci-dessous.

    • Autorisations de recrutement :

      • Exportation de demande d'emploi via l'API OData

      • Exportation de l'application API OData

      • Centre d'entretiens de création/mise à jour d'API OData

      • Exportation de candidat via l'API OData

      • OData API Candidate Create


3.Rassembler les valeurs d'intégration


Nous aurons besoin des valeurs suivantes pour configurer l’intégration :

  • URL du serveur API

  • Nom d'utilisateur SAP SuccessFactors

  • Company ID

  • Client ID

  • Client Secret

URL du serveur API

En utilisant votre URL de connexion, vous pouvez trouver l'URL du serveur API correspondant en visitant ce lien.

  • Votre URL de serveur API SAP SuccessFactors est une URL étroitement liée à l'URL de connexion où vous vous connectez à l'instance SAP SuccessFactors de votre entreprise.

  • Par exemple, si vous vous connectez à « https://acme.successfactors.com/login », votre URL de connexion est acme.successfactors.com (la valeur après « https:// » et avant « /login »).

  • En règle générale, l'ajout de « api » avant votre URL de connexion génère l'URL correcte du serveur API (c'est-à-dire apiacme.successfactors.com ).

Nom d'utilisateur et identifiant de société SAP

Pour trouver votre nom d'utilisateur SAP SuccessFactors et votre identifiant d'entreprise , vous pouvez consulter votre e-mail de bienvenue SAP SuccessFactors sous « Nom d'utilisateur de l'entreprise » (voir l'image ci-dessous) :

  • Tu peux aussi trouver ton ID d'entreprise SAP SuccessFactors dans l'URL de connexion, qui t'est également envoyée dans ton email de bienvenue SAP SuccessFactors (sous "Lien de l'entreprise" - voir l'image ci-dessous)

  • Alternativement, tu peux trouver ton ID d'entreprise SAP SuccessFactors en te connectant à SAP SuccessFactors, en survolant ta photo de profil pour dérouler le menu, en cliquant sur "Afficher les informations sur la version", et en localisant l'ID d'entreprise dans la fenêtre modale qui s'affiche :

    Impossible d'afficher le contenu

ID client et secret client

  1. Connectez-vous à votre instance SAP

  2. Cherche Gérer les applications clientes OAuth2 dans la barre de recherche

  3. Clique sur Enregistrer l'application client

  4. Remplis le Nom de l'application (Grayscale) & URL de l'application (https://app.gograyscale.com) et clique sur Générer un certificat X.509

  5. Remplissez le nom commun (Grayscale) et cliquez sur Générer

  6. Une fois l'écran actualisé, cliquez sur Télécharger

    • Cela téléchargera un fichier appelé Certificate.pem

  7. Cliquez sur S'inscrire

    • Vous verrez maintenant votre application listée. Cliquez sur Voir.

    • Vous verrez maintenant une clé API répertoriée : il s'agit de votre identifiant client.

  • Ouvre le fichier "Certificate.pem" que tu as téléchargé précédemment dans un éditeur de texte.

    1. Renomme le Certificate.pem en Certificate.txt et double-clique pour l'ouvrir

    2. Copie la chaîne entre ——BEGIN ENCRYPTED PRIVATE KEY——- et —-END ENCRYPTED PRIVATE KEY——- c'est votre Secret Client


IDs de question de consentement par SMS

Pour activer la gestion du consentement SMS, nous aurons besoin des valeurs suivantes :

  1. Field ID

    • C.-à-d. Grayscale_sms_consent

  2. Option ID de la valeur de liste de choix "Yes"

    • C.-à-d. 1234

  3. Option ID de la valeur de liste déroulante “No”

    • C.-à-d. 1235

Pour trouver les ID d'option de liste de sélection :

  1. Rechercher et sélectionner Picklist Center

  2. Tape la valeur de l'ID Pickist dans la barre de recherche et sélectionne la liste déroulante Oui/Non

  3. Sélectionnez la ligne active

  4. Sélectionnez la valeur qui représente l'action négative, c'est-à-dire « Non »

  5. Collecte la valeur de l'ID d'option

  6. Répétez les étapes 4 et 5 en sélectionnant l'action affirmative, c'est-à-direOui

Options d'application du consentement par SMS

Il y a 3 niveaux d'application du consentement disponibles dans Grayscale.Veuillez informer votre responsable de mise en œuvre de votre choix :

  1. Pas de contrainte. Les utilisateurs géreront eux-mêmes – en identifiant et respectant manuellement la réponse de chaque candidat avant d'envoyer un message texte. Ils peuvent envoyer un SMS à n'importe quel candidat, sauf si celui-ci a choisi de se désinscrire via SMS directement (c'est-à-dire en répondant par « STOP » ou « UNSUBSCRIBE »). Il est toujours de la responsabilité du client de recueillir le consentement.

  2. Application permissive. Les utilisateurs ne pourront pas envoyer de messages aux candidats qui ont répondu NON à la question de consentement.

    • Les candidats qui ont soumis une candidature avant la collecte du consentement SMS peuvent continuer à être contactés.

    • Les candidats qui ont répondu par OUI à la question du consentement par SMS peuvent être contactés.

  3. Application stricte ou totale. Les utilisateurs pourront uniquement communiquer avec les candidats qui ont répondu OUI à la question de consentement par SMS.

    • Les utilisateurs ne pourront pas commencer ou continuer à communiquer avec les candidats qui ont répondu NON à la question de consentement par SMS.

    • Les utilisateurs ne pourront pas commencer ou continuer à communiquer avec les candidats qui n'ont pas fait de choix sur la question du consentement par SMS.

      • Cela s'applique généralement aux candidats qui ont déposé leur(s) dossier(s) de candidature avant l'ajout du questionnaire SMS.


Dépannage des autorisations OData

Parfois, pour que les autorisations et ajustements d'authentification ci-dessus prennent effet, il est nécessaire de faire un « OData Metadata Refresh ».

  1. Connecte-toi à SuccessFactors

    1. Recherchez actualiser et sélectionnez Actualiser sous Actualisation et exportation des métadonnées de l'API OData?

  2. Si votre organisation a mis en place des restrictions d'accès IP pour l'API, un administrateur devra autoriser nos serveurs à communiquer avec l'API SAP. Faites-le en ajoutant les valeurs décrites dans cette documentation SAP.

  3. Pour ajouter les adresses IP Grayscale :

    1. Dans SuccessFactors, recherche et sélectionne Politique de mot de passe & de connexion

    2. Clique sur Définir les exceptions de connexion API et développe-le pour trouver l'Utilisateur Admin Grayscale

    3. Clique sur l'icône du crayon pour modifier

    4. Colle ces adresses IP séparées par des virgules :

      • 3.225.131.100

      • 52.205.52.97

      • 3.75.58.147

      • 35.159.188.68

  4. Clique sur Enregistrer et Fermer

Avez-vous trouvé la réponse à votre question ?