Add Comments to Your LMS via LTI 1.3

1. Faça login no FastComments e vá para sua página de Configuração LTI 1.3.
2. (Opcional) Escolha a plataforma de onde você está se conectando no menu suspenso Plataforma - isso define o rótulo exibido, mas a detecção automática funciona bem.
3. Clique em Gerar URL. Um URL de Registro temporário aparece (válido por 30 minutos, de uso único).
4. No seu LMS, abra a tela de Registro Dinâmico LTI 1.3 e cole o URL no campo Tool initiation registration endpoint (ou equivalente). Envie.
5. Seu LMS faz uma chamada de retorno ao FastComments, troca chaves e cria a integração. O pop-up fecha automaticamente quando concluído.
6. De volta ao FastComments, a nova configuração aparece na tabela Configurações Existentes. A ferramenta agora está disponível dentro dos seus cursos no LMS.

O FastComments LTI 1.3 foi testado com:

• D2L Brightspace (qualquer versão com LTI Advantage)
• Moodle 4.0+ (plugin External Tool, LTI Advantage)
• Blackboard Learn (SaaS e Ultra)
• Sakai (versões com suporte ao LTI Advantage)
• Schoology (Enterprise, Dynamic Registration quando disponível)

Qualquer outro LMS que implemente a especificação IMS LTI 1.3 Advantage com Dynamic Registration também deve funcionar - selecione Other LTI 1.3 platform do menu suspenso de plataforma ao gerar sua URL de registro (obtenha-a aqui).

Canvas LMS usa um fluxo de configuração diferente (JSON de configuração por chave de desenvolvedor em vez de Dynamic Registration). Veja o guia de instalação dedicado ao Canvas LMS.

Navegue até a Configuração LTI 1.3

Faça login no FastComments e vá para sua página de Configuração LTI 1.3.

Se sua conta ainda não tiver acesso ao LTI, você verá "LTI not enabled for this account" - entre em contato com o suporte para habilitá-lo no seu plano.

Escolha uma Plataforma (Opcional)

Sob Gerar uma URL de Registro Dinâmico, use o dropdown Plataforma para informar ao FastComments a qual LMS você está se conectando:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Outra plataforma LTI 1.3

Você também pode deixá-lo em Auto-detect. A plataforma é lida a partir do openid-configuration do seu LMS durante o registro; o menu suspenso apenas preenche o rótulo de exibição para a configuração resultante.

Gerar a URL

Clique em Generate URL. O FastComments cria um token de registro de uso único e mostra uma URL que se parece com:

https://fastcomments.com/lti/v1p3/register/<long-token>

Copie-a. Esta URL:

• É de uso único - uma vez que seu LMS a chamar com sucesso, o token é consumido.
• Expira após 30 minutos se não for usada.
• Deve ser mantida privada - qualquer pessoa com a URL pode registrar uma ferramenta no seu tenant dentro desses 30 minutos.

Configurações Existentes

Uma vez que um registro seja concluído com sucesso, a nova configuração aparece na tabela Configurações Existentes na mesma página, com sua Plataforma, Emissor, ID do Cliente e Status. Você pode excluir configurações desta tabela se precisar cancelar o registro.

D2L Brightspace expõe o Registro Dinâmico através da interface de administração LTI Advantage. Você precisará de acesso de administrador.

Abra a tela de registro

