Adicionar comentários ao Canvas LMS via LTI 1.3
O FastComments integra-se ao Canvas LMS através do padrão LTI 1.3. Isso adiciona comentários ao vivo e chat colaborativo diretamente aos seus cursos do Canvas - sem plugin para instalar no seu servidor.
Os comentários aparecem automaticamente abaixo das tarefas, e os instrutores podem incorporar o FastComments em Páginas, Questionários e Anúncios por meio do Editor de Conteúdo Rico. O SSO é tratado automaticamente pelo lançamento LTI - os estudantes comentam com suas contas do Canvas sem um login separado. A integração suporta comentários encadeados, chat colaborativo em tempo real com realce de texto e mapeamento automático de funções.
Preços 
A integração FastComments LTI 1.3 está incluída nos planos Flex e Pro sem custo adicional.
Início rápido
- Vá para sua Configuração LTI do FastComments.
- Insira um Configuration Name e sua Platform URL (e.g.
https://yourschool.instructure.com). Escolha quais Placements ativar (Assignment View and/or Editor Button — both are on by default). Clique Create Configuration. O assistente avança para a Etapa 2 e mostra sua Configuration URL. - No Canvas, vá para Admin > Developer Keys > + Developer Key > LTI Key. Defina Method para "Enter URL" e cole a Configuration URL. Salve a chave, então defina seu State para ON e clique Allow quando solicitado.
- Copie o número do Client ID da tabela Developer Keys no Canvas. De volta ao FastComments, cole-o no campo Client ID e clique em Save & Continue.
- Revise o resumo da configuração e clique Enable Integration para ativar a integração.
- Instale o External App no Canvas (Admin > Settings > Apps > + App > By Client ID). Os comentários aparecerão automaticamente abaixo das assignments, e os instrutores podem incorporar o FastComments em Pages, Quizzes e Announcements via o botão da barra de ferramentas do Rich Content Editor.
Configuração do painel do FastComments
Navegar para a Configuração LTI
Vá para sua Configuração LTI do FastComments.
A página de configuração usa um assistente guiado que o conduz por cada etapa. Você começará em Step 1: Create.
Create a New LTI Configuration
Preencha os seguintes campos:
- Configuration Name - um rótulo opcional para identificar esta configuração (útil se você conectar múltiplas instâncias do Canvas).
- Platform URL - a URL da sua instância do Canvas (por exemplo
https://yourschool.instructure.com). Este campo é obrigatório.
Choose Placements
Abaixo do Platform URL, você pode escolher onde o FastComments aparece em seus cursos no Canvas. Ambos os placements são habilitados por padrão:
- Assignment View - os comentários aparecem automaticamente abaixo das tarefas.
- Rich Content Editor Button - os instrutores podem incorporar o FastComments em Páginas, Quizzes e Anúncios usando o botão na barra de ferramentas do Rich Content Editor.
Você pode habilitar um ou ambos. Pelo menos um placement deve estar habilitado.
Clique em Create Configuration.
Copy the Configuration URL
Após criar a configuração, o assistente avança para Step 2: Connect. Uma Configuration URL em destaque é exibida no topo da página com um botão Copy.
Copie essa URL. Você irá precisar dela na próxima etapa para criar uma Developer Key no Canvas.
A página também mostra instruções numeradas sobre o que fazer no Canvas, além de campos para inserir o Client ID e o opcional Deployment ID assim que você os tiver.
Chave de desenvolvedor do Canvas
Abrir Chaves de Desenvolvedor no Canvas
Faça login no Canvas como administrador. Vá para Administrador (na barra lateral esquerda) > selecione sua conta > Chaves de Desenvolvedor.
Criar uma Chave de Desenvolvedor LTI
Clique em + Chave de Desenvolvedor e selecione Chave LTI.
No formulário de configuração:
- No campo URIs de Redirecionamento (lado esquerdo), cole a Launch URL da página de configuração do FastComments.
- À direita, defina Método como Inserir URL.
- Cole a Configuration URL que você copiou do FastComments no campo JSON URL.
- O Canvas carregará a configuração LTI automaticamente.
- Dê um nome à chave (por exemplo, "FastComments").
- Clique em Salvar.
Ativar a Chave de Desenvolvedor
Após salvar, a nova chave aparecerá na tabela de Chaves de Desenvolvedor com seu Estado definido como DESATIVADO. Clique no interruptor para defini-lo como ATIVADO. O Canvas pode solicitar que você confirme — clique em Permitir para habilitar a chave.
Copiar o Client ID
A tabela de Chaves de Desenvolvedor mostra um Client ID numérico na coluna Detalhes (por exemplo, 17000000000042). Copie esse número - você precisará dele na próxima etapa.
Concluir a conexão
Insira o Client ID no FastComments
Volte para sua configuração LTI do FastComments. O assistente deve estar em Passo 2: Conectar.
Cole o Client ID que você copiou do Canvas no campo Client ID. Opcionalmente, insira o Deployment ID se seu LMS fornecer um.
Clique em Salvar e Continuar.
Ativar a Integração
O assistente avança para Passo 3: Ir ao vivo. Um resumo da sua configuração é exibido (nome, platform URL, Client ID e Deployment ID).
Revise os detalhes e clique em Ativar Integração para ativar a conexão LTI.
Após habilitar, o assistente mostra a Visão de Gerenciamento onde você pode editar sua configuração, ver todas as LTI URLs ou adicionar implantações adicionais.
Instale o App Externo no Canvas
No Canvas, vá para Admin > selecione sua conta > Settings > aba Apps.
Clique em + App e configure:
- Defina Configuration Type para By Client ID.
- Cole o Client ID da tabela Developer Keys.
- Clique em Submit.
- Confirme a instalação quando solicitado.
O FastComments agora está instalado em nível de conta e disponível para todos os cursos.
Adicionar a um curso
Como os Comentários Aparecem em Seus Cursos
Depois que a integração LTI estiver habilitada e o App Externo instalado, o FastComments funciona automaticamente com base nos placements que você configurou:
Assignment View
If the Assignment View placement is enabled, comments appear automatically below every assignment in the course. Students and instructors see a threaded comment section when they view an assignment — no extra setup is needed per assignment.
Each assignment gets its own separate comment thread.
Rich Content Editor Button
- Edit a Page, Quiz, or Announcement.
- In the Rich Content Editor toolbar, click the FastComments button.
- FastComments is automatically embedded into the content.
- Save the page.
When students view the page, the embedded FastComments widget loads with a comment thread unique to that page.
SSO Automático
In both placements, students are signed in via their Canvas account automatically. Names, emails, and avatars are synced through the LTI launch, no separate login is needed.
Restringir o Acesso Público (Recomendado)
By default, FastComments comment data is publicly readable. Anyone who can guess a thread's URL or API endpoint can view its comments, even outside Canvas. For course discussions you almost certainly want to restrict viewing to enrolled students only.
Open your página de personalização do widget and create a rule with Require SSO To View Comments enabled, then set the security level to Secure SSO so threads can only be loaded through the signed LTI launch.
See Protecting Comment Threads With Single-Sign-On for the full walkthrough, including how to scope the rule to a single domain or page.
Estilos de comentários
FastComments adiciona comentários encadeados aos seus cursos no Canvas. O widget padrão do FastComments aparece na página. Os usuários podem publicar comentários encadeados, responder, votar e usar todos os recursos padrão.
Os comentários são vinculados a cada página do curso ou link de recurso, então as discussões permanecem organizadas por página, atividade ou módulo.
Mapeamento de funções
As funções do Canvas são mapeadas automaticamente para as funções do FastComments durante o lançamento LTI. Nenhuma configuração manual é necessária.
Mapeamento de Funções
| Canvas Role | FastComments Role | Permissions |
|---|---|---|
| Administrator | Admin | Acesso total à conta, gerenciar todos os comentários e configurações |
| Instructor | Moderator | Editar e excluir comentários, fixar tópicos, gerenciar discussões |
| Learner | Commenter | Publicar comentários, responder, votar e usar menções |
Como Funciona
Quando um usuário inicia o FastComments a partir do Canvas, o protocolo LTI 1.3 inclui sua função no Canvas. O FastComments lê essa função e atribui automaticamente as permissões apropriadas.
Se um usuário possuir múltiplas funções (por exemplo, um Instructor que também é Admin), a função com maior privilégio será usada.
Personalização
O FastComments foi projetado para ser personalizado para combinar com o seu site.
Se você quiser adicionar estilos personalizados, ou ajustar a configuração, Confira nossa Documentação de Personalização para saber como.
Erros de domínio
Você pode receber um erro de autorização, como o seguinte:
Isso ocorre porque o FastComments não sabe que deve permitir que sua conta seja usada neste domínio.
Nesse caso, a correção é simples. Você só precisa adicionar o domínio da sua instância Canvas à sua conta FastComments.
Vá aqui para adicionar seu site à sua conta.
Adicione o domínio do seu Canvas (por exemplo, yourschool.instructure.com) e os comentários devem carregar corretamente.