Exercício sobre webhooks
Saiba como criar, acionar e gerenciar cenários iniciados por webhook.
Visão geral do exercício
O objetivo deste cenário é criar um aplicativo a ser vendido para lojas de conveniência para que elas possam determinar facilmente se um(a) cliente tem ou não idade suficiente para comprar bebidas alcoólicas. O(a) operador(a) do caixa precisa apenas registrar o nome e a data de nascimento do(a) cliente em um URL fornecido. Isso acionará o cenário que calculará a resposta e a retornará ao solicitante.
-
O cenário consiste em três webhooks.
-
O módulo acionador é um webhook personalizado que escuta a publicação.
-
Ao receber uma publicação, ela será enviada para um dos próximos módulos.
-
O módulo seguinte retorna uma resposta ao solicitante.
Etapas a serem seguidas
Configure o webhook do acionador.
-
Crie um novo cenário e nomeie-o como “Usar webhooks”.
-
Para o acionador, adicione o módulo de webhook personalizado do aplicativo Webhooks.
-
Clique em Adicionar para criar um novo webhook.
-
Digite o nome de webhook “Aplicativo de idade para beber”.
-
Deixe as restrições de IP em branco, o que significa que qualquer pessoa pode enviar dados para ele.
-
Clique em Salvar.
-
De volta ao painel de mapeamento de webhooks, um URL foi criado para este webhook específico. Clique em “Copiar endereço para a área de transferência” para copiar esse URL.
-
Clique em OK.
-
Clique em Executar uma vez.
-
Use o URL no Postman para enviar um nome e data de nascimento para seu webhook personalizado. Para obter instruções sobre como configurar o Postman, consulte o tutorial Passo a passo dos webhooks.
O painel do módulo Webhooks deve ter esta aparência:
O webhook agora estará acompanhando os dados para determinar a estrutura deles.
-
Você pode definir a estrutura de dados do conteúdo que espera obter (as estruturas de dados serão discutidas posteriormente). Se você não definir uma estrutura de dados, o Fusion determinará a estrutura de dados automaticamente quando a publicação for enviada.
-
No Postman, envie para o URL copiado. A publicação deve incluir dados básicos de formulário. Para este exemplo, você precisa de três campos: Nome, Data de nascimento e clientToken.
-
Depois de clicar em Enviar do Postman, você deverá receber uma indicação de que a publicação foi aceita.
-
Esse é o ponto em que o cenário mostrará que a estrutura de dados foi determinada com sucesso.
-
Você pode ver que os dados foram recebidos abrindo o inspetor de execução.
Configurar roteamento para tokens de cliente.
-
Adicione um roteador ao módulo acionador.
-
No caminho superior, adicione um módulo de resposta de webhook. Esse será o nosso caminho para quando o token do cliente não corresponder.
-
Defina o status como 401.
-
Defina o corpo como {"error": "Failed to authenticate request. Please check your clientToken"}.
-
Crie um filtro entre o roteador e o módulo de resposta do webhook. Nomeie-o como “O token de cliente não corresponde.”
-
Para a Condição, use o campo clientToken do módulo acionador e faça uma comparação numérica “Diferente de” com o número 5121933.
-
No caminho inferior, adicione outro módulo de resposta de webhook. Esse será o nosso caminho para quando o token de cliente corresponder.
-
Defina o status como 200.
-
Ao configurar o Corpo, use as funções do painel de mapeamento para testar se a pessoa tem 21 anos ou mais. Se tiverem, retorne “Você tem idade suficiente para beber!”, caso contrário, retorne “Você está sem sorte…”
-
Crie um filtro entre o roteador e o módulo de resposta do webhook no caminho inferior. Nomeie-o como “O token de cliente corresponde.”
-
Para a Condição, use o campo clientToken do módulo acionador e faça uma comparação numérica “Igual a” com o número 5121933.
-
Clique no botão Agendamento em Executar uma vez para ativar seu cenário para que sempre que houver uma nova publicação ela seja recebida, siga qualquer caminho e gere uma resposta.