Partage via

Utiliser un point de terminaison HTTPS pour gérer les prospects de la Place de marché commerciale

  • Article

Si votre système de gestion des relations client (CRM) n’est pas explicitement pris en charge dans l’Espace partenaires pour recevoir des prospects Microsoft AppSource et place de marché Azure, vous pouvez utiliser un point de terminaison HTTPS dans Power Automate pour gérer ces prospects. Avec un point de terminaison HTTPS, les prospects de la Place de marché commerciale peuvent être envoyés en tant que notification par e-mail ou être écrits dans un système CRM pris en charge par Power Automate.

Cet article explique comment créer un flux dans Power Automate pour générer l’URL HTTP POST que vous allez utiliser pour configurer des prospects dans l’Espace partenaires.

Remarque

Le connecteur Power Automate utilisé dans ces instructions nécessite un abonnement payant à Power Automate. Veillez à prendre cela en considération avant de configurer ce flux.

Créer un flux à l’aide de Power Automate

  1. Ouvrez la page web Power Automate. Sélectionnez Se connecter. Si vous n’avez pas encore de compte, sélectionnez inscrivez-vous gratuitement pour en créer un.

  2. Connectez-vous, sélectionnez Mes flux, puis basculez l’environnement de Microsoft (par défaut) vers votre environnement Dataverse (CRM).

    Montre comment se connecter à « Mes flux ».

  3. Sous + Nouveau, sélectionnez + Flux cloud instantané.

    Montre comment sélectionner Mes flux, suivis d’un flux cloud instantané.

  4. Nommez votre flux, puis, sous Choisissez comment déclencher ce flux, sélectionnez Lorsqu’une requête HTTP est reçue.

    Montre comment créer un bouton Ignorer pour une fenêtre de flux automatisée.

  5. Sélectionnez l’étape du flux pour la développer.

    Montre comment étendre l'étape de flux.

  6. Utilisez l’une des méthodes suivantes pour configurer le schéma JSON du corps de la requête :

    • Copiez le schéma JSON dans la zone de texte Schéma JSON du corps de la demande.
    • Sélectionnez Utiliser l'exemple de payload pour générer le schéma. Dans la zone de texte Saisissez ou collez un exemple de charge utile JSON, collez l’exemple JSON. Sélectionnez OK pour créer le schéma.

    Schéma JSON

    {
  "$schema": "https://json-schema.org/draft-04/schema#",
  "definitions": {},
  "id": "http://example.com/example.json",
  "properties": {
    "ActionCode": {
      "id": "/properties/ActionCode",
      "type": "string"
    },
    "OfferTitle": {
      "id": "/properties/OfferTitle",
      "type": "string"
    },
    "LeadSource": {
      "id": "/properties/LeadSource",
      "type": "string"
    },
    "Description": {
      "id": "/properties/Description",
      "type": "string"
    },
    "UserDetails": {
      "id": "/properties/UserDetails",
      "properties": {
        "Company": {
          "id": "/properties/UserDetails/properties/Company",
          "type": "string"
        },
        "Country": {
          "id": "/properties/UserDetails/properties/Country",
          "type": "string"
        },
        "Email": {
          "id": "/properties/UserDetails/properties/Email",
          "type": "string"
        },
        "FirstName": {
          "id": "/properties/UserDetails/properties/FirstName",
          "type": "string"
        },
        "LastName": {
          "id": "/properties/UserDetails/properties/LastName",
          "type": "string"
        },
        "Phone": {
          "id": "/properties/UserDetails/properties/Phone",
          "type": "string"
        },
        "Title": {
          "id": "/properties/UserDetails/properties/Title",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "type": "object"
}

    exemple JSON

    {
  "UserDetails": {
    "FirstName": "Some",
    "LastName": "One",
    "Email": "someone@contoso.com",
    "Phone": "16175555555",
    "Country": "USA",
    "Company": "Contoso",
    "Title": "Esquire"
 },
  "LeadSource": "AzureMarketplace",
  "ActionCode": "INS",
  "OfferTitle": "Test Microsoft",
  "Description": "Test run through Power Automate"
}

Remarque

À ce stade de la configuration, vous pouvez choisir de vous connecter à un système CRM ou de configurer une notification par e-mail. Suivez les instructions restantes en fonction de votre choix.

Se connecter à un système CRM

  1. Sélectionnez + Nouvelle étape.

  2. Recherchez et sélectionnez un système CRM dans la zone Rechercher des connecteurs et des actions. L’écran suivant montre Créer un enregistrement (Microsoft Dataverse) comme exemple.

    Montre comment créer un nouvel enregistrement.

  3. Sélectionnez l’onglet Actions avec l’action pour Ajouter une nouvelle ligne.

    Montre comment sélectionner « Créer un enregistrement ».

  4. Sélectionnez prospect dans la liste déroulante Nom de la table.

    Montre comment sélectionner des prospects.

  5. Power Automate affiche un formulaire permettant de fournir des informations de prospect. Vous pouvez mapper des éléments à partir de la demande d’entrée en choisissant d’ajouter du contenu dynamique. L’écran suivant montre OfferTitle comme exemple.

    Montre comment ajouter du contenu dynamique.

  6. Mappez les champs souhaités, puis sélectionnez Enregistrer pour enregistrer votre flux. Une URL HTTP POST est créée et est accessible dans le Lorsqu’une requête HTTP est reçue fenêtre. Copiez cette URL à l’aide du contrôle de copie, situé à droite de l’URL HTTP POST. L’utilisation du contrôle de copie est importante pour ne pas manquer une partie de l’URL entière. Enregistrez cette URL, car vous en aurez besoin lorsque vous configurez la gestion des prospects dans le portail de publication.

    Indique quand une requête HTTP est reçue.

Configurer la notification par e-mail

  1. Maintenant que vous avez terminé le schéma JSON, sélectionnez + Nouvelle étape.

  2. Sous Choisir une action, sélectionnez Actions.

  3. Sous l’onglet Actions, sélectionnez Envoyer un e-mail (Office 365 Outlook).

    Remarque

    Si vous souhaitez utiliser un autre fournisseur de messagerie, recherchez et sélectionnez Envoyer une notification par e-mail (courrier) comme action à la place.

    Ajouter une action de messagerie

  4. Dans la fenêtre Envoyer un e-mail, configurez les champs obligatoires suivants :

    • À: entrez au moins une adresse e-mail valide où les prospects seront envoyés.
    • Objet: Power Automate vous donne la possibilité d’ajouter du contenu dynamique, comme LeadSource illustré dans l’écran suivant. Commencez par entrer un nom de champ. Sélectionnez ensuite la liste de sélection de contenu dynamique dans la fenêtre contextuelle.

    Remarque

    Lorsque vous ajoutez des noms de champs, vous pouvez suivre chaque nom avec un signe deux-points (:), puis sélectionner Entrer pour créer une ligne. Une fois que vos noms de champs ont été ajoutés, vous pouvez ajouter chaque paramètre associé à partir de la liste de sélection dynamiques.

    Ajouter une action de messagerie à l’aide du contenu dynamique de contenu dynamique

    • Corps : depuis la liste de sélection de contenu dynamique, ajoutez les informations que vous souhaitez dans le corps de l’e-mail. Par exemple, utilisez LastName, FirstName, Email et Company. Lorsque vous avez terminé de configurer la notification par e-mail, l’exemple se présente dans l’écran suivant.

    exemple de notification par e-mail

  5. Sélectionnez Enregistrer pour terminer votre processus. Une URL HTTP POST est créée et est accessible dans le Lorsqu’une requête HTTP est reçue fenêtre. Copiez cette URL à l’aide du contrôle de copie, situé à droite de l’URL HTTP POST. L’utilisation de ce contrôle est importante pour ne pas manquer une partie de l’URL entière. Enregistrez cette URL, car vous en aurez besoin lorsque vous configurez la gestion des prospects dans le portail de publication.

    HTTP POST URL

Test en cours

Vous pouvez tester votre configuration avec un outil qui peut envoyer des requêtes HTTP pour tester votre solution, par exemple :

  • Visual Studio Code avec une extension de Visual Studio Marketplace

  • PowerShell Invoke-RestMethod

  • Microsoft Edge - Outil console réseau

  • Bruno

  • Curl

    Attention

    Pour les scénarios où vous avez des données sensibles, telles que des informations d’identification, des secrets, des jetons d’accès, des clés API et d’autres informations similaires, veillez à utiliser un outil qui protège vos données avec les fonctionnalités de sécurité nécessaires, fonctionne en mode hors connexion ou localement, ne synchronise pas vos données avec le cloud et ne nécessite pas que vous vous connectiez à un compte en ligne. De cette façon, vous réduisez le risque lié à l’exposition de données sensibles au public.

  1. Démarrez l’outil, puis sélectionnez Nouvelle demande de> pour configurer votre outil de test.

  2. Renseignez le formulaire Enregistrer la demande, puis enregistrez-le dans le dossier que vous avez créé.

  3. Sélectionnez POST dans la liste déroulante.

  4. Collez l’URL HTTP POST du flux que vous avez créé dans Power Automate, où elle indique Entrer l’URL de la demande.

  5. Revenez à Power Automate. Recherchez le flux que vous avez créé pour envoyer des prospects en accédant à Mes flux à partir de la barre de menus Power Automate. Sélectionnez les points de suspension en regard du nom du flux pour afficher d’autres options, puis sélectionnez Modifier.

  6. Sélectionnez Test dans le coin supérieur droit, sélectionnez Je vais effectuer l’action d'enclenchement, puis sélectionnez Test. Vous verrez une indication en haut de l’écran que le test a démarré.

  7. Revenez à votre outil, puis sélectionnez Envoyer.

  8. Revenez à votre flux et vérifiez le résultat. Si tout fonctionne comme prévu, vous verrez un message indiquant que le flux a réussi.

  9. Vous devez également recevoir un e-mail. Vérifiez votre boîte de réception de messagerie.

    Remarque

    Si vous ne voyez pas d'e-mail de l'essai, vérifiez vos dossiers de spam et de courrier indésirable. Dans l’écran suivant, vous remarquerez uniquement les étiquettes de champ que vous avez ajoutées lorsque vous avez configuré la notification par e-mail. S’il s’agissait d’un prospect réel généré à partir de votre offre, vous verriez également les informations réelles du prospect dans le texte et dans la ligne d’objet.

    courriel reçu

Configurer votre offre pour envoyer des prospects au point de terminaison HTTPS

Lorsque vous êtes prêt à configurer les informations de gestion des prospects pour votre offre dans le portail de publication, procédez comme suit.

  1. Connectez-vous à l’Espace partenaires.

  2. Sélectionnez votre offre, puis accédez à l’onglet Configuration de l’offre.

  3. Sous la section Prospects clients, sélectionnez Connecter.

    Prospects clients

  4. Dans la fenêtre indépendante Détails sur la connexion, sélectionnez Point de terminaison HTTPS pour Destination du prospect. Collez l’URL HTTP POST à partir du flux que vous avez créé en suivant les étapes précédentes dans le champ de l'URL de point de terminaison HTTPS .

détails de connexion adresse e-mail de contact.

  1. Sélectionnez OK.

Pour vous assurer que vous êtes correctement connecté à une destination de prospect, sélectionnez le bouton Valider. En cas de succès, un prospect test se trouvera dans la destination du prospect.

Remarque

Vous devez terminer la configuration du reste de l’offre et la publier avant de pouvoir recevoir des prospects pour l’offre.

Lorsque des prospects sont générés, Microsoft envoie des prospects au flux. Les prospects sont acheminés vers le système CRM ou l’adresse e-mail que vous avez configurée.