Usar um endpoint HTTPS para gerenciar clientes potenciais do marketplace comercial

Se o sistema crm (gerenciamento de relacionamento com o cliente) não tiver suporte explícito no Partner Center para receber clientes potenciais do Microsoft AppSource e do Azure Marketplace, você poderá usar um ponto de extremidade HTTPS no power automate para lidar com esses clientes potenciais. Com um endpoint HTTPS, os leads do marketplace comercial podem ser enviados como uma notificação por email ou podem ser registrados em um sistema CRM compatível com o Power Automate.

Este artigo explica como criar um novo fluxo no Power Automate para gerar a URL HTTP POST que você usará para configurar clientes potenciais no Partner Center.

Nota

O conector do Power Automate usado nessas instruções requer uma assinatura paga do Power Automate. Verifique se você contabilize isso antes de configurar esse fluxo.

Criar um fluxo usando o Power Automate

1. Abra a página da Web do Power Automate. Selecione Entrar. Se você ainda não tiver uma conta, selecione Inscrever-se gratuitamente para criar uma.

2. Entre, selecione Meus fluxos e mude o Ambiente de Microsoft (padrão) para seu Ambiente do Dataverse (CRM).

   

3. Em + Nova, selecione + Fluxo instantâneo da nuvem.

   

4. Nomeie seu fluxo e, em Escolha como disparar esse fluxo, selecione Quando uma solicitação HTTP for recebida.

   

5. Selecione a etapa de fluxo para expandi-la.

   

6. Use um dos seguintes métodos para configurar o esquema JSON do corpo da solicitação :

   • Copie o esquema JSON para a caixa de texto Esquema JSON do Corpo da Solicitação.
   • Selecione Usar conteúdo de amostra para gerar esquema. Na caixa de texto Digite ou cole um conteúdo de amostra JSON, cole o exemplo JSON. Selecione Concluído para criar o esquema.

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

   Exemplo 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

Neste ponto da configuração, você pode selecionar para se conectar a um sistema CRM ou configurar uma notificação por email. Siga as instruções restantes com base em sua escolha.

Conectar-se a um sistema CRM

1. Selecione + Nova etapa.

2. Pesquise e selecione um sistema CRM na caixa Pesquisar conectores e ações. A tela a seguir mostra Criar um novo registro (Microsoft Dataverse) como exemplo.

   

3. Selecione a guia Ações com a ação para Adicionar uma linha.

   

4. Selecione lead na lista suspensa Nome da Tabela.

   

5. O Power Automate mostra um formulário para fornecer informações de cliente potencial. Você pode mapear itens da solicitação de entrada optando por adicionar conteúdo dinâmico. A tela a seguir mostra OfferTitle como exemplo.

   

6. Mapeie os campos desejados e selecione Salvar para salvar seu fluxo de trabalho. Uma URL HTTP POST é criada e pode ser acessada na janela quando uma solicitação HTTP é recebida no. Copie essa URL usando o controle de cópia, que está localizado à direita da URL HTTP POST. Usar o controle de cópia é importante para que você não perca nenhuma parte da URL inteira. Salve essa URL porque você precisará dela ao configurar o gerenciamento de clientes potenciais no portal de publicação.

   

Configurar a notificação por email

1. Agora que você concluiu o esquema JSON, selecione + Nova etapa.

2. Em Escolher uma ação, selecione Ações.

3. Na guia Ações, selecione Enviar um email (Office 365 Outlook).

   Nota

   Se você quiser usar um provedor de email diferente, pesquise e selecione Enviar uma notificação por email (Email) como a ação.

   

4. Na janela Enviar um email, configure os seguintes campos necessários:

   • Para: insira pelo menos um endereço de email válido para onde os clientes potenciais serão enviados.
   • Assunto: Power Automate oferece a opção de adicionar conteúdo dinâmico, como LeadSource mostrado na tela a seguir. Comece inserindo um nome de campo. Em seguida, selecione a lista de seleção de conteúdo dinâmico na janela pop-up.

   Nota

   Ao adicionar nomes de campo, você pode seguir cada nome com dois-pontos (:) e, em seguida, selecionar Enter para criar uma nova linha. Depois de adicionar seus nomes de campo, você poderá adicionar cada parâmetro associado da lista de seleção dinâmica.

   

   • Corpo: na lista de seleção de conteúdo dinâmico, adicione as informações desejadas no corpo do email. Por exemplo, use LastName, FirstName, Email e Empresa. Quando você terminar de configurar a notificação por email, ele será semelhante ao exemplo na tela a seguir.

   

