Usare un endpoint HTTPS per gestire i lead del marketplace commerciale

Se il sistema CRM (Customer Relationship Management) non è supportato in modo esplicito nel Centro per i partner per la ricezione di lead di Microsoft AppSource e Azure Marketplace, è possibile gestire questi lead tramite un endpoint HTTPS in Power Automate. Con un endpoint HTTPS, i lead del marketplace commerciale possono essere inviati come notifica tramite posta elettronica oppure possono essere scritti in un sistema CRM supportato da Power Automate.

Questo articolo illustra come creare un nuovo flusso in Power Automate per generare l'URL POST HTTP da usare per configurare i lead nel Centro per i partner.

Creare un flusso tramite Power Automate

1. Aprire la pagina Web di Power Automate. Fare clic su Accedi. Se non si ha già un account, selezionare Iscriviti gratuitamente per crearne uno.

2. Accedere, selezionare Flussi personali e passare da Microsoft (impostazione predefinita) all'ambiente Dataverse (CRM).

   

3. In + Nuovo selezionare + Flusso cloud istantaneo.

   

4. Assegnare un nome al flusso, quindi in Scegliere come attivare questo flusso selezionare Alla ricezione di una richiesta HTTP.

   

5. Selezionare il passaggio del flusso per espanderlo.

   

6. Usare uno dei metodi seguenti per configurare l'opzione Schema JSON del corpo della richiesta:

   • Copiare lo schema JSON riportato nella casella di testo Schema JSON del corpo della richiesta.
   • Seleziona Utilizza payload di esempio per generare il collegamento dello schema. Nella casella di testo Immettere o incollare un payload JSON di esempio incollare l'esempio di JSON. Selezionare Fine per creare lo schema.

   Schema 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"
   }
   

   Esempio di 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"
   }
   

Connettersi a un sistema CRM

1. Selezionare + Nuovo passaggio.

2. Cercare e selezionare un sistema CRM nella casella Cerca connettori e azioni . La schermata seguente mostra come esempio Creare un nuovo record (Microsoft Dataverse).

   

3. Selezionare la scheda Azioni con l'azione Aggiungi una nuova riga.

   

4. Selezionare il lead nell'elenco a discesa Nome tabella.

   

5. Power Automate visualizza un modulo per l'immissione di informazioni sui lead. È possibile mappare elementi dalla richiesta di input scegliendo di aggiungere contenuto dinamico. La schermata seguente mostra OfferTitle come esempio.

   

6. Mappare i campi prescelti e quindi selezionare Salva per salvare il flusso. Viene creato un URL POST HTTP, accessibile nella finestra Alla ricezione di una richiesta HTTP. Copiare questo URL usando il controllo di copia, che si trova a destra dell'URL POST HTTP. È importante usare il controllo di copia per evitare di perdere parti dell'intero URL. Salvare questo URL perché sarà necessario quando si configura la gestione dei lead nel portale di pubblicazione.

   

Configurare la notifica tramite posta elettronica

1. Una volta completato lo schema JSON, selezionare + Nuovo passaggio.

2. In Scegliere un'azione selezionare Azioni.

3. Nella scheda Azioni selezionare Invia un messaggio di posta elettronica (Office 365 Outlook).

   Nota

   Se si vuole usare un provider di posta elettronica diverso, cercare e selezionare l'azione Invia una notifica di posta elettronica (Mail).

   

4. Nella finestra Invia un messaggio di posta elettronica configurare i campi obbligatori seguenti:

   • A: immettere almeno un indirizzo di posta elettronica valido in cui verranno inviati i lead.
   • Oggetto: Power Automate offre la possibilità di aggiungere contenuto dinamico, ad esempio LeadSource illustrato nella schermata seguente. Per iniziare, immettere un nome di campo. Selezionare quindi l'elenco di selezione di contenuto dinamico nella finestra popup.

   Nota

   Quando si aggiungono i nomi dei campi, è aggiungere due punti (:) dopo ogni nome e quindi premere INVIO per creare una nuova riga. Una volta aggiunti i nomi dei campi, è possibile aggiungere ogni parametro associato dall'elenco di selezione di contenuto dinamico.

   

   • Corpo: dall'elenco di selezione contenuto dinamico aggiungere le informazioni desiderate nel corpo del messaggio di posta elettronica. ad esempio LastName, FirstName, Email e Company. Una volta configurata, la notifica tramite posta elettronica avrà un aspetto simile a quello dell'esempio della schermata seguente.

   

