Passer au contenu principal
Toutes les collectionsRessources SAP SuccessFactorsRessources d'intégration
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 il y a plus d’une semaine

Etendue du travail

La plateforme de recrutement à haut volume de Grayscale est conçue pour aider les recruteurs à rationaliser et à automatiser une expérience de contact avec les candidats à grande é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 l'implémentation de notre solution dans votre ATS.


Etapes de l'intégration

    1. Activer la synchronisation des relevés de notes

    1. Ajouter une question de consentement par SMS

    1. URL du serveur API

    2. Nom d'utilisateur SAP SuccessFactors

    3. ID de l'entreprise

    4. Identifiant du client

    5. Secret du client

    6. Question de consentement par SMS

      1. ID du champ

      2. ID de l'option ≪ Oui ≫

      3. ID de l'option ≪ Non ≫


Nous sommes actuellement en partenariat avec la société Merge, et avant l'intégration, il y a quelques autorisations que nous devons mettre en place pour activer toutes les fonctionnalités dont nous avons besoin. Veuillez consulter les étapes décrites ci-dessous.


Configuration du Profil du Candidat


Note : Un utilisateur de l'implémentation de SuccessFactors avec un accès administratif devra effectuer ces tâches.

L'intégration Grayscale aura besoin d'accéder à deux champs du profil du candidat pour la synchronisation des relevés de notes et la gestion du consentement par SMS :

  1. La synchronisation des relevés de notes 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 de candidat:

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

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

  3. Cliquez sur le nom du modèle de profil que vous souhaitez modifier.

  4. Sur la page principale des paramètres du modèle, faites défiler jusqu'au 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 de la fenêtre modale.

    2. Dans le formulaire du nouveau champ, entrez :

      1. Identifiant du champ : « comments »

      2. Type de champ : « text » (texte)

      3. Champ libellé : « Commentaires »

  6. Pour la gestion du consentement par SMS

    1. Ajouter un nouveau champ personnalisé - collecter les valeurs pour l'ID du champ et l'ID de la liste de sélection (prendre note de la structure du cas)

      1. ID du champ : Grayscale_sms_consent

      2. Type de champ : picklist

      3. Champ libellé : [Saisir le libellé de la question relative au consentement par SMS]

        1. Exemple :
          ≪ Souhaitez-vous accepter de recevoir des SMS de la part du recruteur pour ce poste dans le cadre du processus d'embauche - comme des demandes d'entretien, des rappels, etc. Remarque : Le fait de répondre « non » ne vous empêchera pas d'être pris en considération pour ce poste. Des tarifs de messages et de données peuvent être appliqués, en fonction de votre plan de service de téléphonie mobile. Vous pouvez à tout moment obtenir plus d'aide en répondant HELP à ces messages, ou vous pouvez vous désengager complètement en répondant STOP.) ≫

        2. Pour plus d'exemples, voir Exemples de questions sur le consentement par SMS.

      4. Description du champ : (facultatif) smsConsentPicklist

      5. Obligatoire : True*

        1. *Nous recommandons de rendre ce champ obligatoire, mais il peut être laissé facultatif s'il risque de perturber votre flux de travail actuel.

      6. Anonymize : False

      7. Est sensible : Faux

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

  7. Cliquez sur Terminé​

  8. Dans la barre de menu supérieure, cliquez sur Publier

  9. Confirmez les modifications en cliquant sur Oui

Remarque: certains avertissements peuvent s'afficher concernant la configuration existante du profil, mais les modifications auront été appliquées.

Vérifier les autorisations de synchronisation des transcriptions

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

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

  • Type * : Permission de lecture

  • Nom du groupe : [Sélectionnez un groupe dynamique pour lequel cette autorisation est applicable. Il s'agit des groupes dynamiques définis dans l'instance. Si aucun nom de groupe n'est sélectionné, l'autorisation 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 * : ANY

  • 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 !


Vérifier les Autorisations OData


Par défaut, les utilisateurs ne peuvent que visualiser ou modifier les champs pertinents en fonction des autorisations au niveau du champ qui sont définies dans les modèles d'entité. Ces autorisations au niveau du champ permettent aux opérateurs de recrutement d'effectuer les mêmes actions en utilisant les API ODATA que celles qu'ils effectuent sur les entités dans SAP SuccessFactors Recruiting.

Les autorisations suivantes permettront à l'utilisateur de l'API Grayscale de visualiser et de modifier tous les champs requis par l'intégration Grayscale, quelle que soit la relation de l'utilisateur intégrateur avec ces entités :

  1. OData API Requisition Export

  2. OData API Application Export

  3. OData API Interview Central Create/Update

  4. OData API Candidate Export

  5. OData API Candidate Create

  6. Employee Central Foundation API (lecture seule)

Dépannage des autorisations Odata

Parfois, pour que les permissions et les ajustements d'authentification ci-dessus prennent effet, il est nécessaire de procéder à un « rafraîchissement des métadonnées OData »

  1. Connectez-vous à SuccessFactors

    1. Cherchez refresh et sélectionnez Refresh sous OData API Metadata Refresh and Export ?

  2. Si l'API de votre organisation a mis en place des restrictions d'accès IP, un administrateur devra autoriser nos serveurs à communiquer avec l'API SAP. Pour ce faire, ajoutez les valeurs décrites dans cette documentation SAP.

  3. Pour ajouter les adresses IP Grayscale :

    1. Dans SuccessFactors, recherchez et sélectionnez Password & Login Policy.

    2. Cliquez sur Set API Login Exceptions (Définir les exceptions de connexion à l'API) et développez la section pour trouver l'utilisateur administrateur de Grayscale.

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

    4. Collez ces adresses IP délimitées par des virgules :

      1. 44.194.126.11​

      2. 44.194.4.0​

      3. 3.232.227.174​

      4. 3.214.125.237​

      5. 54.158.121.71​

      6. 44.193.163.62

  4. Cliquez sur Enregistrer et fermer​


Rassembler les Valeurs d'Intégration


1 - URL du serveur API

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

  1. L'URL de votre 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.

  2. 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 »).

  3. En général, si vous ajoutez « api » à votre URL de connexion, vous obtiendrez l'URL correcte du serveur API (c'est-à-dire apiacme.successfactors.com)


