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 ricevere i lead di Microsoft AppSource e Azure Marketplace, è possibile usare un endpoint HTTPS in Power Automate per gestire questi lead. 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 che verrà usato per configurare i lead nel Centro per i partner.

Nota

Il connettore Power Automate usato in queste istruzioni richiede una sottoscrizione a pagamento a Power Automate. Assicurati di tener conto di questo prima di configurare il flusso.

Creare un flusso usando Power Automate

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

2. Accedi, seleziona I miei flussie passa l'ambiente da Microsoft (impostazione predefinita) all'ambiente Dataverse (CRM).

   

3. In + Nuovo, selezionare + Flusso cloud istantaneo.

   

4. Assegnare un nome al flusso e quindi in Scegliere come attivare questo flussoselezionare Quando viene ricevuta una richiesta HTTP.

   

5. Seleziona il passaggio del flusso per espanderlo.

   

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

   • Copiare lo schema JSON nello schema JSON del corpo della richiesta nella casella di testo .
   • Selezionare Usare il payload di esempio per generare lo schema. Nella casella di testo , immetti o incolla un esempio di payload JSON e incolla l'esempio JSON. Selezionare Fatto per creare lo schema.

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

Nota

A questo punto della configurazione, è possibile selezionare per connettersi a un sistema CRM o configurare una notifica tramite posta elettronica. Seguire le istruzioni rimanenti in base alla scelta.

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 Creare un nuovo record (Microsoft Dataverse) come esempio.

   

3. Seleziona la scheda Azioni contenente l'azione per aggiungere una nuova riga.

   

4. Selezionare lead dall'elenco a discesa Nome tabella.

   

5. Power Automate mostra un modulo per fornire informazioni sui lead. È possibile eseguire il mapping degli elementi dalla richiesta di input scegliendo di aggiungere contenuto dinamico. La schermata seguente mostra OfferTitle come esempio.

   

6. Eseguire il mapping dei campi desiderati e quindi selezionare Salva per salvare il flusso. Viene creato un URL HTTP POST ed è accessibile nella finestra Quando viene ricevuta una richiesta HTTP finestra. Copiare questo URL usando il controllo copia, che si trova a destra dell'URL HTTP POST. L'uso del controllo copia è importante in modo da non perdere alcuna parte 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. Dopo aver completato lo schema JSON, selezionare + Nuovo passaggio.

2. In Scegliere un'azioneselezionare 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 Invia una notifica di posta elettronica (Posta) come azione.

   

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. Quindi seleziona l'elenco di selezione del contenuto dinamico dalla finestra popup.

   Nota

   Quando si aggiungono nomi di campo, è possibile seguire ogni nome con due punti (:) e quindi selezionare Immettere per creare una nuova riga. Dopo aver aggiunto i nomi dei campi, è possibile aggiungere ogni parametro associato dall'elenco di selezione dinamico.

   

   • Corpo: dall'elenco di selezione dei contenuti dinamici, aggiungi le informazioni desiderate nel corpo dell'email. Ad esempio, usare LastName, FirstName, Email e Company. Al termine della configurazione della notifica tramite posta elettronica, l'esempio sarà simile a quello riportato nella schermata seguente.

   

5. Selezionare Salva per completare il flusso. Viene creato un URL HTTP POST ed è accessibile nella finestra Quando viene ricevuta una richiesta HTTP finestra. Copiare questo URL usando il controllo copia, che si trova a destra dell'URL HTTP POST. L'uso di questo controllo è importante in modo da non perdere alcuna parte dell'intero URL. Salvare questo URL perché sarà necessario quando si configura la gestione dei lead nel portale di pubblicazione.

   

Collaudo

È 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

• PowerShell Invoke-RestMethod

• Microsoft Edge - Strumento console di rete

• Bruno

• Curl

  Cautela

  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 Nuovo>Richiedi per configurare lo strumento di test.

2. Compilare il modulo Salva richiesta e quindi salvare nella cartella creata.

3. Selezionare POST dall'elenco a discesa.

4. Incollare l'URL POST HTTP dal flusso creato in Power Automate in cui è indicato Immettere l'URL della richiesta.

5. Torna a Power Automate. Trova il flusso che hai creato per inviare i lead andando a Flussi personali dalla barra dei menu di Power Automate. Selezionare i puntini di sospensione accanto al nome del flusso per visualizzare altre opzioni e selezionare Modifica.

6. Selezionare Test nell'angolo superiore destro, selezionare eseguirò l'azione di attivazionee quindi selezionare Test. Nella parte superiore della schermata verrà visualizzata un'indicazione dell'avvio del test.

7. Tornare allo strumento e selezionare Invia.

8. Torna al tuo flusso e controlla il risultato. Se tutto funziona come previsto, verrà visualizzato un messaggio che indica che il flusso è riuscito.

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

   Nota

   Se non viene visualizzato un messaggio di posta elettronica dal test, controllare la posta indesiderata e le cartelle indesiderate. Nella schermata seguente si noteranno solo le etichette dei campi aggiunte quando è stata configurata la notifica di posta elettronica. Se si trattasse di un lead effettivo generato dall'offerta, verranno visualizzate anche le informazioni effettive del contatto lead nel corpo e nella riga dell'oggetto.

   

Configura l'offerta per l'invio di lead all'endpoint HTTPS

Quando sei pronto a configurare le informazioni sulla gestione dei lead per l'offerta nel portale di pubblicazione, segui questi passaggi.

1. Accedere a Centro per i partner.

2. Selezionare la propria offerta e passare alla scheda configurazione dell'offerta.

3. Nella sezione Clienti potenziali , selezionare Connetti.

   clienti potenziali

4. Nella finestra popup Dettagli connessione selezionare endpoint HTTPS per destinazione lead. Inserisci l'URL POST HTTP dal flusso creato seguendo i passaggi precedenti nel campo URL dell'endpoint HTTPS.

1. Selezionare OK.

Per assicurarsi di aver eseguito correttamente la connessione a una destinazione principale, selezionare il pulsante Convalida. In caso di esito positivo, avrai un lead di test nel luogo di destinazione del lead.

Nota

È necessario completare la configurazione del resto dell'offerta e pubblicarla prima di poter ricevere lead per l'offerta.

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