Pular para o conteúdo principal

Integrar o POK ao Moodle usando LTI

Para integrar o POK Proof of Knowledge ao Moodle via LTI, registre a integração no seu painel do POK, configure uma ferramenta externa no Moodle e depois adicione uma atividade de credencial aos seus cursos. Com a conexão feita, o POK pode emitir credenciais para seus alunos automaticamente, por exemplo quando eles são aprovados em uma avaliação. Os passos exatos no Moodle dependem da sua versão: 3.9 ou anterior, ou 3.10 e mais recentes.

Este guia cobre a integração via URL LTI. O POK também oferece uma integração baseada em API por meio do plugin do POK para Moodle.

Iniciar a integração a partir do POK​

  1. Acesse a seção Integrações no seu painel do POK.
  2. Na lista de plataformas disponíveis, selecione Moodle.
  3. Dê um nome que identifique a integração (por exemplo, "Moodle Graduação 2025").
  4. Selecione o tipo de integração. Para este guia, escolha Integração via URL LTI.
  5. Na próxima tela, indique a versão do Moodle que você usa, pois os passos variam conforme a versão:
    • Tenho Moodle 3.9 ou uma versão anterior
    • Tenho Moodle 3.10 ou uma versão mais recente
dica

Não sabe qual versão você usa? Veja como verificar a versão do seu Moodle.

Se você tem Moodle 3.9 ou versão anterior​

Para essa versão, o POK pede três valores do Moodle: o Platform ID, o Client ID e um Web Service Token. As seções abaixo mostram onde obter cada um.

Obter o Platform ID e o Client ID​

  1. No Moodle, acesse Site administration > Plugins > Activity modules > Manage tools.

  2. Clique em Configure a tool manually.

  3. Preencha o formulário com os seguintes valores:

    • Tool name: um nome que identifique a ferramenta.
    • Tool URL: https://lti.pok.tech/lti/launch
    • LTI version: 1.3
    • Public key type: Keyset URL
    • Public keyset: https://lti.pok.tech/.well-known/lti-jwks.json
    • Initiate login URL: https://lti.pok.tech/lti/login
    • Redirection URI(s): https://lti.pok.tech/lti/launch
    • Custom parameters:
    course_id=$Context.id
    person_timezone=$Person.address.timezone
    course_section_label=$CourseSection.label
    person_locality=$Person.address.locality
    user_name=$User.username
    person_full_name=$Person.name.full
    course_title=$Context.title
    person_family_name=$Person.name.family
    course_offering_label=$CourseOffering.label
    person_postal_code=$Person.address.postcode
    course_offering_title=$CourseOffering.title
    person_state_region=$Person.address.statepr
    person_name_prefix=$Person.name.prefix
    person_given_name=$Person.name.given
    course_label=$Context.label
    user_timezone=$Person.address.timezone
    person_middle_name=$Person.name.middle
    course_section_title=$CourseSection.title
    person_country=$Person.address.country
    user_id=$User.id
    source_course_id=$Course.id
    person_name_suffix=$Person.name.suffix

  4. Clique em Salvar alterações.

  5. Na lista de ferramentas criadas, clique no menu de 3 pontos e depois em Tool configuration details.

  6. Copie o Platform ID e o Client ID exibidos.

Gerar o Web Service Token​

Para obter o token, primeiro habilite os web services no Moodle:

  1. Acesse Site administration > Advanced features e marque Enable web services.
  2. Em Site administration > Plugins > Web services > Manage protocols, verifique se o protocolo REST está ativado (o ícone do olho está visível).
  3. Acesse Web services > External services e crie um novo serviço:
    • Dê um nome (por exemplo, "POK External Service").
    • Marque Enable.
    • Clique em Add service.
  4. Clique em Add functions e adicione estas duas funções:
    • core_course_get_contents
    • gradereport_user_get_grade_items
  5. Salve as funções.
  6. Em Web services > Manage tokens, clique em Add:
    • Escolha um usuário administrador.
    • Selecione o serviço que você acabou de criar.
    • Clique em Salvar alterações e copie o token gerado.

Concluir a integração no POK​

  1. Volte ao POK.
  2. Cole o Platform ID, o Client ID e o Web Service Token.
  3. Clique em Confirmar para finalizar a instalação.

Se você tem Moodle 3.10 ou versão mais recente​

