Resumo
Use webhooks na LearnUpon para rastrear as atividades do aluno automaticamente.
Esse recurso está disponível dependendo do seu plano da LearnUpon.
Os webhooks permitem que você “ouça” eventos específicos que ocorrem na LearnUpon, como um aluno que concluiu um curso ou reprovou em um teste.
Depois que você ativar o recurso de webhook, a LearnUpon enviará avisos de eventos (os ganchos) como dados JSON via POST com esquemas de dados definidos para um URL fornecido por você. Você pode usar esses avisos em um site ou aplicativos de terceiros.
A LearnUpon habilita esse recurso mediante solicitação. Se você não conseguir ver a opção disponível em seu portal, entre em contato com a equipe de suporte.
Consulte a documentação técnica de webhooks.
Permissões de acesso
Somente administradores com permissões de portal completas podem configurar e acessar webhooks.
Ativar webhooks no seu portal
Quando você configura webhooks como um recurso, seu URL de destino recebe todos os webhooks para todos os acionadores de eventos que se aplicam ao conteúdo e aos usuários da LearnUpon. Não é possível ativar um único tipo de webhook.
- No menu de navegação principal, vá para Configurações > Integrações > Webhooks.
- Em Configurações:
- selecione Ativar Webhooks para suas ações no portal?
- insira um URL do ponto de extremidade para a LearnUpon enviar seus eventos do webhook: por exemplo,
https://www.mysite.com/webhook/listening/action - Opcional: defina uma Chave secreta compartilhada para verificar os dados JSON provenientes dos webhooks da LearnUpon.
- Clique em Salvar para concluir.
Revisar os webhooks manualmente dentro do portal
A LearnUpon mantém todos os webhooks enviados pelo aplicativo por 30 dias. Como opção de solução de problemas, você pode revisar webhooks enviados para o URL do ponto de extremidade.
Você pode filtrar os webhooks para mostrar aqueles com um status específico de Concluído ou Pendente/Falha e para mostrar um tipo de webhook por vez.
O status do webhook não está relacionado a nenhum status de inscrição em um módulo ou curso. Ele descreve apenas se a LearnUpon enviou com êxito o webhook para o URL do ponto de extremidade ou não.
- No menu de navegação principal, vá para Configurações > Integrações > Webhooks.
- Em Ações, selecione Visualizar webhooks para ver os webhooks enviados para o URL do ponto de extremidade nos últimos 30 dias.
- Opcional: filtre os webhooks por
- Status: Concluído ou Pendente/Falha
- Tipo: selecione o tipo de webhook na lista suspensa
- Para visualizar o conteúdo de um webhook individual, selecione o texto do link Tipo de webhook.
A captura de tela a seguir mostra uma lista de webhooks em um portal de exemplo com status Concluído e tipo Módulo concluído.
Consulte: