> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ahaslides.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar o AhaSlides ao Blackboard Learn

> Configure a integração LTI 1.3 do AhaSlides com o Blackboard Learn: abra apresentações em um curso e sincronize as notas dos quizzes com o boletim.

A integração do AhaSlides com o Blackboard Learn permite que os professores abram apresentações do AhaSlides diretamente de dentro de um curso do Blackboard e que as notas dos quizzes fluam automaticamente para o boletim do Blackboard. Ela é baseada no padrão **LTI 1.3**, então a mesma abordagem funciona com qualquer sistema de gestão de aprendizagem compatível com LTI 1.3.

<Note>
  Esta integração é para instituições com um contrato Enterprise do AhaSlides. A configuração envolve o administrador do seu Blackboard e a equipe do AhaSlides trabalhando juntos. Se você quer ativá-la para a sua instituição, fale com o seu representante do AhaSlides.
</Note>

<Frame>
  <img src="https://mintcdn.com/ahaslides/B-N6TAkwgH4SZNwS/images/marketplace-blackboard-learn.png?fit=max&auto=format&n=B-N6TAkwgH4SZNwS&q=85&s=0750f8119d51cb022714d5f92702d05d" alt="A aba Plataformas de aprendizagem (LMS) do Mercado do AhaSlides, com o cartão Blackboard Learn em destaque" width="1920" height="1080" data-path="images/marketplace-blackboard-learn.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/ahaslides/UAK6mPTE4WVGJAMN/images/marketplace-blackboard-request-integration.png?fit=max&auto=format&n=UAK6mPTE4WVGJAMN&q=85&s=5afaef4a464ba34a01eddb5a100a0ba5" alt="O formulário Request integration do Blackboard Learn no AhaSlides, com o campo Integration e o botão Submit em destaque" width="820" height="654" data-path="images/marketplace-blackboard-request-integration.png" />
</Frame>