1. Faça login na sua instância do Brightspace como administrador.
2. Navegue até Ferramentas do administrador > Gerenciar Extensibilidade > LTI Advantage.
3. Clique em Registrar ferramenta. (A URL direta é https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Cole a URL

Você verá um formulário de registro. O campo principal é Tool initiation registration endpoint (algumas versões do Brightspace o rotulam como "Tool Initiation Registration URL").

Cole a URL de registro do FastComments (obtenha-a aqui) nesse campo. Deixe os outros campos em branco - eles são preenchidos automaticamente pelo FastComments durante o handshake de registro.

Clique em Registrar.

Aprove a ferramenta

O Brightspace abre um pop-up que se comunica com o FastComments, troca chaves e mostra uma tela de confirmação. O pop-up se fecha automaticamente quando o registro é concluído.

A nova ferramenta aparece na sua lista de ferramentas LTI Advantage. Por padrão o Brightspace marca novas ferramentas como desativada - altere o interruptor para ativada para que seus cursos possam usá-la.

Adicionar uma implantação

No Brightspace, as ferramentas LTI precisam de uma implantação antes de poderem ser usadas em cursos:

1. Abra a ferramenta FastComments recém-registrada.
2. Clique em Ver implantações > Nova implantação.
3. Dê um nome à implantação (por exemplo, "FastComments - All Courses"), escolha as unidades organizacionais nas quais ela deve estar disponível e salve.

Depois do primeiro lançamento por meio desta implantação, o FastComments vincula o deployment_id ao seu registro de configuração - lançamentos subsequentes a partir de uma implantação diferente sob o mesmo cliente serão rejeitados, a menos que você registre novamente.

Usando o Moodle? Também publicamos um plugin dedicado para Moodle do FastComments com uma integração mais profunda do que o LTI 1.3 (hooks de sincronização de notas, relatórios de atividade mais detalhados, interface nativa de configurações do Moodle). Veja o guia de instalação do plugin para Moodle. O fluxo LTI 1.3 abaixo é a escolha certa se você quiser um único registro que também cubra outros LMSs, ou se o administrador do seu Moodle não instalar plugins de terceiros.

O Moodle 4.0+ oferece suporte ao registro dinâmico LTI 1.3 através do plugin External tool.

Abra a tela de Gerenciamento de Ferramentas

1. Faça login no Moodle como administrador do site.
2. Navegue até Administração do site > Plugins > Módulos de atividade > Ferramenta externa > Gerenciar ferramentas.

Cole a URL

Você verá um cartão rotulado Tool URL. Cole a URL de registro do FastComments (obtenha-o aqui) no campo de texto e clique em Add LTI Advantage.

O Moodle abre uma tela de registro mostrando a identidade da ferramenta e as permissões que ela está solicitando. Revise e clique em Ativar (ou Registrar, dependendo da versão do Moodle).

A janela pop-up se fecha quando o registro é concluído; a nova ferramenta FastComments aparece na lista Tools com o status Active.

Tornar disponível

Por padrão, o Moodle adiciona novas ferramentas à lista "Course tools" mas não as mostra no seletor de atividades. Para expor o FastComments em todo o curso:

1. Clique no ícone de engrenagem no bloco do FastComments.
2. Em Tool configuration usage, escolha Show in activity chooser and as a preconfigured tool.
3. Salve.

Os instrutores agora podem adicionar o FastComments a qualquer curso através de Adicionar uma atividade ou recurso > FastComments.

Blackboard Learn SaaS e Ultra oferecem suporte ao Registro Dinâmico LTI 1.3.

Abra a tela do Provedor de Ferramenta

1. Faça login no Blackboard como administrador do sistema.
2. Navegue até Administrator Panel > Integrations > LTI Tool Providers.
3. Clique em Register LTI 1.3 / LTI Advantage Tool.

Se você vir apenas "Register LTI 1.1 Provider", sua versão do Blackboard ainda não suporta LTI 1.3 - atualize ou entre em contato com o suporte do Blackboard.

Cole a URL

Cole a URL de registro do FastComments (obtenha aqui) no campo Client ID / Registration URL (a rotulagem do Blackboard varia conforme a versão). Envie.

O Blackboard realiza o handshake de registro com o FastComments e exibe uma tela de confirmação.

Aprove e Ative

Por padrão, o Blackboard marca as ferramentas recém-registradas como Approved but excluded:

1. Encontre a entrada do FastComments na lista de provedores de ferramenta.
2. Abra o menu e escolha Editar.
3. Defina Tool Status para Aprovado.
4. Em Institution Policies, revise quais dados do usuário são enviados (nome, e-mail, função). Salve.

A ferramenta agora está disponível para instrutores quando adicionam conteúdo aos cursos.

Sakai

O Sakai oferece suporte ao Registro Dinâmico LTI 1.3 em versões com LTI Advantage. Na Área de Trabalho de Administração:

1. Faça login como administrador do Sakai e abra a Área de Trabalho de Administração.
2. Escolha Ferramentas Externas > Instalar Ferramenta LTI 1.3.
3. Cole a URL de registro do FastComments (obtenha-o aqui) e envie.
4. Aprove a ferramenta quando o handshake for concluído.

A ferramenta então aparece em Ferramentas Externas e pode ser adicionada a sites pelos seus mantenedores.

Schoology

Instâncias Enterprise do Schoology suportam LTI 1.3, mas a disponibilidade do Registro Dinâmico varia conforme a implantação. Verifique com seu gerente de conta do Schoology.

Se o Registro Dinâmico não estiver disponível na sua instância do Schoology, você precisará configurar a integração manualmente usando estes endpoints:

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

Depois que o Schoology fornecer um Client ID e um Deployment ID, entre em contato com o suporte do FastComments para registrar a configuração no seu tenant.

Other LTI 1.3 Platforms

Qualquer LMS que siga a especificação IMS LTI 1.3 Advantage deve funcionar com a mesma URL de registro (obtenha-o aqui). Procure por uma configuração rotulada como "Registro Dinâmico", "URL de registro da ferramenta", "endpoint de registro de iniciação da ferramenta" ou similar.

Se sua plataforma suportar apenas a configuração manual do LTI 1.3, use os quatro endpoints listados na seção do Schoology acima e entre em contato com o suporte para finalizar.

Esta página aborda como adicionar o FastComments a um curso Brightspace depois que um administrador registrou a ferramenta e criou um deployment. Se a ferramenta ainda não estiver registrada, veja primeiro o guia de registro do D2L.

FastComments embedded as a unit topic in Brightspace

O Brightspace fornece duas experiências de autoria de conteúdo: Classic Content e a New Content Experience (também chamada Lessons). Ambas expõem o FastComments, mas os caminhos de menu diferem. Cada seção abaixo cobre ambos onde divergirem.

Localize a ferramenta FastComments

A ferramenta FastComments aparece em dois lugares dentro do editor de conteúdo do curso:

1. O seletor de atividades, acessado a partir do botão Add Existing do módulo/unidade (rotulado Add Existing Activities em versões mais antigas do Brightspace). O FastComments aparece diretamente no seletor em builds atuais do Brightspace; versões antigas o aninham sob um submenu External Learning Tools. Qualquer um dos caminhos adiciona o FastComments como um tópico independente.
2. A caixa de diálogo Insert Stuff dentro do editor HTML, em LTI Advantage. Isso embute o FastComments inline em um tópico HTML via o fluxo de deep linking do LTI.

Se o FastComments não aparecer em nenhum dos seletores, o deployment não está habilitado para a unidade organizacional (org unit) que contém o curso. Peça ao administrador do Brightspace para abrir Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, abrir o deployment e adicionar a org unit do curso (ou uma org unit pai) em Org Units.

Adicionar o FastComments como um tópico em um módulo

Classic Content:

1. Abra o curso e clique em Content na barra de navegação.
2. Selecione o módulo que deve conter a discussão (ou crie um via Add a module).
3. Clique em Add Existing (Brightspace mais antigo: Add Existing Activities > External Learning Tools).
4. No seletor, clique em FastComments. O Brightspace cria um tópico no módulo e retorna você à visualização de conteúdo.
5. Clique no novo tópico. Renomeie-o para algo descritivo como FastComments Discussion usando o editor de título inline.

New Content Experience (Lessons):

1. Abra o curso e clique em Content.
2. Abra a unidade e a lesson que devem conter a discussão.
3. Clique em Add > Existing Activity e selecione FastComments (Brightspace mais antigo: aninhado sob External Learning Tools).
4. A atividade é adicionada à lesson.
5. Clique no título da atividade para renomeá-la.

Na primeira vez que qualquer usuário (instrutor ou estudante) abrir o tópico, o FastComments inicializa o thread para esse resource link. O thread está vinculado ao resource link ID, então renomear ou mover o tópico não altera qual thread é carregado.

Embutir o FastComments inline em um tópico HTML

Use este fluxo quando você quiser que os comentários apareçam abaixo de uma leitura, vídeo ou outro conteúdo dentro da mesma página do tópico em vez de como um tópico separado.

1. Abra ou crie um tópico HTML no módulo/lesson.
2. Clique em Edit HTML para abrir o editor HTML do Brightspace.
3. Coloque o cursor onde o thread de comentários deve aparecer.
4. Clique no botão Insert Stuff (ícone de peça de quebra-cabeça na barra de ferramentas do editor).
5. Na caixa Insert Stuff, role até LTI Advantage e clique em FastComments.
6. O FastComments abre um seletor de deep linking. Confirme o posicionamento (as opções padrão funcionam para discussões de conteúdo); clique em Insert ou Continue.
7. O Brightspace retorna ao editor HTML com um bloco placeholder representando o launch LTI. Clique em Save and Close no tópico.

Quando o tópico for carregado, o Brightspace substitui o placeholder por um iframe que auto-inicia o FastComments via LTI. Os estudantes veem o thread de discussão inline.

Um único tópico HTML pode conter múltiplos embeds deep-linked do FastComments. Cada embed recebe seu próprio thread porque cada deep link produz um resource link ID distinto.

Tópico do módulo vs Quicklink inline

Escolha a abordagem de module topic quando:

• A discussão for a atividade principal para aquela etapa no módulo.
• Você quiser que o tópico apareça no sumário do Brightspace, no acompanhamento de conclusão e no Class Progress.

Escolha a abordagem de inline embed quando:

• Os comentários devem ficar abaixo de outro conteúdo na mesma página.
• Você não quer um item separado rastreável por conclusão no sumário.

Visibilidade, rascunho e condições de liberação

Um novo tópico FastComments é visível para os estudantes por padrão. Para escondê-lo enquanto você o configura:

1. No editor de conteúdo, clique no título do tópico (Classic) ou no menu de três pontos na atividade (New Content Experience).
2. Defina o status para Draft (Classic) ou desative a Visibility (New Content Experience).

Tópicos em Draft são invisíveis para estudantes. Instrutores e TAs ainda os veem com um badge "Draft".

Para restringir o tópico a um grupo ou seção específica:

1. Abra o tópico.
2. Clique no menu do título do tópico > Edit Properties In-place (Classic) ou Edit > Restrictions (New Content Experience).
3. Em Release Conditions, clique em Create.
4. Escolha Group enrollment ou Section enrollment, selecione o grupo/seção e salve.

As release conditions se acumulam com o próprio mapeamento de papéis do FastComments. Estudantes que não podem ver o tópico não recebem um lançamento LTI.

O que os estudantes veem no primeiro lançamento

Quando um estudante clica no tópico (ou carrega um tópico HTML com um embed):

1. O Brightspace realiza o launch LTI 1.3 em segundo plano.
2. O FastComments recebe o nome do estudante, email, URL do avatar e papel no LMS, e faz o login automaticamente. Não há prompt de login do FastComments.
3. O thread de comentários para esse resource link é renderizado dentro do iframe do Brightspace.

Mapeamento de papéis no lançamento:

• Brightspace Administrator se torna um FastComments admin para o thread (moderação completa, excluir, banir e acesso à configuração).
• Brightspace Instructor se torna um FastComments moderator (pin, ocultar, excluir, banir).
• Todos os outros papéis (Learner, TeachingAssistant, etc.) se tornam comentaristas padrão.

Os comentários são atribuídos à conta do estudante no Brightspace. Se o estudante editar seu nome ou avatar no Brightspace, o próximo lançamento LTI sincroniza a alteração.

Altura do iframe e redimensionamento

O FastComments emite a postMessage org.imsglobal.lti.frameResize em toda renderização de thread e em alterações de conteúdo (novo comentário, expandir respostas). O Brightspace escuta essa mensagem e ajusta a altura do iframe para que o thread não seja cortado e não mostre uma barra de rolagem interna.

Se o iframe permanecer com altura fixa e curta:

• Confirme que o curso está sendo carregado via HTTPS. O listener postMessage do Brightspace rejeita frames de conteúdo misto.
• Confirme que nenhuma extensão do navegador está bloqueando o canal postMessage.
• Para embeds inline em um tópico HTML, o HTML circundante não deve envolver o iframe em um contêiner de altura fixa. Remova qualquer style="height: ..." inline do elemento pai.

Particularidades específicas do Brightspace

Ferramenta não aparecendo no seletor Add Existing. O deployment não está habilitado para a org unit deste curso. Um administrador precisa adicionar a org unit (ou uma org unit pai) à lista Org Units do deployment. O registro da ferramenta por si só não é suficiente; o deployment define quais cursos veem a ferramenta.

deployment_id em desacordo no lançamento. O FastComments TOFU-pins o primeiro deployment_id que encontra para um registration. Se um administrador excluir o deployment original e criar um novo, lançamentos a partir do novo deployment são rejeitados com um erro de mismatch de deployment. A correção é re-registrar o FastComments (gerar uma nova URL de registro (obtenha-a aqui) e executar o Dynamic Registration novamente); o registro de configuração antigo é substituído.

A ferramenta inicia mas mostra "Invalid LTI launch". O curso está em uma estrutura de tenant/org diferente daquela coberta pelo deployment, ou o deployment foi desabilitado após o registro. Verifique novamente Admin Tools > Manage Extensibility > LTI Advantage > FastComments > alternador Enabled e a lista de org units do deployment.

Nomes e papéis ausentes dentro do FastComments. O Brightspace envia lançamentos LTI com claims do Names and Role Provisioning Services (NRPS). Se um curso foi atualizado a partir de um link LTI 1.1 mais antigo, o lançamento pode não conter as claims name e email. Re-adicione o tópico FastComments via Add Existing (não migre o link antigo) para que o lançamento use LTI 1.3.

Embed mostra uma tela de login em vez de auto-SSO. O tópico HTML foi inserido como um <iframe> simples apontando para o FastComments em vez de via Insert Stuff > LTI Advantage. Iframes simples pulam o lançamento LTI e direcionam os usuários para a página pública do FastComments. Delete o iframe e reinsira via o fluxo Insert Stuff.

Uma vez que um administrador registrou o FastComments como uma ferramenta LTI 1.3 Advantage e aprovou as políticas da instituição, os instrutores o adicionam aos cursos através dos pontos de posicionamento padrão do Blackboard. As etapas exatas diferem entre Ultra Course View e Original Course View, então ambas são abordadas abaixo.

Ultra Course View

Ultra Course View é o padrão no Blackboard Learn SaaS a partir de 2026.

1. Abra o curso e vá para a página Course Content.
2. Passe o cursor ou toque no local onde você quer que o tópico de comentários apareça na estrutura e clique no botão roxo + (Add content).
3. Escolha Content Market. O painel Content Market lista todas as ferramentas LTI aprovadas e colocações de Building Block da sua instituição.
4. Encontre o bloco FastComments e clique nele. O Blackboard cria um item de conteúdo na posição onde você abriu o menu +.
5. O item aparece na estrutura como uma entrada "Visible to students" por padrão para instrutores que têm Hide from students desativado como padrão pessoal. Se o seu padrão for Hidden, o item é criado oculto e você ativa o seletor de visibilidade na linha do item quando estiver pronto.
6. Para renomear o item, clique no título na estrutura e digite um novo rótulo. O título que os alunos veem na estrutura é independente do identificador do thread do FastComments, portanto renomear é seguro a qualquer momento.

Se você não vir Content Market como opção, sua instituição ocultou a colocação. Você também acessa o mesmo seletor através de More tools no mesmo menu + sob o grupo LTI Tools.

Original Course View

Original Course View ainda é suportado no Learn SaaS e permanece a experiência principal para sites Learn 9.1 self-hosted na linha de release CU do Q4 2024.

1. Abra o curso e entre em uma Content Area (por exemplo, a Information ou Content padrão no menu do curso).
2. Ative o Edit Mode com o interruptor no canto superior direito da página.
3. Clique em Build Content na barra de ações.
4. No submenu Learning Tools, clique em FastComments. O submenu Learning Tools é preenchido a partir das colocações de ferramentas LTI 1.3 depois que um administrador registra a ferramenta. Se você não o vir, veja a seção de problemas comuns abaixo.
5. No formulário Create FastComments, configure:
   • Name: o rótulo que os alunos veem na área de conteúdo.
   • Description: texto opcional exibido acima do thread incorporado.
   • Permit Users to View this Content: alternador de disponibilidade Yes/No.
   • Track Number of Views: habilite se quiser as estatísticas de visualizações por item do Blackboard. FastComments executa suas próprias análises independentemente.
   • Date and Time Restrictions: janelas opcionais Display After / Display Until.
6. Envie. A ferramenta aparece como um item clicável na área de conteúdo.

Embedding Inside an Item or Document

Em ambas as visualizações de curso, os instrutores incorporam o FastComments inline dentro do corpo de um Item, Documento ou qualquer campo rich-text através do botão LTI Advantage do Content Editor.

Ultra Course View:

1. Crie ou edite um Document.
2. Clique em Add content dentro do corpo do documento onde deseja que o thread apareça.
3. Na barra de ferramentas do editor, abra o menu Insert content e clique em Content Market (o ponto de entrada LTI Advantage / Deep Linking).
4. Escolha FastComments. O FastComments retorna um payload de deep-link e o Blackboard insere um bloco incorporado no corpo do documento na posição do cursor.
5. Salve o documento. Os alunos veem o thread renderizado inline enquanto rolam a página.

Original Course View:

1. Edite qualquer item com um corpo rich-text.
2. Na barra de ferramentas do Content Editor, clique no ícone de mais Add Content e escolha Content Market (rotulado Add Content from External Tool em CUs mais antigos do Q4 2024).
3. Escolha FastComments. O editor insere um bloco de espaço reservado referenciando o recurso deep-linked.
4. Envie o item.

Cada embed de deep-link produz seu próprio thread FastComments, então um Item com dois blocos FastComments incorporados tem duas transmissões de comentários independentes.

Visibility, Release Conditions, and Group Restrictions

Os itens de conteúdo do FastComments se comportam como qualquer outro item de conteúdo do Blackboard para as regras de controle de acesso aplicadas sobre eles.

• Ultra: clique no seletor de visibilidade na linha (Visible to students, Hidden from students, Conditional availability). A disponibilidade condicional suporta janelas de data/hora, regras de desempenho contra itens do gradebook e regras de membro contra grupos do curso.
• Original: abra o menu de contexto do item e escolha Adaptive Release ou Adaptive Release: Advanced para bloquear a ferramenta por data, filiação, nota ou status de revisão. Use Set Group Availability no item para restringir a grupos específicos do curso.

O FastComments respeita o que quer que o gate do Blackboard decida. Se o Blackboard ocultar o item de um aluno, o launch LTI nunca ocorre para esse aluno e ele não aparece na visualização de moderador.

Gradebook Behavior

O FastComments não reporta notas de volta via LTI Advantage Assignment and Grade Services. Nenhuma coluna de nota é criada automaticamente para itens de conteúdo do FastComments.

Se o seu tenant Blackboard estiver configurado para criar automaticamente uma coluna de grade para todo novo item de conteúdo independentemente dos metadados de avaliação, uma coluna vazia aparece mesmo assim. Para ocultá-la:

• Ultra: abra o Gradebook, clique no cabeçalho da coluna, escolha Edit e desative Show to students além de Include in calculations. Ou use Delete se sua instituição permitir a exclusão de colunas para itens sem avaliação.
• Original: abra o Grade Center, clique na chevron da coluna, escolha Hide from Users (on/off) e, opcionalmente, Hide from Instructor View em Column Organization.

What Students See

Quando um aluno abre o item FastComments ou rola até um bloco incorporado:

1. O Blackboard lança a mensagem LTI 1.3 para o FastComments. O aluno é autenticado via SSO usando sua identidade do Blackboard (nome, email, avatar, função) sem ver um formulário de login.
2. O thread de comentários é renderizado no iframe. Encadeamento, respostas, menções e reações estão todas disponíveis com base nas configurações do widget de comentários configuradas no FastComments.
3. Seus comentários são atribuídos à conta do Blackboard. Se o aluno editar seu nome ou foto no Blackboard posteriormente, o próximo lançamento atualiza o perfil do FastComments.

Mapeamento de funções do Blackboard para o FastComments:

• System Administrator e Course Builder mapeiam para admin do FastComments.
• Instructor e Teaching Assistant mapeiam para moderator do FastComments.
• Student, Guest, e Observer mapeiam para commenter do FastComments.

Moderadores veem controles de moderação (pin, hide, ban, delete) inline em cada comentário do thread.

Thread Scoping

O FastComments delimita cada thread por (Blackboard host, course ID, resource link ID). Dois itens FastComments no mesmo curso produzem dois threads. O mesmo item copiado em dois shells de curso (por exemplo, através de cópia de curso) produz dois threads, porque o Blackboard emite um novo resource link ID durante a cópia. Para manter um thread compartilhado entre cópias de curso, use Deep Linking com um URN de thread explícito configurado no FastComments antes de iniciar a cópia.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). O administrador aprovou a ferramenta mas deixou uma política da instituição bloqueando a colocação relevante. Vá para Administrator Panel > Integrations > LTI Tool Providers, edite a entrada do FastComments e confirme que tanto Course Content Tool (Original) quanto Course Content Tool - allow students / Deep Linking content tool (Ultra) placements estão habilitados. Salve e atualize a página do curso.