Para essa versão, o POK pede:

  • URL do Moodle (por exemplo, https://meudominio.moodle.edu)
  • Web Service Token: gere o token seguindo os passos de Gerar o Web Service Token.

Em seguida:

  1. Preencha os dois campos no POK.
  2. Clique em Confirmar para avançar para a próxima tela.
  3. Copie a URL dinâmica LTI exibida pelo POK.

Adicionar a ferramenta LTI dinâmica no Moodle​

  1. Acesse Site administration > Plugins > External tool > Manage tools.
  2. Cole a Tool URL copiada do POK.
  3. Clique em Add LTI Advantage para completar o registro.

Se o Moodle mostrar Integration process failed (POST_REGISTRATION_ERROR) neste passo, veja como resolver o erro POST_REGISTRATION_ERROR.

Pronto. Agora você pode usar a integração com o Moodle para emitir credenciais automáticas nos seus cursos.

Configurar a atividade POK Credential no curso​

Com a integração concluída, adicione a atividade POK Credential aos seus cursos Moodle para emitir credenciais aos alunos de forma automática ou manual.

Adicionar a atividade de ferramenta externa​

  1. Na sua conta de administrador, acesse Administração do site > Cursos > Gerenciar cursos e categorias.
  2. Selecione o curso e clique em Ver para editar o conteúdo.
  3. No canto superior direito, ative o modo de edição.
  4. Clique em Adicionar uma atividade ou recurso.
  5. Selecione a atividade Ferramenta externa.
  6. Em Nome da atividade, digite um nome que identifique a atividade.
  7. Em Ferramenta pré-configurada, selecione a ferramenta do POK configurada durante a integração.
  8. Em Launch container, recomendamos selecionar Nova janela para uma melhor experiência visual.
  9. Clique em Salvar e voltar ao curso.

Configurar a emissão da credencial​

Depois de salvar a atividade, clique nela para abrir a configuração LTI e preencha o formulário:

  • Selecione o design da credencial.
  • Vincule uma página personalizada e um roteiro de aprendizagem (opcional).
  • Defina se a credencial terá data de expiração.
  • Mapeie os atributos personalizados do design com os dados disponíveis do aluno.
  • Escolha o tipo da credencial: básica ou blockchain.
  • Defina o idioma do e-mail que o aluno receberá.

Opção A: emitir automaticamente com base em uma avaliação​

Se você quer que a credencial seja emitida automaticamente quando o aluno for aprovado em uma avaliação:

  1. Selecione a avaliação do curso que servirá de base.
  2. Informe a nota mínima que o aluno precisa alcançar para acionar a emissão.
  3. Defina a data de emissão: as credenciais são geradas nessa data para todos os alunos que cumprirem o requisito.

Opção B: sem condições de emissão​

Se preferir não definir pré-requisitos, pule a opção A. Nesse caso, os alunos podem abrir o item da credencial dentro do curso e gerá-la manualmente.

Salvar a configuração​

  1. Clique em Salvar configuração da credencial.
  2. Revise a pré-visualização exibida com os dados carregados.
  3. Clique em Salvar para aplicar as alterações.

Sua credencial POK fica configurada e pronta para ser emitida automaticamente ou sob demanda, conforme a sua seleção.

Ver a lista de credenciais​

Depois de configurar uma credencial em um curso Moodle, você pode verificar o status, enviá-la manualmente aos alunos que cumprirem os critérios e editar a configuração quando necessário.

Para abrir a lista, clique no item da credencial dentro do módulo do curso. Ela mostra o status de cada aluno e, a partir dela, você pode ver e gerenciar a emissão.

O que significa cada status​

  • Pendente: a credencial ainda não foi gerada nem enviada ao aluno.
  • Enviado: a credencial foi gerada e o aluno recebeu um e-mail com o link para aceitá-la.
  • Aceito: o aluno aceitou a credencial pelo e-mail e ela foi emitida com sucesso.

Enviar credenciais manualmente​

Você pode enviar credenciais a qualquer momento para os alunos que cumprirem os critérios definidos:

  1. Clique no botão Enviar.
  2. As credenciais são enviadas apenas aos alunos com status Pendente.
  3. Alunos que já estão com status Enviado ou Aceito não recebem a credencial novamente.

Editar uma credencial​

Para modificar uma credencial já configurada, clique em Configurar emissão. Você pode atualizar:

  • Os dados visíveis na credencial.
  • As condições de emissão automática (nota mínima, data de emissão, etc.).

Se tiver alguma dúvida, escreva para contact@pok.tech

Saiba mais​

Para saber como as integrações LTI da POK se conectam com o seu LMS e outros sistemas, acesse a página da funcionalidade de integrações com LMS e CRM.