Usar um ponto de extremidade HTTPS para gerir leads comerciais no 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 de 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.
Observação
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 da Web do Power Automate. Selecione Entrar. Se ainda não tiver uma conta, selecione Inscrever-se gratuitamente para criar uma.
Inicie sessão, selecione Os meus fluxose mude o Ambiente de Microsoft (predefinição) para o seu Ambiente Dataverse (CRM).
Em + Novo, selecione + Fluxo instantâneo na nuvem.
Nomeie seu fluxo e, em seguida, em Escolha como acionar esse fluxo, selecione Quando uma solicitação HTTP for recebida.
Selecione o passo do fluxo para o expandir.
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 carga útil de exemplo para gerar o esquema. Na caixa de texto Inserir ou colar um exemplo de payload 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" }
Observação
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 + Nova etapa.
Procure e selecione um sistema CRM na caixa Conectores de pesquisa 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 de leads 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. O ecrã a seguir mostra OfferTitle como exemplo.
Mapeie os campos desejados e selecione Guardar para guardar o seu 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.
No separador Ações, selecione Enviar um e-mail (Office 365 Outlook).
Observação
Se quiser usar um provedor de e-mail diferente, pesquise e selecione Enviar uma notificação por e-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 oferece a opção de adicionar conteúdo dinâmico, como LeadSource mostrado na tela a seguir. Comece por introduzir um nome de campo. Em seguida, selecione a lista de seleção de conteúdo dinâmico na janela pop-up.
Observação
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 Guardar 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.
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
-
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 Novo>Pedido para configurar a sua ferramenta de teste.
Preencha o formulário Guardar Pedido e, em seguida, guarde na pasta que criou.
Selecione POST na lista suspensa.
Cole o HTTP POST URL do fluxo que você criou no Power Automatic, onde ele diz Digite a URL da solicitação.
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 Teste no canto superior direito, selecione Vou executar a acção de gatilhoe depois selecione Teste . 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.
Observação
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, também veria as informações reais do contato do lead no corpo e no assunto do e-mail.
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 Partner Center.
Selecione a sua oferta e vá para o separador Configuração da oferta.
Na seção de leads de clientes, selecione Conectar.
Na janela pop-up Detalhes da Conexão, selecione Ponto de Extremidade HTTPS para o Destino de Lead. Cole o URL de HTTP POST no campo URL do ponto de extremidade HTTPS do fluxo que criou seguindo as etapas anteriores.
- Selecione OK.
Para se certificar de que se conectou 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.
Observação
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-os para o fluxo. Os leads são encaminhados para o sistema CRM ou endereço de e-mail que você configurou.