Pular para o conteúdo principal

Integração do Canvas com LTI

Você pode conectar o Canvas à POK Proof of Knowledge via LTI para emitir credenciais digitais diretamente dos seus cursos. A configuração tem três partes: criar uma API key no Canvas, gerar o registro LTI e instalar o app da POK em cada curso. Depois da instalação, as credenciais podem ser emitidas automaticamente quando o aluno é aprovado em uma avaliação ou sob demanda.

Instalação​

Acesse a plataforma de gestão de credenciais da POK. No menu superior direito, clique no nome da sua organização para exibir mais opções e depois clique em Integrações.

Dentro da seção, procure a plataforma CANVAS e clique em Conectar. Você deverá informar os dados da sua conta do Canvas para habilitar a integração.

Como conecto minha conta do Canvas?​

Na caixa que abre ao clicar em Conectar, preencha os seguintes campos:

  • Um nome que identifique a integração (por exemplo, Canvas - POK Integration 2025).
  • URL do site Canvas (por exemplo, https://meudominio.instructure.com)

Para concluir a integração, você também precisa copiar e colar seu API Client ID e seu API Client Secret do Canvas.

Siga estes passos para obtê-los:

  1. Acesse sua conta do Canvas e vá até Admin > My Site > Developer Keys no menu lateral esquerdo.

  2. Clique em +Developer Key e depois em +API Key.

  3. Preencha os campos obrigatórios com os seguintes dados:

    • Key Name: POK - Canvas LTI
    • Redirect URI (ambiente live): https://lti.pok.tech/lti/oauth/callback
    • Redirect URI (ambiente sandbox): https://lti.credentity.xyz/lti/oauth/callback

  4. A opção Enforce Scopes deve estar ativada. Marque os seguintes escopos:

    • No dropdown de Entregas (Submissions):
    url:GET|/api/v1/courses/:course_id/assignments/:assignment_id/submissions/:user_id
    url:GET|/api/v1/courses/:course_id/assignments/:assignment_id/submissions
    • No dropdown de Matrículas (Enrollments):
    url:GET|/api/v1/courses/:course_id/enrollments
    url:GET|/api/v1/sections/:section_id/enrollments
    url:GET|/api/v1/users/:user_id/enrollments
    • No dropdown de Tarefas (Assignments):
    url:GET|/api/v1/courses/:course_id/assignments

  5. Salve as alterações. Você será redirecionado à lista de Developer Keys.

  6. Encontre a API key que você acabou de criar e clique em ON na coluna State para ativá-la. Uma mensagem de confirmação aparecerá; clique em OK para habilitar a chave.

  7. Depois de ativada, copie o ID exibido na coluna Details. Esse é o API Client ID que você deve inserir na POK.

  8. Clique em Show Key e copie o texto exibido. Esse é o API Client Secret que você deve inserir na POK.

  9. Cole os dois valores na tela da POK para obter a URL de integração LTI.

Gerar o registro LTI​

Copie a URL de LTI do passo anterior. Você vai usá-la para criar o registro LTI no Canvas.

  1. Acesse sua conta do Canvas e vá até Admin > My Site > Developer Keys no menu lateral esquerdo.
  2. Clique em +Developer Key e depois em +LTI Registration.
  3. Na caixa que aparecer, cole a URL copiada da tela da POK e clique em Continuar.
  4. Uma tela pedirá autorização para a emissão automática de credenciais. Clique em Autorizar.
  5. Você será redirecionado de volta à lista de Developer Keys.
  6. Encontre o novo registro LTI e clique em ON na coluna State para ativá-lo. Confirme a mensagem clicando em OK.
  7. Depois de ativado, copie o ID exibido na coluna Details. Esse é o Client ID que você usará depois na seção de Apps do Canvas.

Adicionar a POK ao seu curso (instalação do app)​

Copie o Client ID do registro LTI criado no passo anterior. Você precisa dele para adicionar o app da POK aos seus cursos.

Para adicionar a POK a um curso:

  1. Acesse sua conta do Canvas e vá até Courses no menu lateral esquerdo.
  2. Clique no curso em que deseja adicionar um módulo da POK para emitir credenciais.
  3. Dentro do curso, vá até Settings, abra a aba Apps e clique em +App.
  4. Na janela, preencha as seguintes informações:
    • Configuration Type: By Client ID
    • Client ID: cole o Client ID do registro LTI
    • Clique em Submit.
  5. Uma janela de confirmação será exibida. Clique em Install.

Após a instalação, você pode usar as atividades da POK dentro do curso para emitir credenciais.

Como configurar uma credencial POK no Canvas​

Com o app da POK instalado no seu curso, você pode adicionar itens da POK para emitir diferentes credenciais. É possível emitir uma credencial automaticamente quando o aluno é aprovado em uma avaliação, ou deixá-la disponível para que os alunos a gerem manualmente.

1. Adicionar a credencial ao curso​

Adicione um item da POK ao módulo do curso. Depois de adicionado, o item da credencial fica visível dentro do módulo.

2. Configurar a credencial​

No módulo, encontre o novo item da POK e clique no nome para abrir a configuração.

Um formulário será exibido para você preencher as informações que farão parte da credencial que os alunos receberão.

Opção A: ativar a emissão automática por avaliação​

Se quiser que a credencial seja emitida automaticamente quando o aluno for aprovado em uma avaliação, defina as condições de emissão automática no formulário: selecione a avaliação e a nota mínima exigida.

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

Se preferir que não haja pré-requisitos, ignore a Opção A.

Neste caso, os alunos podem acessar o item da credencial dentro do curso e gerá-la manualmente.

3. Salvar a configuração​

Depois de preencher todas as informações, salve o formulário.

Sua credencial POK fica configurada e pronta para ser emitida automaticamente ou sob demanda, conforme sua escolha.

Ver a lista de credenciais​

Depois de configurar uma credencial no seu curso do Canvas, você pode verificar o status, enviá-la manualmente aos alunos que cumprirem os critérios e, se necessário, editar a configuração.

Após salvar uma credencial, você pode acessar a lista com o status de cada aluno.

Para acessar, clique no item da credencial dentro do módulo do curso. A partir daí, você pode visualizar e gerenciar o status de emissão.

O que significam os status?​

  • Pendente: a credencial ainda não foi gerada nem enviada ao aluno.
  • Enviado: a credencial foi gerada e um e-mail com o link de aceitação foi enviado ao aluno.
  • 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 aos alunos que atenderem aos critérios definidos.

  1. Clique no botão Enviar.
  2. Somente alunos com o status Pendente recebem a credencial.
  3. Alunos que já têm o status Enviado ou Aceito não a recebem novamente.

Importante: se você configurou uma condição de nota mínima, o aluno precisa ter alcançado essa nota na avaliação selecionada para que a credencial seja gerada. Caso contrário, ela não é emitida.

Editar uma credencial​

Se precisar modificar uma credencial já configurada, use o botão Configurar emissão.

Você pode atualizar:

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

Visão Course Level​

Quando o professor ou admin acessa o link de Course Level, ele vê um dashboard com todas as credenciais e certificados disponíveis no curso. Nessa visualização, é possível ver:

  • Credenciais enviadas: total de credenciais enviadas aos alunos.
  • Credenciais aceitas: total de credenciais aceitas pelos alunos.
  • Lista de certificados: cada credencial com seu status de automação e a quantidade de envios concluídos.

Esse dashboard permite que o professor ou admin:

  • Monitore o progresso das credenciais em tempo real.
  • Gerencie certificados em um único lugar sem sair do Canvas.
  • Verifique a automação das credenciais.
  • Analise a participação dos alunos em cada certificado.
  • Acesse rapidamente os detalhes e links de cada credencial.

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.