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.
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
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.
Inicie sessão, selecione Os meus fluxos e mude o Ambiente da Microsoft (predefinição) para o seu Ambiente Dataverse (CRM).
Em + Novo, selecione + Fluxo instantâneo na nuvem.
Nomeie seu fluxo e, em Escolha como acionar esse fluxo, selecione Quando uma solicitação HTTP for recebida.
Selecione a etapa de fluxo para expandi-la.
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
Selecione + Novo passo.
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.
Selecione a guia Ações com a ação para Adicionar uma nova linha.
Selecione lead na lista suspensa Nome da tabela.
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.
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.
Configurar notificação por e-mail
Agora que você terminou o esquema JSON, selecione + Nova etapa.
Em Escolha uma ação, selecione Ações.
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.
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.
- 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.
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.
Testar
Você pode testar sua configuração com uma ferramenta que pode enviar solicitações HTTP para testar sua solução, por exemplo:
Código do Visual Studio com uma extensão do Visual Studio Marketplace
-
Atenção
Para cenários em que você tem dados confidenciais, como credenciais, segredos, tokens de acesso, chaves de API e outras informações semelhantes, certifique-se de usar 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 exposição de dados confidenciais ao público.
Inicie a ferramenta e selecione Nova>solicitação para configurar sua ferramenta de teste.
Preencha o formulário Salvar solicitação e salve na pasta que você criou.
Selecione POST na lista suspensa.
Cole o HTTP POST URL do fluxo que você criou no Power Automate onde diz Enter request URL.
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.
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.
Volte à sua ferramenta e selecione Enviar.
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.
Você também deve receber 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.
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.
Inicie sessão no Centro de Parceiros.
Selecione sua oferta e vá para a guia Configuração da oferta .
Na seção Leads de clientes, selecione Conectar.
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.
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.