Webhooks versão 2.0: configuração

Resumo

Os webhooks versão 2.0 da LearnUpon notificam você sobre alterações no curso e atividades do aluno para que você possa automatizar processos em sua organização.

Disponibilidade: depende do seu plano da LearnUpon

Entre em contato com o seu Consultor de implementação ou com o Gerente de Sucesso do Cliente para ativar os webhooks versão 2.0 em seu portal.

Consulte a documentação técnica de webhooks para novos documentos.

Os webhooks permitem que você "ouça" eventos específicos que ocorrem no portal da LearnUpon, como um aluno que concluiu um curso ou um gerente que inscreve um aluno. Depois que você configura webhooks, a LearnUpon envia avisos de eventos (os ganchos) para um URL definido, como um POST de dados JSON, com esquemas de dados definidos. Você pode usar esses avisos em seu site ou aplicativos de terceiros.

Recursos notáveis dos webhooks versão 2.0

A versão 2.0 tem como objetivo fornecer as informações certas em um webhook e evitar o envio de informações redundantes que você não precisa para concluir uma ação. Algumas alterações incluem:

• os clientes podem escolher os webhooks de que precisam para suas integrações e não receber tráfego de webhook que não usam
• enviar informações do aluno necessários e otimizados para concluir a transação do webhook e permitir que os clientes criem integrações
• enviar um único tipo de webhook para cobrir diferentes conclusões do módulo
• enviar vários webhooks do mesmo tipo em uma única carga útil. A combinação de várias conclusões de módulo em uma única mensagem fornece as mesmas informações necessárias com menos tráfego de webhook
• mover metadados para o cabeçalho, de acordo com os padrões do setor. Usar o cabeçalho de forma eficaz significa que os clientes podem verificar a integridade do webhook sem analisar o conteúdo

Permissões de acesso

• administradores com permissões totais de portal: podem configurar e acessar webhooks

Para subportais, defina os webhooks separadamente para cada portal.

Ativar webhooks no seu portal

Quando você configura webhooks como um recurso, seu URL de destino recebe os webhooks que você escolher para os acionadores de eventos que se aplicam ao conteúdo e aos usuários da LearnUpon.

1. No menu de navegação principal, vá para Configurações > Integrações > Webhooks v2.
2. 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
3. Selecione os ganchos necessários para seus processos automatizados.
4. Clique em Salvar para concluir.

A captura de tela a seguir mostra a interface webhooks v2 na LearnUpon.

Consulte:

• Categoria Criar integrações personalizadas