Configurer un webhook bidirectionnel

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Configurez un webhook pour vous abonner aux Salesforce événements avec une ServiceNow URL de rappel.

    Avant de commencer

    Procédure

    1. Connectez-vous en tant qu’administrateur à votre Salesforce instance.
    2. Obtenir les détails de l’instance Salesforce .
      Pour en savoir plus, consultez l’article de la base de connaissances Afficher les informations d’instance de votre organisation Salesforce dans Salesforce Forum des pionniers.
      1. Si vous n’avez Salesforce pas de domaines personnalisés, procurez-vous le nom de l’instance à partir de la page Informations sur l’entrepriseSalesforce.
      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 sur la page est newdomain-customdomain.my.salesforce.com, copiez et enregistrez la valeur newdomain-customdomain.
    3. Obtenir l’ID d’organisation à 18 chiffres de votre Salesforce instance.
      1. Accédez à la Developer Console de votre Salesforce instance et exécutez cette requête : 
        Select Id from Organization
      2. Copiez et enregistrez la valeur des 18 chiffres de l’ID d’organisation.
    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 les valeurs suivantes 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 du 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 de la ressource.
        L’URL de point de terminaison requise ServiceNow est la suivante : https://<nom-intance>.service-now.com/<chemin-ressource>
    7. Configurez les flux secondaires par défaut ou créez des flux secondaires personnalisés.
      Ces flux secondaires sont déclenchés lorsque des é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, la politique de webhook de décision Salesforce.
      3. Dans l’onglet Décisions , cliquez sur Nouveau.
      4. Renseignez les valeurs suivantes 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 du 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, voir Actions de message sortant dans Salesforce Forum des pionniers.

    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 créé précédemment.
      Pour en savoir plus sur la création de la règle de workflow, reportez-vous à la section Créer une règle de workflow dans Salesforce Forum des pionniers.