Exercício: implementar um gatilho de webhook

  • 10 minutos

Neste exercício, você adicionará um gatilho de webhook ao conector personalizado para uma API da Contoso Invoicing.

Importante

Use um ambiente de teste com o Microsoft Dataverse provisionado. Se você não tiver um, poderá se inscrever no plano da comunidade.

Observação

Baixe o arquivo a seguir no computador local para fazer este exercício Contoso Invoicing Triggers. Selecione o botão download no meio à direita da tela.

Tarefa 1: Importar uma solução com o conector personalizado

Nesta tarefa, você importará uma solução não gerenciada contendo um conector personalizado predefinido para a API do Contoso Invoicing.

  1. Vá para o Power Apps Maker Portal e verifique se está no ambiente correto.

  2. Selecione Soluções > Importar solução.

  3. Selecione Procurar.

  4. Selecione a solução ContosoInvoicingTriggers_1_0_0_0.zip e, em seguida, clique em Abrir.

  5. Selecione Avançar.

  6. Selecione Importar e aguarde a conclusão da importação. Uma mensagem de êxito deve aparecer após a conclusão da importação.

  7. Selecione Publicar Todas as Personalizações e aguarde o término da publicação.

  8. Selecione para abrir a solução Contoso invoicing triggers que você importou. Você deve ver o componente do conector personalizado Contoso Invoicing Triggers.

    Captura de tela de Contoso Invoicing Triggers realçado.

  9. Em uma nova guia, vá para Contoso Invoicing.

  10. Selecione o link Chave de API.

    Captura da tela do link da Chave de API realçada.

  11. Copie a Chave de API e mantenha-a em um bloco de notas. Você a usará algumas vezes neste exercício.

  12. Retorne ao Power Apps Maker Portal e verifique se está no ambiente.

  13. Escolha Soluções e selecione para abrir a solução Contoso Invoicing Triggers.

  14. Selecione para abrir o conector personalizado de Contoso Invoicing Triggers.

  15. Selecione Editar.

    Captura de tela de uma seta apontando para o botão do conector de edição.

  16. Insira o contosoinvoicing.azurewebsites.net para Host.

  17. Selecione Atualizar conector.

  18. Selecione Testar > + Nova Conexão.

    Captura de tela de uma seta apontando para o botão para adicionar nova conexão.

  19. Cole a Chave de API e, em seguida, selecione Criar conexão.

    Captura de tela do botão Criar conexão.

  20. Selecione Atualizar. A conexão criada deve ser selecionada automaticamente.

  21. Role até a seção Operações, selecione ListInvoices e Testar operação.

    Captura de tela de uma seta apontando para o botão testar operação.

    Você verá uma lista de faturas na seção Corpo.

    Captura de tela de uma lista de faturas na seção Corpo.

  22. Não saia desta página.

Tarefa 2: Adicionar um gatilho de webhook

Siga estas etapas para adicionar um gatilho de webhook:

  1. Selecione Definição.

    Captura de tela da guia Definição selecionada.

  2. Role até a seção Gatilhos e selecione + Novo gatilho.

  3. Forneça os seguintes valores:

    • Resumo: Quando a Fatura é Criada

    • Descrição: Quando a Fatura é Criada

    • ID da Operação: InvoiceCreated

    • Tipo do gatilho: Webhook

    Captura de tela dos novos valores de gatilho para Resumo, Descrição, ID da operação e Tipo de gatilho.

  4. Vá para a seção Solicitação e selecione + Importar da amostra.

    Captura de tela de uma seta apontando para o botão Importar da amostra.

  5. Forneça os valores a seguir e selecione Importar. Com outras APIs, você obteria o exemplo da documentação da API.

    • Verbo: POST

    • URL - https://contosoinvoicing.azurewebsites.net/NewInvoiceNotification/

      Observação

      Inclua a barra à direita na URL.

    • Corpo

        {
  "targetUrl":"https://webhook.site"
  }

    Captura de tela das propriedades da amostra de solicitação.

  6. Vá até a Configuração do gatilho e selecione targetUrl para parâmetro de URL de Retorno de Chamada. Essa seleção permite que o targetUrl seja preenchido no tempo de execução pelo conector personalizado.

    Captura de tela da janela do gatilho de confirmação.

  7. Role para cima até a seção Solicitação, selecione Corpo e, em seguida, clique em Editar.

    Captura de tela de uma seta apontando para o botão editar corpo.

  8. Selecione targetUrl e, em seguida, escolha Editar.

    Captura de tela de uma seta apontando para o botão editar URL de destino.

  9. Selecione Sim para É obrigatório e selecione interno para Visibilidade.

    Captura de tela dos campos de propriedades do URL de destino.

  10. Selecione o botão Voltar.

    Captura de tela de uma seta apontando para o botão voltar.

  11. Selecione o botão Voltar novamente.

  12. Role até a seção Resposta do Webhook, insira Fatura para a Descrição e selecione + Importar da amostra. A resposta do webhook define o que será enviado ao fluxo quando ocorrer o evento de acionamento.

    Captura de tela de uma seta apontando para o botão de resposta de amostra de importação.

  13. Cole a amostra JSON a seguir no campo Corpo e selecione Importar.

     {
 "invoiceId": "1933",
 "date": "2021-01-26T04:02:52.1490835+00:00",
 "amount": 5000,
 "accountId": "1001",
 "accountName": "Wing Tips",
 "status": "Invoiced",
 "typeId": 1,
 "purchaseOrderId": "3002",
 "tags": "New Account;Special Pricing"
 }

    Captura de tela dos detalhes das propriedades de importação de resposta.

  14. Selecione Atualizar conector.

    Observação

    Se você receber uma mensagem de erro sobre "todos os caminhos devem começar com '/'," abra o Swagger, localize a linha que contém ":{} e, em seguida, exclua-a.

  15. Selecione Fechar.