2 - Nom d'utilisateur SAP et identifiant de l'entreprise

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

  1. Vous pouvez également trouver votre identifiant d'entreprise SAP SuccessFactors dans votre URL de connexion, qui vous est également envoyé dans votre e-mail de bienvenue SAP SuccessFactors (sous « Lien d'entreprise » - voir l'image ci-dessous)

    1. Par exemple, si votre URL de connexion est« https://successfactors.com/login?company=SFCPART00000 », l'identifiant de votre entreprise sera SFCPART000000.

  2. Vous pouvez également trouver votre ID d'entreprise SAP Success Factors en vous connectant à SAP SuccessFactors, en survolant votre photo de profil pour développer le menu déroulant, en cliquant sur « Afficher les informations de version » et en localisant l'ID d'entreprise dans la fenêtre modale qui s'affiche.


3 - Identifiant et Secret du Client

  1. Connectez-vous à votre instance SAP

  2. Recherchez Manage OAuth2 Client Applications dans la barre de recherche

  3. Cliquez sur Register Client Application (Enregistrer une application client)

  4. Renseignez le nom de l'application (Grayscale) et l'URL de l'application (https://app.gograyscale.com), puis cliquez sur Generate X.509 Certificate (Générer un certificat X.509)

  5. Renseignez le nom commun (Grayscale) et cliquez sur Generate

  6. Une fois l'écran rafraîchi, cliquez sur Télécharger.

    1. Un fichier appelé Certificate.pem sera téléchargé

  7. Cliquez sur Enregistrer.

    1. Votre demande est à présent répertoriée. Cliquez sur View.

    2. Vous verrez maintenant une clé API listée - il s'agit de votre ID client.

  8. Ouvrez le fichier « Certificate.pem » que vous avez téléchargé précédemment dans un éditeur de texte.

    1. Renommez le fichier Certificate.pem en Certificate.txt et double-cliquez pour l'ouvrir.

    2. Copiez la chaîne entre --BEGIN ENCRYPTED PRIVATE KEY--- et --END ENCRYPTED PRIVATE KEY--- il s'agit de votre Secret Client.


4 - ID des questions de consentement par SMS

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

  1. ID du champ

    • I.e. Grayscale_sms_consent

  2. Option ID de la valeur « Oui » de la liste de sélection

    • I.e. 1234

  3. ID d'option de la valeur « Non » de la liste de sélection

    • I.e. 1235

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

  1. Recherchez et sélectionnez Picklist Center

  2. Tapez la valeur de l'identifiant de la liste de sélection dans la barre de recherche et sélectionnez la liste de sélection Oui/Non correspondante.

  3. Sélectionnez la ligne Active

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

  5. Collectez la valeur de l'ID de l'option

  6. Répétez les étapes 4 et 5 en sélectionnant l'action positive, c'est-à-dire « Oui ».


Options d'application du consentement par SMS

Trois niveaux d'application du consentement sont disponibles en Grayscale :

  1. Pas d'application. Les utilisateurs se débrouilleront seuls - en identifiant et en respectant manuellement la réponse de chaque candidat avant d'envoyer un SMS. Ils peuvent envoyer un SMS à n'importe quel candidat, à moins qu'il ne se soit désinscrit directement par SMS (c'est-à-dire qu'il ait répondu « STOP » ou « UNSUBSCRIBE »). Il incombe toujours au client de recueillir le consentement.

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

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

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

  3. Application stricte ou totale. Les utilisateurs ne pourront communiquer qu'avec les candidats ayant répondu OUI à la question relative au consentement par SMS.

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

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

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

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