Configurer un webhook bidirectionnel

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture
  • Configurez un webhook pour vous abonner à Salesforce des événements avec une ServiceNow URL de rappel.

    Avant de commencer

    Procédure

    1. Connectez-vous en tant qu’administrateur à votre Salesforce instance.
    2. Obtenez les détails de l’instance Salesforce .
      Pour plus d’informations, consultez l’article de la base de connaissances Afficher les informations d’instance pour votre organisation Salesforce dans Salesforce Forum Trailblazer.
      1. Si vous n’avez pas de Salesforce domaines personnalisés, obtenez le nom de l’instance Salesforce à partir de la page Informations sur la société.
      2. Si vous avez des domaines personnalisés, accédez à Gestion de domaine > Mon domaine et copiez le nom de domaine.
        Par exemple, si le nom de domaine complet de la page est newdomain-customdomain.my.salesforce.com, copiez et enregistrez la valeur newdomain-customdomain.
    3. Obtenez l’ID d’organisation à 18 chiffres de votre Salesforce instance.
      1. Accédez à la console développeur dans votre Salesforce instance et exécutez cette requête :
        Select Id from Organization
      2. Copiez et enregistrez la valeur de l’ID d’organisation à 18 chiffres.
    4. Connectez-vous à votre instance ServiceNow.
    5. Créez un registre webhook.
      1. Accédez à la Registre webhook de Salesforce > Registres webhook de Salesforce.
      2. Cliquez sur Nouveau.
      3. Renseignez ces valeurs sur le formulaire :
        Champ Description
        ID d'organisation ID d’organisation à 18 chiffres de votre Salesforce instance.
        Nom d'instance Nom de l’instance Salesforce obtenu à partir de la page Informations sur l’entreprise ou domaine personnalisé de l’instance Salesforce obtenu à partir de Gestion de domaine > Mon domaine.
      4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    6. Obtenez le chemin d’accès de la ressource à partir de votre ServiceNow instance.
      1. Accédez à la Services web du système > Services Web basés sur un script > API REST basées sur un script.
      2. Ouvrez l’enregistrement Rappels webhook Salesforce.
      3. Dans l’onglet Ressources , cliquez sur l’enregistrement de rappel par défaut .
      4. Copiez et enregistrez la valeur du chemin d’accès à la ressource.
        L’URL de point de terminaison requise ServiceNow est la suivante : https://<intance-name>.service-now.com/<resource-path>
    7. Configurez les flux secondaires par défaut ou créez des flux secondaires personnalisés.
      Ces flux secondaires sont déclenchés lorsque les événements requis se produisent dans l’instance Salesforce . Pour plus d’informations, consultez Création de flux secondaires.
    8. Configurez la politique d’acheminement du webhook.
      1. Accédez à la Définition du système > Tables de décision.
      2. Ouvrez l’enregistrement Politique de webhook de décision Salesforce.
      3. Dans l’onglet Décisions , cliquez sur Nouveau.
      4. Renseignez ces valeurs sur le formulaire :
        Champ Description
        Étiquette Étiquette unique pour identifier la politique d’acheminement.
        Réponse Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies.
        Réponse par défaut Option permettant de spécifier s’il s’agit de la réponse par défaut.
        Condition Conditions à remplir lorsque les événements requis se produisent dans Salesforce.
        Remarque :
        Par défaut, ces Salesforce objets sont pris en charge dans les politiques d’acheminement de webhook :
        • Compte
        • Ticket
        • Contrat
        • Opportunité
        Vous pouvez configurer la table de décision par défaut pour prendre en charge d’autres Salesforce objets selon vos besoins.
      5. Cliquez sur Enregistrer.
    9. Créez un message sortant à partir de votre Salesforce instance.

      Pour plus d’informations sur la création du message sortant, consultez Actions de messages sortants dans Salesforce Forum Trailblazer.

    10. Dans l’URL du point de terminaison, saisissez l’URL du point de terminaison au format suivant : https://<nom-intance>.service-now.com/<chemin-ressource>.
    11. À partir de votre Salesforce instance, créez une règle de workflow et configurez-la pour déclencher le message sortant que vous avez précédemment créé.
      Pour en savoir plus sur la création de la règle de workflow, reportez-vous à la rubrique Créer une règle de workflow dans Salesforce Forum Trailblazer.