<Tip>
  **Quer uma configuração guiada?** Como esta integração é configurada pelo administrador do seu Blackboard junto com a equipe do AhaSlides, você pode [agendar uma sessão de onboarding](https://meetings.hubspot.com/cheryl-duong/onboarding?utm_source=knowledge-base\&utm_medium=docs\&utm_campaign=blackboard-onboarding) para percorrer com a gente o registro da ferramenta, a sincronização de notas e a sua primeira sessão ao vivo.
</Tip>

## O que você ganha

* **Abertura com um clique** — alunos e professores abrem o AhaSlides de dentro do curso, sem login separado.
* **Seletor de apresentações** — os professores navegam pelas próprias apresentações do AhaSlides e anexam uma delas a uma atividade do curso.
* **Notas automáticas** — as notas dos quizzes são enviadas de volta ao boletim do Blackboard depois da sessão.
* **Correspondência da lista de alunos** — os participantes são associados automaticamente aos alunos certos pelo endereço de e-mail.

## Antes de começar

* A sua instância do Blackboard precisa aceitar **LTI 1.3 e Assignment and Grade Services (AGS)** — Blackboard Learn Ultra, ou Learn 9.1 (Q2 2019 ou mais recente).
* Você precisa de **acesso de administrador do Blackboard** para registrar uma ferramenta externa no nível da instituição.
* Cada professor e aluno precisa de uma conta do AhaSlides provisionada pela sua instituição (via [SCIM](/pt-BR/teams-and-enterprise/setting-up-sso-and-scim-provisioning)). As contas são associadas pelo endereço de e-mail.
* Se você quer que os alunos entrem **diretamente** — por exemplo, escaneando um código QR — e não apenas pelo link do curso no Blackboard, ative a [verificação de participantes](/pt-BR/features-and-functions/participant-verification) na apresentação para que as respostas deles possam ser associadas ao registro no boletim.

<Frame>
  <img src="https://mintcdn.com/ahaslides/nZBn6ZrPZA8x3dcI/images/participant-verification-settings.png?fit=max&auto=format&n=nZBn6ZrPZA8x3dcI&q=85&s=416ba1250e4a54ce4f5ebdcf9c035ce3" alt="A aba Acesso dos participantes das Definições da apresentação do AhaSlides, com a opção Os participantes têm de iniciar sessão para participar em destaque" width="1920" height="1080" data-path="images/participant-verification-settings.png" />
</Frame>

## Passo 1: registrar o AhaSlides no Blackboard (administrador)

O AhaSlides é um único aplicativo do Blackboard pré-registrado, então o seu administrador só precisa de um valor nosso: o **Application (Client) ID** do AhaSlides. Peça-o ao seu representante do AhaSlides — o Blackboard preenche automaticamente o restante dos endereços do AhaSlides assim que ele é informado.

<Steps>
  <Step title="Abra a página de registro de ferramentas LTI">
    Vá a **Administrator Panel → Integrations → LTI Tool Providers → Register LTI 1.3 / Advantage Tool**.
  </Step>

  <Step title="Informe o Application (Client) ID">
    Cole o **Application (Client) ID** fornecido pelo seu representante do AhaSlides e clique em **Submit**. O Blackboard preenche automaticamente os endereços de login, de abertura e de keyset do AhaSlides — você não precisa digitá-los à mão.
  </Step>

  <Step title="Aprove a ferramenta">
    Defina **Tool Status** como **Approved**.
  </Step>

  <Step title="Ative as políticas da instituição necessárias">
    Em **Institution Policies**, ative **Role in Course**, **Name**, **Email Address**, **Allow grade service access** (Yes) e **Allow Membership Service Access** (Yes). Elas são necessárias para a abertura com um clique, a correspondência da lista de alunos e a sincronização de notas.
  </Step>

  <Step title="Salve a ferramenta">
    Salve o registro.
  </Step>
</Steps>

## Passo 2: enviar o Deployment ID ao AhaSlides

Depois de registrar a ferramenta, copie o **Deployment ID** que o Blackboard gera para o AhaSlides e envie-o ao seu contato do AhaSlides. A equipe do AhaSlides o usa para concluir a conexão da sua instância do Blackboard do nosso lado. Quando isso for confirmado, a integração fica ativa para os seus professores.

## Passo 3: adicionar uma apresentação a um curso (professor)

<Steps>
  <Step title="Adicione a atividade do AhaSlides">
    No seu curso do Blackboard, adicione uma atividade **AhaSlides** — a ferramenta externa que o seu administrador registrou.
  </Step>

  <Step title="Escolha uma apresentação">
    O seletor de apresentações do AhaSlides se abre. Escolha a apresentação que você quer usar.
  </Step>

  <Step title="Confirme">
    O Blackboard cria a atividade e uma **coluna do boletim** correspondente para ela.
  </Step>
</Steps>

<Note>
  Se você ainda não tem nenhuma apresentação, o seletor mostra um estado vazio com um link para criar uma no AhaSlides.
</Note>

## Passo 4: conduzir a sessão e sincronizar as notas

<Steps>
  <Step title="Os alunos entram">
    Os alunos entram na apresentação ao vivo de dentro do Blackboard ou diretamente no app da audiência — veja [Como os alunos entram](#como-os-alunos-entram-na-sessão) abaixo.
  </Step>

  <Step title="Apresente ao vivo">
    Conduza a sua apresentação normalmente.
  </Step>

  <Step title="As notas sincronizam automaticamente">
    Quando a sessão termina, o AhaSlides envia automaticamente a nota do quiz de cada aluno ao boletim do Blackboard — normalmente em cerca de uma hora.
  </Step>

  <Step title="Reutilize a apresentação">
    Para conduzir a mesma apresentação de novo, abra a atividade e escolha **Reset Results** para finalizar antes as notas atuais. Veja [Repor os resultados](/pt-BR/after-the-presentation/resetting-the-results).
  </Step>
</Steps>

<Note>
  As notas são calculadas como total de pontos ganhos ÷ total de pontos disponíveis nos slides de **quiz** e depois gravadas na coluna do boletim criada para a atividade. Só os slides de quiz têm nota — votações e outros tipos de slide sem pontuação não contribuem para o valor no boletim.
</Note>

## Como os alunos entram na sessão

Os alunos podem participar de duas formas, e ambas mantêm as notas associadas à pessoa certa no boletim:

* **De dentro do Blackboard (recomendado).** O aluno clica na atividade do AhaSlides e a sessão ao vivo se abre diretamente — nome e e-mail já preenchidos, sem código de sala nem login separado. A correspondência de identidade é automática.
* **Diretamente no app da audiência** — por exemplo, escaneando um código QR. Para que as notas sejam associadas, a apresentação precisa ter a [verificação de participantes](/pt-BR/features-and-functions/participant-verification) ativada, e cada aluno precisa entrar com o **mesmo e-mail da conta dele no Blackboard**. É esse e-mail que liga as respostas dele no AhaSlides ao registro no boletim.

De qualquer forma, os alunos não precisam lembrar de um login separado do AhaSlides, e os resultados deles são registrados no nome deles no curso.

## Solução de problemas da integração com o Blackboard

**A abertura falha ou mostra um erro.** Peça ao seu administrador que confirme que a ferramenta do AhaSlides está Approved e que o registro foi concluído com o Application (Client) ID correto, fornecido pelo seu representante do AhaSlides.

**As notas não aparecem no boletim.** Confira se o acesso ao serviço de notas está ativado para a ferramenta e se a atividade foi adicionada pelo seletor de apresentações do AhaSlides, para que exista uma coluna no boletim. Aguarde até cerca de uma hora depois do fim da sessão.

**Faltam as notas de alguns alunos.** Confira se o acesso à lista de alunos (membership) e o compartilhamento de e-mail estão ativados nas políticas da instituição da ferramenta, e se esses alunos entraram no AhaSlides com o mesmo e-mail da conta deles no Blackboard.

**O professor vê "not linked", ou os alunos veem "no presentation".** O professor precisa abrir a atividade e escolher uma apresentação antes que os alunos possam entrar.

**O resultado de uma votação não chegou ao boletim.** Só os slides de quiz têm nota. Se você precisa de uma atividade avaliada, monte-a com slides de quiz — veja [Como criar e conduzir um quiz](/pt-BR/using-slide-types/how-to-make-and-run-a-quiz).

**Tem alguma dúvida?**

Fale com a nossa equipe de suporte: se você estiver conectado, use o ícone de chat no canto inferior direito do painel; caso contrário, [fale conosco aqui](https://ahaslides.com/contact-us/) ou envie um e-mail para [hi@ahaslides.com](mailto:hi@ahaslides.com).

Quer se conectar com outros usuários? Participe da [comunidade AhaSlides](https://community.ahaslides.com/) para compartilhar dicas, sugerir funcionalidades e ver como outras pessoas engajam suas audiências.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.