"Tool not configured for this context" or "Tool is not deployed" error on launch. O escopo de deployment registrado durante o registro dinâmico não corresponde ao contexto da instituição ao qual o curso pertence. Na entrada do provedor de ferramentas do Blackboard, verifique se o Deployment ID corresponde ao que o FastComments mostra na sua página LTI 1.3 Configuration para este tenant. Se diferirem, exclua a colocação e reexecute o registro dinâmico a partir de uma URL de registro nova (obtenha-o aqui).

Iframe height looks fixed or content gets cut off. Alguns tenants do Blackboard vêm com uma Content Security Policy estrita que bloqueia o postMessage padrão de redimensionamento de iframe LTI. O FastComments emite tanto a mensagem no estilo Canvas lti.frameResize quanto a mensagem no formato especificação IMS org.imsglobal.lti.frameResize para maximizar a compatibilidade, mas uma sobrescrita de CSP em nível de tenant bloqueia o listener pai. Peça ao seu administrador para confirmar que *.fastcomments.com está na allowlist de ferramentas LTI e que nenhum cabeçalho CSP personalizado está removendo eventos postMessage. O redimensionamento então funciona sem configuração adicional.

Course copy duplicates threads. A cópia de curso do Blackboard emite novos resource link IDs para colocações LTI, então cursos copiados começam com threads vazios. Isso é esperado. Se você precisar que o curso copiado herde o thread original, configure Deep Linking com um URN de thread explícito antes de copiar, ou contate o suporte do FastComments para remapear IDs de thread em massa.