5. Selecione Salvar para concluir seu fluxo. Uma URL HTTP POST é criada e pode ser acessada na janela Quando uma solicitação HTTP é recebida. Copie essa URL usando o controle de cópia, que está localizado à direita da URL HTTP POST. Usar esse controle é importante para que você não perca nenhuma parte da URL inteira. Salve essa URL porque você precisará dela ao configurar o gerenciamento de clientes potenciais no portal de publicação.

   

Testes

Você pode testar sua configuração com uma ferramenta que pode enviar solicitações HTTP para testar sua solução, por exemplo:

• Visual Studio Code com uma extensão do Visual Studio Marketplace

• PowerShell Invoke-RestMethod

• Microsoft Edge – ferramenta console de rede

• Bruno

• Curl

  Cuidado

  Para cenários em que você tem dados confidenciais, como credenciais, segredos, tokens de acesso, chaves de API e outras informações semelhantes, use uma ferramenta que proteja seus dados com os recursos de segurança necessários, funcione offline ou localmente, não sincronize seus dados com a nuvem e não exija que você entre em uma conta online. Dessa forma, você reduz o risco de expor dados confidenciais ao público.

1. Inicie a ferramenta e selecione Nova>Solicitação para configurar sua ferramenta de teste.

2. Preencha o formulário Solicitação de Salvamento e salve na pasta que você criou.

3. Selecione POST na lista suspensa.

4. Cole a URL HTTP POST do fluxo que você criou no Power Automate, onde ele diz Inserir URL de solicitação.

5. Volte para Power Automate. Localize o fluxo que você criou para enviar clientes potenciais acessando Meus Fluxos da barra de menus do Power Automate. Selecione as reticências ao lado do nome do fluxo para ver mais opções e selecione Editar.

6. Selecione Testar no canto superior direito, selecione Vou executar a ação de gatilho e selecione Testar. Você verá uma indicação na parte superior da tela de que o teste foi iniciado.

7. Volte para sua ferramenta e selecione Enviar.

8. Volte para o seu fluxo e confira o resultado. Se tudo funcionar conforme o esperado, você verá uma mensagem que indica que o fluxo foi bem-sucedido.

9. Você também deve receber um email. Verifique sua caixa de entrada de email.

   Nota

   Se você não vir um email do teste, verifique suas pastas de spam e lixo eletrônico. Na tela a seguir, você observará apenas os rótulos de campo adicionados ao configurar a notificação por email. Se este fosse um lead real gerado com base na sua oferta, você também veria as informações reais do contato do lead no corpo e na linha do assunto.

   

Configure sua oferta para enviar clientes potenciais para o endpoint HTTPS

Quando estiver pronto para configurar as informações de gerenciamento de clientes potenciais para sua oferta no portal de publicação, siga estas etapas.

1. Entre no Partner Center.

2. Selecione sua oferta e vá para a guia Configuração da oferta.

3. Na seção Leads do cliente, selecione Conectar.

   Leads de clientes

4. Na janela pop-up Detalhes da conexão, selecione Ponto de Extremidade HTTPS como Destino do Lead. Cole a URL de POST HTTP do fluxo criado seguindo as etapas anteriores no campo URL do ponto de extremidade HTTPS.

1. Selecione OK.

Para verificar se você se conectou com êxito a um destino de cliente potencial, selecione o botão Validar. Se tiver êxito, você terá um lead de teste no destino do lead.

Nota

Você deve concluir a configuração do restante da oferta e publicá-la antes de receber clientes potenciais para a oferta.

Quando leads são gerados, a Microsoft os envia para o fluxo. Os clientes potenciais são roteados para o sistema CRM ou o endereço de email configurado.