Tarefa 3: Testar o gatilho

  1. Vá para o Power Apps Maker Portal e verifique se está no ambiente.

  2. Escolha Soluções e abra a solução Contoso Invoicing Triggers.

  3. Selecione + Novo > Automação > Fluxo da nuvem > Instantâneo.

  4. Insira Criar fatura para o nome, selecione Disparar manualmente um fluxo em Gatilhos e selecione Criar.

    Captura de tela de uma seta apontando para o gatilho Disparar um fluxo manualmente.

  5. Expanda o gatilho e selecione + Adicionar uma entrada.

  6. Selecione Número para o tipo de entrada.

    Captura de tela de uma seta apontando para o tipo de entrada de Número.

  7. Insira Valor para o nome de entrada e selecione + Nova etapa.

    Captura de tela de uma seta apontando para o botão adicionar nova etapa do fluxo.

  8. Escolha a guia Personalizado e selecione o conector personalizado Contoso invoicing.

    Captura de tela de uma seta apontando para o conector personalizado.

  9. Selecione a ação Adicionar Fatura.

  10. Insira Conexão da Contoso no campo Nome da Conexão, cole a Chave de API que você copiou na Tarefa 1: Importar uma solução com o conector personalizado e selecione Criar. Use a mesma chave de API nos dois fluxos ou o seu fluxo de gatilhos não será executado.

    Captura de tela do botão de criação de conexão.

  11. Selecione o campo valor e selecione Valor no painel Conteúdo dinâmico.

    Captura de tela da saída do campo de valor da etapa anterior.

  12. Selecione Salvar.

  13. Selecione o botão voltar <.

  14. Verifique se você ainda está na solução Contoso Invoicing - Triggers.

  15. Selecione + Novo > Automação > Fluxo da nuvem > Automatizado.

  16. Insira Notificação de Fatura para o Nome do fluxo e selecione Ignorar.

  17. Escolha a guia Personalizado e selecione o conector personalizado Contoso invoicing.

    Captura de tela de uma seta apontando para o gatilho do conector personalizado.

  18. Selecione o gatilho Quando a Fatura é Criada.

  19. Selecione +Nova etapa.

  20. Procure Redigir e, em seguida, selecione a ação Redigir.

  21. Selecione o campo Entradas e, em seguida, selecione corpo no painel Conteúdo dinâmico.

    Captura de tela do campo Entradas e corpo do painel de Conteúdo dinâmico.

  22. Selecione Salvar.

  23. Selecione Testar.

  24. Selecione Manualmente > Testar. O fluxo será iniciado e você deverá esperar por notificações.

  25. Abra uma nova janela do navegador e navegue até https://make.powerapps.com/

  26. Verifique se você selecionou o ambiente correto.

  27. Selecione Soluções e abra Contoso Invoicing - Triggers

  28. Abra o fluxo da nuvem Criar fatura.

  29. Selecione Editar.

  30. Selecione Testar.

  31. Selecione Manualmente > Testar.

  32. Selecione Continuar.

  33. Insira 5500 para Valor e selecione Executar fluxo.

  34. Selecione Concluído.

  35. Alterne para o fluxo Notificação da Fatura. O fluxo deve ser executado com sucesso.

  36. Selecione para expandir a ação Redigir.

    Captura de tela de uma seta apontando para a ação Redigir.

    As Entradas e Saídas devem mostrar o valor fornecido no fluxo Criar fatura.

    Captura de tela das entradas e saídas da ação Redigir.