Blackboard Learn

A Acreditta Platform se integra ao Blackboard Learn (Anthology) por meio do LTI 1.3 Advantage. Depois de conectada, seus docentes adicionam a Acreditta como uma ferramenta dentro do curso e emitem credenciais digitais aos acreditados que cumprem as regras que você definir, sem emitir uma por uma.

No lado do Blackboard, você faz três configurações: registrar a ferramenta LTI, criar um placement para que ela apareça nos cursos e autorizar uma integração REST para que a Acreditta possa ler os participantes e as notas do curso. Depois, você conecta tudo a partir da Acreditta.

Antes de começar

Tenha em mãos:

  • Acesso de administrador ao seu Blackboard Learn (Administrator Panel).
  • Acesso a Integrações → Ferramentas externas na Acreditta.
  • A URL do seu Blackboard Learn (por exemplo, https://blackboard.sua-universidade.edu).
  • O Application ID da Acreditta. É o mesmo para todas as instituições:
89bb4aff-6db8-4835-9fa7-823d57e12670

🔎 Atenção: o Blackboard usa dois valores parecidos, o Application ID e o Application key. Este guia usa sempre o Application ID. Você nunca precisa do Application key nem do seu secret.

1. Registre a ferramenta LTI 1.3 no Blackboard

  1. Entre no Administrator Panel e abra LTI Tool Providers.
  2. Clique em Register LTI 1.3/Advantage Tool.
  3. Cole o Application ID no campo Client ID e clique em Submit.

⚠️ Importante: registre a ferramenta com Register LTI 1.3/Advantage Tool. Não use Register LTI 1.1 Provider nem registre o domínio do seu Blackboard como provedor LTI 1.1.

2. Aprove a ferramenta e defina suas políticas

  1. Em LTI Tool Providers, abra o menu da ferramenta Acreditta e escolha Edit.
  2. Configure os valores da tabela:
Campo Valor
Tool Status Approved. Com Excluded a ferramenta não é iniciada.
User Fields to Send Ative Role in Course, Name e Email Address.
Allow grade service access Yes. A Acreditta precisa dele para ler as notas do curso.
Allow Membership Service Access Yes. A Acreditta precisa dele para conhecer os participantes do curso.
  1. Clique em Submit.

3. Copie o Deployment ID

  1. Em LTI Tool Providers, abra novamente o menu da ferramenta e escolha Manage Deployments.
  2. Copie o valor de Default deployment ID. Você vai colá-lo na Acreditta na etapa 6.

4. Crie o placement

O placement faz a Acreditta aparecer na lista de ferramentas dos seus cursos.

  1. Em LTI Tool Providers, abra o menu da ferramenta e escolha Manage Placements.
  2. Clique em Create Placement e preencha:
Campo Valor
Label O nome que os docentes verão. Por exemplo, Acreditta Badges.
Handle Um identificador único, sem espaços. Por exemplo, acreditta-badges.
Availability Yes.
Type Course content tool. Não escolha Deep Linking content tool.
Target Link URI https://lti.acreditta.com/lti
  1. Clique em Submit.

🔎 Atenção: se em Manage Placements você já vir um placement da Acreditta, não precisa criar outro.

5. Autorize a integração REST

Sem esta etapa, a Acreditta não consegue ler as notas e a conexão falha com um erro 401.

  1. No Administrator Panel, abra REST API Integrations e clique em Create Integration.
  2. Preencha os campos:
Campo Valor
Application ID O Application ID da Acreditta. Não o Application key.
Learn User Clique em Browse e escolha um usuário com permissão de leitura sobre participantes e o livro de notas. Recomendamos criar um usuário dedicado, por exemplo acreditta_rest.
End User Access Yes.
Authorized To Act As User Service Default (No).
  1. Clique em Submit.

🔎 Atenção: a Acreditta usa as permissões do Learn User que você escolher. Se esse usuário não consegue ver as notas de um curso, a Acreditta também não consegue avaliá-las.

6. Configure a ferramenta externa na Acreditta

  1. Vá para Integrações → Ferramentas externas.
  2. Clique em Adicionar.
  3. No seletor Lms, escolha Blackboard Learn.
  4. Preencha os campos:
Campo De onde vem
Nome O nome que você quiser dar a esta instância do Blackboard dentro da Acreditta.
Url LMS A URL base do seu Blackboard Learn, com https://.
Issuer Url Já vem preenchido com https://blackboard.com. Não o altere.
Client ID O Application ID da Acreditta (89bb4aff-6db8-4835-9fa7-823d57e12670).
Token URL Já vem preenchido. Não o altere.
Login URL Já vem preenchido. Não o altere.
Keyset URL É preenchido automaticamente ao digitar o Client ID. Não o altere.
Send notification Ative para que a Acreditta envie um e-mail a cada acreditado quando ele receber sua credencial.
Deployment ID O Default deployment ID que você copiou na etapa 3.
  1. Clique em Guardar.

7. Adicione a Acreditta a um curso

O docente ou administrador adiciona a ferramenta dentro do conteúdo do curso:

  1. Abra o curso e entre em Content.
  2. No painel à direita, em Books & Tools, clique em View course & institution tools.
  3. Escolha Browse all course tools.
  4. Clique no + da ferramenta Acreditta (com o nome que você definiu em Label).

  1. Deixe o item visível em Course Content.

⚠️ Importante: abra a Acreditta sempre a partir do conteúdo do curso. Se você a abrir pelo Administrator Panel ou por LTI Tool Providers, o Blackboard não envia o contexto do curso e a Acreditta não consegue ler as notas.

8. Associe um modelo e emita

Ao abrir a Acreditta a partir do curso, você vê a mesma tela de Modelos de reconhecimento do Moodle e do Canvas. Ali você associa um modelo de credencial, define suas regras e emite. Os detalhes estão em Mapeamento de campos e emissão em massa (Canvas), que funciona da mesma forma no Blackboard.

Duas particularidades do Blackboard:

  • Critérios disponíveis: hoje você pode avaliar a Nota final do curso (em porcentagem) e a Nota final do curso.
  • Nota final: o curso precisa de uma nota final no Gradebook (Overall Grade, ou uma coluna de nota externa). Se existir uma coluna de nota externa, a Acreditta a usa primeiro. Se não existir nenhuma nota final, ninguém cumpre a regra.

Problemas frequentes

Sintoma Causa mais comum
A ferramenta não abre O Tool Status não está em Approved (etapa 2).
A Acreditta não aparece em Books & Tools O Tool Status está em Excluded, o Type do placement não é Course content tool ou a Availability está em No (etapas 2 e 4).
Erro do serviço de notas (AGS_ENDPOINT_MISSING) Você abriu a Acreditta fora do curso, ou Allow grade service access está em No (etapas 2 e 7).
Erro de plataforma ou deployment não registrado (UNREGISTERED_PLATFORM, DEPLOYMENT_ID) O Deployment ID na Acreditta está errado ou vazio (etapas 3 e 6).
Erro 401 ao conectar com o Blackboard Falta a integração REST, o Learn User não tem permissões, ou você colou o Application key em vez do Application ID (etapa 5).

Ainda não conseguiu conectar? Escreva para tech@acreditta.com com o nome da sua instituição e a mensagem de erro.

Próximo passo


CONTENIDO

Powered By EazyDocs