Student sees a generic Blackboard error on launch. A causa é uma claim email ausente ou desatualizada. Confirme a política da instituição para o FastComments tem Role, Name, e Email Address habilitados em User Fields to Send. Salve e então inicie novamente em uma sessão de navegador nova.

"Registration token not found, expired, or already used"

O token na sua URL de registro (obtenha-o aqui) é válido por 30 minutos e só pode ser usado uma vez. Se seu LMS levou mais tempo do que isso, ou se o registro foi reenviado após ter sido bem-sucedido, o token será rejeitado. Gere uma URL nova na página FastComments LTI 1.3 Configuration e recomece.

"Platform rejected registration"

Seu LMS recusou o handshake de registro. As causas mais comuns:

• Tool already registered with the same client name. Algumas plataformas (notavelmente D2L) rejeitam um segundo registro de "FastComments" até que o anterior seja excluído. Remova a ferramenta antiga no seu LMS e tente novamente.
• Wrong field in the LMS. Certifique-se de que você colou a URL no campo registration / tool initiation registration endpoint, e não no campo launch URL ou login URL.
• The LMS doesn't actually support Dynamic Registration. Versões mais antigas do Moodle e do Blackboard anunciam LTI 1.3 mas só permitem configuração manual. Consulte a documentação da sua plataforma.

