
Idioma 🇧🇷 Português (Brasil)
Resumo
Configuração do LTI 1.3 do Canvas
Configuração
Solução de problemas
Add Comments to 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.
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 nos Seus Cursos
Once the LTI integration is enabled and the External App is installed, FastComments works automatically based on the placements you configured:
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
If the Editor Button placement is enabled, instructors can embed FastComments into any content that uses the Rich Content Editor:
- 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.
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.