Conectores de LMS — emita ao concluir um curso

Liga o teu LMS uma vez e todos os formandos que concluírem um curso recebem uma credencial digital verificável automaticamente — sem Zapier, sem código, sem emissão manual. Configura tudo na página Integrations do painel.

Plataformas suportadas atualmente: Thinkific e Teachable. Mais (Moodle, LearnWorlds) estão a caminho.

Como funciona

1. Crias uma ligação para o teu LMS e associas cada curso ao emblema que deve emitir.
2. O teu LMS chama um URL de webhook privado quando um formando conclui um curso.
3. O badges.ninja verifica o evento, encontra o emblema associado e emite a credencial digital ao formando — que a pode reivindicar sem conta, exatamente como qualquer outra atribuição.

Uma conclusão emite uma credencial digital. As entregas são idempotentes: se o teu LMS enviar a mesma conclusão duas vezes (tenta novamente), a emissão não é duplicada. A emissão conta para a quota de credenciais do teu plano, como qualquer outra atribuição.

Configurar uma ligação

1. No painel, abre Integrations e escolhe Add connection.
2. Escolhe a tua plataforma e dá um nome à ligação.
3. Associa os teus cursos: introduz o ID do curso no teu LMS e escolhe o emblema a emitir. Também podes definir um emblema predefinido para qualquer curso que não esteja associado.
4. Guarda. Vais ver um URL de webhook e um segredo de assinatura — são mostrados uma única vez, por isso copia-os agora e cola-os no teu LMS (passos abaixo).

Thinkific

1. No Thinkific, vai a Settings → Code & Analytics → Webhooks → New webhook.
2. Topic: enrollment.completed.
3. Target URL: o URL de webhook da tua ligação.
4. Escolhe signing secret e cola o segredo de assinatura da tua ligação. Guarda e envia 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), vai a Settings → Webhooks e adiciona um webhook.
2. Event: Enrollment.completed.
3. URL: o URL de webhook da tua ligação.
4. Como o Teachable não assina os seus webhooks, confirmamos cada conclusão na API do Teachable antes de emitir — por isso a ligação também pede a tua chave de API do Teachable. Cola-a ao criar a ligação.

Confirma que está a funcionar

Abre a ligação e expande Recent deliveries. Cada evento recebido fica registado com:

• se foi verificado,
• o tipo de evento enviado pelo teu LMS,
• o resultado — emitido ou ignorado (por exemplo, o curso não estava associado), com o motivo,
• e o payload bruto, para veres exatamente o que o teu LMS entregou.

Envia uma conclusão de teste a partir do teu LMS e vê-a chegar aqui. É a forma mais rápida de confirmar o fluxo de ponta a ponta antes de entrares em produção. Os registos de entrega são mantidos durante 7 dias.

Bom saber

• Curso não associado? O evento é registado e ignorado (sem erro devolvido ao teu LMS, por isso o webhook não será desativado). Adiciona a associação e a próxima conclusão será emitida.
• Quota atingida? O evento é registado e ignorado até a tua quota ser reposta ou fazeres upgrade.
• Pausar: define uma ligação como pausada para deixar de emitir sem apagar a sua configuração.
• Uma ligação só pode emitir emblemas da tua própria conta.

Relacionado

• Integrações (Zapier, Make e webhooks) — para gatilhos/ações além da conclusão de cursos.
• Atribuir emblemas · Partilha e verificação