Skip to content

Conectores de LMS — emita ao concluir um curso ​

Conecte seu LMS uma vez e todo aluno que concluir um curso recebe uma credencial digital verificável automaticamente — sem Zapier, sem código, sem emissão manual. Configure tudo na página Integrations do painel.

Plataformas compatíveis hoje: Thinkific e Teachable. Mais (Moodle, LearnWorlds) estão a caminho.

Como funciona ​

  1. Você cria uma conexão para o seu LMS e associa cada curso ao emblema que ele deve emitir.
  2. Seu LMS chama uma URL de webhook privada quando um aluno conclui um curso.
  3. O badges.ninja verifica o evento, encontra o emblema associado e emite a credencial digital para o aluno — que pode resgatá-la sem conta, exatamente como qualquer outra concessão.

Uma conclusão emite uma credencial digital. As entregas são idempotentes: se o seu LMS enviar a mesma conclusão duas vezes (eles tentam de novo), a emissão não será duplicada. A emissão conta para a cota de credenciais do seu plano, como qualquer outra concessão.

Configure uma conexão ​

  1. No painel, abra Integrations e escolha Add connection.
  2. Escolha sua plataforma e dê um nome à conexão.
  3. Associe seus cursos: informe o ID do curso no seu LMS e escolha o emblema a emitir. Você também pode definir um emblema padrão para qualquer curso que não esteja associado.
  4. Salve. Você verá uma URL de webhook e um segredo de assinatura — eles são exibidos uma única vez, então copie-os agora e cole no seu LMS (passos abaixo).

Thinkific ​

  1. No Thinkific, acesse Settings → Code & Analytics → Webhooks → New webhook.
  2. Topic: enrollment.completed.
  3. Target URL: a URL de webhook da sua conexão.
  4. Escolha signing secret e cole o segredo de assinatura da sua conexão. Salve e envie um teste.

O Thinkific assina cada entrega, e nós verificamos a assinatura antes de emitir.

Teachable ​

  1. No Teachable (plano Growth ou superior, necessário para webhooks), acesse Settings → Webhooks e adicione um webhook.
  2. Event: Enrollment.completed.
  3. URL: a URL de webhook da sua conexão.
  4. Como o Teachable não assina seus webhooks, confirmamos cada conclusão na API do Teachable antes de emitir — por isso a conexão também pede a sua chave de API do Teachable. Cole-a ao criar a conexão.

Confirme que está funcionando ​

Abra a conexão e expanda Recent deliveries. Cada evento recebido é registrado com:

  • se foi verificado,
  • o tipo de evento que seu LMS enviou,
  • o resultado — emitido ou ignorado (por exemplo, o curso não estava associado), com o motivo,
  • e o payload bruto, para você ver exatamente o que seu LMS entregou.

Envie uma conclusão de teste do seu LMS e veja-a chegar aqui. É a maneira mais rápida de confirmar o fluxo de ponta a ponta antes de entrar em produção. Os logs de entrega são mantidos por 7 dias.

Bom saber ​

  • Curso não associado? O evento é registrado e ignorado (sem erro de volta para o seu LMS, então o webhook não será desativado). Adicione a associação e a próxima conclusão será emitida.
  • Cota atingida? O evento é registrado e ignorado até a sua cota ser renovada ou você fazer upgrade.
  • Pausar: defina uma conexão como pausada para parar de emitir sem apagar a configuração.
  • Uma conexão só pode emitir emblemas da sua própria conta.

Relacionado ​

badges.ninja Documentation