"Failed to fetch platform configuration"

O FastComments não conseguiu ler o documento openid-configuration do seu LMS. Isso é raro e geralmente significa que o LMS forneceu uma URL de discovery malformada ou inacessível. Contate o suporte do seu LMS.

Launch shows "Configuration not found"

Ou a configuração no FastComments foi excluída, ou o lançamento veio de um par iss/client_id que não reconhecemos. Se você excluiu e se registrou novamente, instrua seu LMS a remover e readicionar a ferramenta FastComments para que ela receba o novo client_id.

Launch shows "Deployment not registered"

Você lançou o FastComments a partir de um deployment do Brightspace/Moodle/Blackboard diferente daquele em que ele foi lançado pela primeira vez. O FastComments fixa o deployment_id no primeiro lançamento como uma verificação de segurança. Para adicionar um novo deployment sob o mesmo cliente, contate o suporte — nós adicionaremos o deployment ID à configuração.

Launch shows "Unsupported message_type"

O LMS enviou uma mensagem LTI que o FastComments não trata (por exemplo, LtiSubmissionReviewRequest). O FastComments suporta apenas os fluxos padrão de lançamento resource-link e de deep-linking. Entre em contato se precisar que um tipo de mensagem específico seja adicionado.

Iframe doesn't resize

A maioria dos LMSs redimensiona automaticamente iframes LTI. Se o seu não faz isso, verifique se as configurações de lançamento do LMS permitem que a ferramenta envie eventos postMessage para o frame pai. O FastComments emite mensagens de redimensionamento no estilo Canvas (lti.frameResize) e conforme a especificação IMS (org.imsglobal.lti.frameResize).