Usar um ponto de extremidade HTTPS para gerenciar leads comerciais do mercado

Se o seu sistema de gestão de relacionamento com o cliente (CRM) não tiver suporte explícito no Partner Center para receber leads do Microsoft AppSource e do Azure Marketplace, você poderá usar um ponto de extremidade HTTPS no Power Automate para lidar com esses leads. Com um ponto de extremidade HTTPS, os leads do mercado comercial podem ser enviados como uma notificação por e-mail ou podem ser gravados em um sistema CRM suportado pelo Power Automate.

Este artigo explica como criar um novo fluxo no Power Automate para gerar o HTTP POST URL que você usará para configurar leads no Partner Center. Também inclui passos para testar o seu fluxo com o Postman.

Nota

O conector Power Automate utilizado nestas instruções requer uma subscrição paga do Power Automate. Certifique-se de levar isso em conta antes de configurar esse fluxo.

Criar um fluxo usando o Power Automate

  1. Abra a página Web Power Automatic . Selecione Iniciar sessão. Se ainda não tiver uma conta, selecione Inscrever-se gratuitamente para criar uma.

  2. Inicie sessão, selecione Os meus fluxos e mude o Ambiente da Microsoft (predefinição) para o seu Ambiente Dataverse (CRM).

    Shows how to sign in to 'My flows.'

  3. Em + Novo, selecione + Fluxo instantâneo na nuvem.

    Shows how to select My flows, followed by Instant cloud flow.

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

    Shows how to build an automated flow window Skip button.

  5. Clique na etapa de fluxo para expandi-la.

    Shows how to expand the flow step.

  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 Utilize a amostra de payload para gerar o esquema. Na caixa de texto Digite ou cole um exemplo de carga JSON de exemplo, cole no 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 de 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 optar por se conectar a um sistema CRM ou configurar uma notificação por e-mail. Siga as restantes instruções com base na sua escolha.

Conectar-se a um sistema CRM

  1. Selecione + Novo passo.

  2. Procure 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.

    Shows how to create a new record.

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

    Shows how to select 'Create a new record.'

  4. Selecione lead na lista suspensa Nome da tabela.

    Shows how to select leads.

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

    Shows how to add dynamic content.

  6. Mapeie os campos desejados e selecione Salvar para salvar o fluxo. Um HTTP POST URL é criado e pode ser acessado na janela Quando uma solicitação HTTP é recebida . Copie este URL usando o controle copy, que está localizado à direita do HTTP POST URL. Usar o controle de cópia é importante para que você não perca nenhuma parte de toda a URL. Salve essa URL porque você precisará dela quando configurar o gerenciamento de leads no portal de publicação.

    Shows when an HTTP request is received.

Configurar notificação por e-mail

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

  2. Em Escolha 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 e-mail diferente, procure e selecione Enviar uma notificação por e-mail (Mail) como a ação.

    Add an email action

  4. Na janela Enviar um e-mail, configure os seguintes campos obrigatórios:

    • Para: Digite pelo menos um endereço de e-mail válido para onde os leads serão enviados.
    • Assunto: Power Automate dá-lhe a opção de adicionar conteúdo dinâmico, como LeadSource mostrado na tela seguinte. Comece por introduzir um nome de campo. Em seguida, selecione a lista de seleção de conteúdo dinâmico na janela pop-up.

    Nota

    Quando adiciona nomes de campos, pode seguir cada nome com dois pontos (:) e, em seguida, selecionar Enter para criar uma nova linha. Depois de adicionar os nomes dos campos, você pode adicionar cada parâmetro associado da lista de opções dinâmicas.

    Add an email action by using dynamic content

    • Corpo: Na lista de seleção de conteúdo dinâmico, adicione as informações desejadas no corpo do e-mail. Por exemplo, use LastName, FirstName, Email e Company. Quando terminar de configurar a notificação por e-mail, ela se parece com o exemplo na tela a seguir.

    Email notification example

  5. Selecione Salvar para concluir o fluxo. Um HTTP POST URL é criado e pode ser acessado na janela Quando uma solicitação HTTP é recebida . Copie este URL usando o controle copy, que está localizado à direita do HTTP POST URL. Usar esse controle é importante para que você não perca nenhuma parte de toda a URL. Salve essa URL porque você precisará dela quando configurar o gerenciamento de leads no portal de publicação.

    HTTP POST URL

Testar

Você pode testar sua configuração com o Postman. Um download on-line do Postman está disponível para Windows.

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

    Request to set up your test tool

  2. Preencha o formulário Salvar solicitação e salve na pasta que você criou.

    Save Request form

  3. Selecione POST na lista suspensa.

    Test my flow

  4. Cole o HTTP POST URL do fluxo que você criou no Power Automate onde diz Enter request URL.

    Paste the HTTP POST URL

  5. Volte para Power Automate. Encontre o fluxo que você criou para enviar leads acessando Meus Fluxos na barra de menus Power Automatic. 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 Executarei a ação de gatilho e, em seguida, selecione Testar. Você verá uma indicação na parte superior da tela de que o teste começou.

    I'll perform the trigger action option

  7. Volte para o aplicativo Postman e selecione Enviar.

    Send button

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

    Check results

  9. Você também deve ter recebido um e-mail. Verifique a sua caixa de entrada de e-mail.

    Nota

    Se você não vir um e-mail do teste, verifique suas pastas de spam e lixo eletrônico. Na tela seguinte, você notará apenas os rótulos de campo que adicionou quando configurou a notificação por e-mail. Se este fosse um lead real gerado a partir da sua oferta, você também veria as informações reais do contato do lead no corpo e na linha de assunto.

    Email received

Configure sua oferta para enviar leads para o ponto de extremidade HTTPS

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

  1. Inicie sessão no Centro de Parceiros.

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

  3. Na seção Leads de clientes, selecione Conectar.

    Customer leads

  4. Na janela pop-up Detalhes da conexão, selecione Ponto de extremidade HTTPS para o destino principal. Cole o HTTP POST URL do fluxo que você criou seguindo as etapas anteriores no campo URL do ponto de extremidade HTTPS. Connection details Contact email.

  5. Selecione OK.

Para se certificar de que se ligou com êxito a um destino de lead, selecione o botão Validar . Se for bem-sucedido, você terá um lead de teste no destino principal.

Nota

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

Quando os leads são gerados, a Microsoft envia leads para o fluxo. Os leads são encaminhados para o sistema CRM ou endereço de e-mail que você configurou.