5. Selezionare Salva per completare il flusso. Viene creato un URL POST HTTP, accessibile nella finestra Alla ricezione di una richiesta HTTP. Copiare questo URL usando il controllo di copia, che si trova a destra dell'URL POST HTTP. È importante usare questo controllo per evitare di perdere parti dell'intero URL. Salvare questo URL perché sarà necessario quando si configura la gestione dei lead nel portale di pubblicazione.

   

Test

È possibile testare la configurazione con uno strumento in grado di inviare richieste HTTP per testare la soluzione, ad esempio:

• Visual Studio Code con un'estensione da Visual Studio Marketplace

• Invoke-RestMethod di PowerShell

• Microsoft Edge - Strumento console di rete

• Bruno

• Curl

  Attenzione

  Per gli scenari in cui sono presenti dati sensibili, ad esempio credenziali, segreti, token di accesso, chiavi API e altre informazioni simili, assicurarsi di usare uno strumento che protegge i dati con le funzionalità di sicurezza necessarie, funziona offline o in locale, non sincronizza i dati nel cloud e non richiede l'accesso a un account online. In questo modo si riduce il rischio di esporre i dati sensibili al pubblico.

1. Avviare lo strumento e selezionare Nuova>richiesta per configurare lo strumento di test.

2. Compilare il modulo Save Request (Salva richiesta), quindi salvarlo nella cartella creata.

3. Selezionare POST nell'elenco a discesa.

4. Incollare l'URL POST HTTP dal flusso creato in Power Automate nel campo Enter request URL (Immettere l'URL della richiesta).

5. Tornare in Power Automate. Trovare il flusso creato per l'invio dei lead scegliendo Flussi personali sulla barra dei menu di Power Automate. Selezionare i puntini di sospensione accanto al nome del flusso per visualizzare altre opzioni, quindi scegliere Modifica.

6. Selezionare Test nell'angolo in alto a destra, selezionare Verrà eseguita l'azione del trigger e quindi selezionare Test. Nella parte superiore dello schermo verrà visualizzata l'indicazione che il test è stato avviato.

7. Tornare allo strumento e selezionare Invia.

8. Tornare nel flusso e verificare il risultato. Se tutto funziona come previsto, verrà visualizzato un messaggio che indica che il flusso è stato creato correttamente.

9. Dovresti anche ricevere un messaggio di posta elettronica. Controllare la posta in arrivo.

   Nota

   Se il messaggio del test non è disponibile, controllare la cartella della posta indesiderata. Nella schermata seguente si noteranno solo le etichette dei campi aggiunti durante la configurazione della notifica tramite posta elettronica. Se per l'offerta venisse generato un lead effettivo, il corpo e la riga dell'oggetto conterrebbero anche le informazioni effettive del contatto del lead.

   

Configurare l'offerta per inviare clienti potenziali all'endpoint HTTPS

Quando si è pronti a configurare le informazioni di gestione dei lead per l'offerta nel portale di pubblicazione, seguire questa procedura.

1. Accedere al Centro per i partner.

2. Selezionare l'offerta e passare alla scheda Configurazione dell'offerta.

3. Nella sezione Customer leads (Lead clienti) selezionare Connetti.

   

4. Nella finestra popup Dettagli connessione selezionare Endpoint HTTPS per Destinazione del lead. Nel campo URL dell'endpoint HTTPS incollare l'URL POST HTTP dal flusso creato seguendo i passaggi precedenti.

5. Seleziona OK.

Per assicurarsi di avere eseguito la connessione a una destinazione del lead, selezionare il pulsante Convalida. In caso di esito positivo, sarà presente un lead di test nella destinazione del lead.

Quando vengono generati lead, Microsoft li invia al flusso. I lead vengono indirizzati al sistema CRM o all'indirizzo di posta elettronica configurato.