Add Comments to Your LMS via LTI 1.3

1. Увійдіть у FastComments і перейдіть на your LTI 1.3 Configuration page.
2. (Необов'язково) Виберіть платформу, з якої ви підключаєтеся, у спадному списку Platform - це задає мітку відображення, але Auto-detect працює добре.
3. Клацніть Generate URL. З'явиться одноразовий Registration URL (дійсний 30 хвилин, для одноразового використання).
4. У вашому LMS відкрийте екран LTI 1.3 Dynamic Registration і вставте URL у поле Tool initiation registration endpoint (або еквівалентне). Надішліть.
5. Ваш LMS викликає FastComments у відповідь, обмінюється ключами і створює інтеграцію. Коли операція завершена, спливаюче вікно закривається автоматично.
6. Повернувшись у FastComments, нова конфігурація з'явиться в таблиці Existing Configurations. Інструмент тепер доступний у курсах вашого LMS.

FastComments LTI 1.3 було протестовано на:

• D2L Brightspace (будь-яка версія з LTI Advantage)
• Moodle 4.0+ (плагін External Tool, LTI Advantage)
• Blackboard Learn (SaaS та Ultra)
• Sakai (версії з підтримкою LTI Advantage)
• Schoology (Enterprise, Dynamic Registration де доступно)

Будь-яка інша LMS, яка реалізує специфікацію IMS LTI 1.3 Advantage із Dynamic Registration, також має працювати — оберіть Other LTI 1.3 platform у випадаючому списку платформи під час генерації вашого URL реєстрації (отримати його тут).

Canvas LMS використовує інший процес налаштування (per-developer-key configuration JSON замість Dynamic Registration). Дивіться спеціальний посібник із встановлення Canvas LMS.

Перейдіть до конфігурації LTI 1.3

Увійдіть у FastComments і перейдіть на вашу сторінку конфігурації LTI 1.3.

Якщо у вашого облікового запису ще немає доступу до LTI, ви побачите "LTI not enabled for this account" — зверніться до служби підтримки, щоб увімкнути його у вашому плані.

Виберіть платформу (необов'язково)

У розділі Generate a Dynamic Registration URL використайте випадаюче меню Platform, щоб повідомити FastComments, з якою LMS ви підключаєтеся:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Інша платформа LTI 1.3

Ви також можете залишити вибір на Auto-detect. Платформа зчитується з openid-configuration вашої LMS під час реєстрації; випадаюче меню лише задає текстову мітку для отриманої конфігурації.

Згенерувати URL

Натисніть Generate URL. FastComments створює одноразовий реєстраційний токен і показує URL, який виглядає як:

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

Скопіюйте його. Цей URL:

• Є одноразовим — щойно ваша LMS успішно виконає виклик, токен буде використано.
• Термін дії спливає через 30 хвилин, якщо його не використано.
• Повинна зберігатися приватною — будь-хто з цим URL зможе зареєструвати інструмент для вашого тенанта протягом цих 30 хвилин.

Існуючі конфігурації

Як тільки реєстрація успішно завершиться, нова конфігурація з’явиться в таблиці Existing Configurations на тій же сторінці з інформацією про Platform, Issuer, Client ID та Status. Ви можете видаляти конфігурації з цієї таблиці, якщо вам потрібно скасувати реєстрацію.

D2L Brightspace надає Динамічну реєстрацію через інтерфейс адміністратора LTI Advantage. Потрібен доступ адміністратора.

Open the Registration Screen

1. Увійдіть у ваш екземпляр Brightspace як адміністратор.
2. Перейдіть до Admin Tools > Manage Extensibility > LTI Advantage.
3. Натисніть Register Tool. (Пряме посилання: https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Paste the URL

Ви побачите форму реєстрації. Ключове поле — Tool initiation registration endpoint (в деяких версіях Brightspace воно позначене як "Tool Initiation Registration URL").

Вставте URL реєстрації FastComments (get it here) у це поле. Інші поля залиште порожні — вони автоматично заповнюються FastComments під час рукопотискання реєстрації.

Натисніть Register.

Approve the Tool

Brightspace відкриває спливаюче вікно, яке взаємодіє з FastComments, обмінюється ключами та показує екран підтвердження. Спливаюче вікно закривається автоматично після завершення реєстрації.

Новий інструмент з'явиться у списку інструментів LTI Advantage. За замовчуванням Brightspace позначає нові інструменти як disabled — переключіть тумблер на enabled, щоб ваші курси могли ним користуватися.

Add a Deployment

У Brightspace LTI-інструментам потрібне deployment перед тим, як ними можна буде користуватися в курсах:

1. Відкрийте щойно зареєстрований інструмент FastComments.
2. Натисніть View Deployments > New Deployment.
3. Дайте розгортанню назву (наприклад, "FastComments - All Courses"), виберіть організаційні одиниці, у яких воно має бути доступне, і збережіть.

Після першого запуску через це розгортання FastComments закріплює deployment_id у своєму записі конфігурації — наступні запуски з іншого розгортання в межах того ж клієнта будуть відхилені, якщо ви не зареєструєте заново.

Використовуєте Moodle? Ми також публікуємо спеціальний плагін для Moodle для FastComments з тіснішою інтеграцією, ніж LTI 1.3 (механізми синхронізації оцінок, розширені звіти по активності, рідний інтерфейс налаштувань Moodle). Дивіться Посібник з встановлення плагіна Moodle. Наведений нижче потік LTI 1.3 — правильний вибір, якщо ви хочете одну реєстрацію, яка також покриває інші LMS, або якщо ваш адміністратор Moodle відмовляється встановлювати сторонні плагіни.

Moodle 4.0+ підтримує динамічну реєстрацію LTI 1.3 через плагін External Tool.

Відкрийте екран керування інструментом

1. Увійдіть до Moodle як адміністратор сайту.
2. Перейдіть до Site administration > Plugins > Activity modules > External tool > Manage tools.

Вставте URL

Ви побачите картку з позначкою Tool URL. Вставте URL реєстрації FastComments (отримайте його тут) у текстове поле та натисніть Add LTI Advantage.

Moodle відкриє екран реєстрації, що показує ідентифікацію інструмента та дозволи, які він запитує. Перегляньте їх і натисніть Activate (або Register, залежно від версії Moodle).

Спливаюче вікно закривається після завершення реєстрації; новий інструмент FastComments зʼявиться в списку Tools зі статусом Active.

Зробіть його доступним

За замовчуванням Moodle додає нові інструменти до списку "Course tools", але не показує їх у виборі активності. Щоб зробити FastComments доступним для всього курсу:

1. Натисніть на значок шестерні на плитці FastComments.
2. У розділі Tool configuration usage виберіть Show in activity chooser and as a preconfigured tool.
3. Зберегти.

Інструктори тепер можуть додати FastComments до будь-якого курсу через Add an activity or resource > FastComments.

Blackboard Learn SaaS and Ultra підтримують LTI 1.3 Dynamic Registration.

Відкрийте екран постачальника інструменту

1. Увійдіть до Blackboard як системний адміністратор.
2. Перейдіть до Administrator Panel > Integrations > LTI Tool Providers.
3. Натисніть Register LTI 1.3 / LTI Advantage Tool.

Якщо ви бачите лише "Register LTI 1.1 Provider", ваша версія Blackboard ще не підтримує LTI 1.3 - оновіть або зв'яжіться зі службою підтримки Blackboard.

Вставте URL

Вставте URL реєстрації FastComments (отримати його тут) у поле Client ID / Registration URL (найменування полів у Blackboard може відрізнятися залежно від версії). Натисніть Submit.

Blackboard виконує реєстраційний обмін з FastComments і показує екран підтвердження.

Схваліть та увімкніть

За замовчуванням Blackboard позначає щойно зареєстровані інструменти як Approved but excluded:

1. Знайдіть запис FastComments у списку постачальників інструментів.
2. Відкрийте меню та оберіть Edit.
3. Встановіть Tool Status на Approved.
4. У розділі Institution Policies перегляньте, які дані користувача передаються (ім'я, електронна пошта, роль). Збережіть.

Тепер цей інструмент доступний викладачам під час додавання вмісту до курсів.

Sakai

Sakai підтримує динамічну реєстрацію LTI 1.3 у випусках з LTI Advantage. З Administration Workspace:

1. Увійдіть як адміністратор Sakai і відкрийте Administration Workspace.
2. Виберіть External Tools > Install LTI 1.3 Tool.
3. Вставте URL реєстрації FastComments (отримайте його тут) і надішліть.
4. Підтвердіть інструмент, коли рукопотискання буде завершено.

Після цього інструмент з’явиться в External Tools і його можна додати на сайти їхніми адміністраторами.

Schoology

Інсталяції Schoology Enterprise підтримують LTI 1.3, але наявність Dynamic Registration залежить від розгортання. Зверніться до вашого менеджера облікового запису Schoology.

Якщо Dynamic Registration недоступна у вашій інсталяції Schoology, вам потрібно буде налаштувати інтеграцію вручну, використовуючи ці кінцеві точки:

• 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

Після того як Schoology надасть вам Client ID і Deployment ID, зв’яжіться зі службою підтримки FastComments, щоб зареєструвати конфігурацію на вашому тенанті.

Other LTI 1.3 Platforms

Будь-яка LMS, яка дотримується специфікації IMS LTI 1.3 Advantage, повинна працювати з тим же URL реєстрації (отримайте його тут). Шукайте налаштування з позначенням "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" або подібне.

Якщо ваша платформа підтримує лише ручне налаштування LTI 1.3, використовуйте ті самі чотири кінцеві точки, перелічені в розділі Schoology вище, і зв’яжіться зі службою підтримки для завершення налаштування.

Ця сторінка описує додавання FastComments до курсу Brightspace після того, як адміністратор зареєстрував інструмент і створив розгортання. Якщо інструмент ще не зареєстровано, спочатку перегляньте посібник з реєстрації D2L.

FastComments, вбудований як тема одиниці в Brightspace

Brightspace постачає два інструменти для створення контенту: Classic Content і New Content Experience (також називається Lessons). Обидва надають доступ до FastComments, але шляхи в меню відрізняються. Кожен розділ нижче описує обидва варіанти там, де вони розходяться.

Знайти інструмент FastComments

Інструмент FastComments з’являється в двох місцях у редакторі контенту курсу:

1. У вибірнику активностей, до якого переходять через кнопку Add Existing модуля/одиниці (у старіших версіях Brightspace — позначено Add Existing Activities). У сучасних збірках Brightspace FastComments відображається безпосередньо в вибірнику; у старіших версіях він знаходиться в підменю External Learning Tools. Будь-який шлях додає FastComments як окрему тему.
2. У діалозі Insert Stuff всередині HTML-редактора, під LTI Advantage. Це вбудовує FastComments безпосередньо в HTML-тему через потік глибокого зв’язування LTI.

Якщо FastComments не з’являється в жодному з вибірників, розгортання не увімкнено для організаційної одиниці, яка містить курс. Попросіть вашого адміністратора Brightspace відкрити Інструменти адміністратора > Керування розширеннями > LTI Advantage > інструмент FastComments > Переглянути розгортання, відкрити розгортання і додати організаційну одиницю курсу (або батьківську організаційну одиницю) у розділ Організаційні одиниці.

Додати FastComments як тему в модулі

Classic Content:

1. Відкрийте курс і натисніть Content у навігаційній панелі.
2. Виберіть модуль, у якому має бути обговорення (або створіть його через Add a module).
3. Натисніть Add Existing (старіші версії Brightspace: Add Existing Activities > External Learning Tools).
4. У вибірнику натисніть FastComments. Brightspace створює тему в модулі і повертає вас до перегляду контенту.
5. Клацніть нову тему. Перейменуйте її на щось описове, наприклад FastComments Discussion, використовуючи вбудований редактор назви.

New Content Experience (Lessons):

1. Відкрийте курс і натисніть Content.
2. Відкрийте одиницю та урок, у яких має бути обговорення.
3. Натисніть Add > Existing Activity і виберіть FastComments (у старіших версіях Brightspace: знаходиться в підменю External Learning Tools).
4. Активність додається до уроку.
5. Натисніть назву активності, щоб перейменувати її.

Першого разу, коли будь-який користувач (інструктор або студент) відкриє тему, FastComments ініціалізує тред для цього ідентифікатора ресурсу. Тред прив’язаний до ідентифікатора resource link, тому перейменування або переміщення теми не змінює, який тред завантажується.

Вбудувати FastComments всередині HTML-теми

Використовуйте цей потік, коли ви хочете, щоб коментарі з’являлися під читанням, відео або іншим контентом всередині тієї ж сторінки теми, а не як окрема тема.

1. Відкрийте або створіть HTML-тему в модулі/уроці.
2. Натисніть Edit HTML, щоб відкрити HTML-редактор Brightspace.
3. Розмістіть курсор там, де має з’явитися тред коментарів.
4. Натисніть кнопку Insert Stuff (значок пазла у панелі інструментів редактора).
5. У діалоговому вікні Insert Stuff прокрутіть до LTI Advantage і натисніть FastComments.
6. FastComments відкриває вибір глибокого зв’язування. Підтвердіть розміщення (за замовчуванням параметри підходять для обговорень контенту); натисніть Insert або Continue.
7. Brightspace повертає вас до HTML-редактора з заповнювачем, що представляє запуск LTI. Натисніть Save and Close у темі.

Коли тема завантажується, Brightspace замінює заповнювач на iframe, який автоматично запускає FastComments через LTI. Студенти бачать тред обговорення вбудованим на сторінці.

Одна HTML-тема може містити кілька глибоко зв’язаних вставок FastComments. Кожна вкладка отримує свій тред, оскільки кожне глибоке посилання створює унікальний ідентифікатор resource link.

Тема модуля проти вбудованого швидкого посилання

Оберіть підхід «тема модуля», коли:

• Обговорення є основною активністю для цього кроку в модулі.
• Ви хочете, щоб тема з’являлася в змісті Brightspace, у відстеженні виконання та в Class Progress.

Оберіть підхід «вбудований ембед», коли:

• Коментарі мають розміщуватися під іншим контентом на одній сторінці.
• Ви не хочете мати окремий елемент у змісті, що відстежується для завершення.

Видимість, Чернетка та Умови публікації

Нова тема FastComments за замовчуванням видима для студентів. Щоб приховати її під час налаштування:

1. У редакторі контенту натисніть назву теми (Classic) або меню з трьома крапками на активності (New Content Experience).
2. Встановіть статус Draft (Classic) або вимкніть перемикач Visibility (New Content Experience).

Теми в статусі чернетки невидимі для студентів. Інструктори та асистенти все ще бачать їх із бейджем «Draft».

Щоб обмежити тему для конкретної групи або секції:

1. Відкрийте тему.
2. Натисніть меню назви теми > Edit Properties In-place (Classic) або Edit > Restrictions (New Content Experience).
3. У розділі Release Conditions натисніть Create.
4. Виберіть Group enrollment або Section enrollment, оберіть групу/секцію та збережіть.

Умови публікації працюють разом із власним мапінгом ролей FastComments. Студенти, які не бачать тему, не отримують LTI-запуску.

Що бачать студенти при першому запуску

Коли студент клацає тему (або завантажує HTML-тему з ембедами):

1. Brightspace виконує LTI 1.3 запуск у фоновому режимі.
2. FastComments отримує ім’я студента, електронну пошту, URL аватара та роль у LMS і автоматично авторизує його. Вікна входу FastComments не з’являються.
3. Тред коментарів для цього resource link відображається всередині iframe Brightspace.

Мапінг ролей при запуску:

• Brightspace Administrator стає в FastComments адміністратором треду (повні права модерації, видалення, бану та доступ до конфігурації).
• Brightspace Instructor стає в FastComments модератором (закріплення, приховування, видалення, бан).
• Усі інші ролі (Learner, TeachingAssistant тощо) стають звичайними коментаторами.

Коментарі приписуються до облікового запису студента в Brightspace. Якщо студент змінює своє ім’я або аватар у Brightspace, наступний LTI-запуск синхронізує зміни.

Висота iframe і його зміна

FastComments надсилає повідомлення postMessage org.imsglobal.lti.frameResize при кожному рендері треду та при зміні контенту (новий коментар, розгортання відповідей). Brightspace слухає це повідомлення й регулює висоту iframe, щоб тред не обрізався і щоб не з’являлася внутрішня смуга прокрутки.

Якщо iframe залишається зафіксованим на малій висоті:

• Переконайтеся, що курс завантажується через HTTPS. Слухач postMessage у Brightspace відкидає фрейми зі змішаним вмістом.
• Переконайтеся, що жодне розширення браузера не блокує канал postMessage.
• Для вбудованих ембедів у HTML-темі навколишній HTML не повинен обертати iframe у контейнер із фіксованою висотою. Видаліть будь-який inline-атрибут style="height: ..." у батьківському елементі.

Особливості, специфічні для Brightspace

Інструмент не відображається у вибірнику Add Existing. Розгортання не увімкнено для організаційної одиниці цього курсу. Адміністратору потрібно додати організаційну одиницю (або батьківську) до списку Організаційні одиниці у розгортанні. Самої реєстрації інструмента недостатньо; розгортання визначає, в яких курсах інструмент буде доступний.

Несумісність deployment_id при запуску. FastComments прив’язує (TOFU) перший deployment_id, який бачить для реєстрації. Якщо адміністратор видаляє початкове розгортання і створює нове, запуски з нового розгортання відхиляються з помилкою невідповідності розгортання. Виправлення — перереєструвати FastComments (згенеруйте нову URL реєстрації (отримати тут) і виконайте Динамічну реєстрацію знову); старий запис конфігурації буде замінено.

Інструмент запускається, але показує "Invalid LTI launch". Курс знаходиться в іншій структурі тенанта/організації, ніж охоплює розгортання, або розгортання було вимкнено після реєстрації. Перевірте Інструменти адміністратора > Керування розширеннями > LTI Advantage > FastComments > перемикач Enabled і список організаційних одиниць розгортання.

Імена та ролі відсутні в FastComments. Brightspace відправляє LTI-запуски з NRPS (Names and Role Provisioning Services) клеймами. Якщо курс було оновлено зі старого LTI 1.1 посилання, запуск може не містити зймен name та email. Повторно додайте тему FastComments через Add Existing (не мігруйте старе посилання), щоб запуск використовував LTI 1.3.

Вбудування показує екран входу замість авто-SSO. HTML-тема була вставлена як звичайний <iframe>, що вказує безпосередньо на FastComments, замість того щоб використовувати Insert Stuff > LTI Advantage. Звичайні iframe пропускають LTI-запуск і приводять користувачів на публічну сторінку FastComments. Видаліть iframe і вставте знову через потік Insert Stuff.

Once an administrator has registered FastComments as an LTI 1.3 Advantage tool and approved the institution policies, instructors add it to courses through the standard Blackboard placement points. The exact steps differ between Ultra Course View and Original Course View, so both are covered below.

Ultra Course View

Ultra Course View is the default in Blackboard Learn SaaS as of 2026.

1. Відкрийте курс і перейдіть на сторінку Course Content.
2. Наведіть курсор або торкніться місця в оглядовій структурі, куди ви хочете вставити потік коментарів, і натисніть фіолетову кнопку + (Add content).
3. Виберіть Content Market. Панель Content Market перелічує всі схвалені LTI-застосунки та розміщення Building Block для вашої установи.
4. Знайдіть плитку FastComments і натисніть її. Blackboard створює елемент вмісту в позиції, де ви відкрили меню +.
5. За замовчуванням елемент з’являється в огляді як запис «Visible to students» для викладачів, у яких персональна опція Hide from students вимкнена. Якщо у вас за замовчуванням встановлено Hidden, елемент створюється прихованим, і ви вмикаєте селектор видимості на рядку елемента, коли будете готові.
6. Щоб перейменувати елемент, натисніть заголовок в огляді та введіть нову мітку. Заголовок, який бачать студенти в огляді, незалежний від ідентифікатора потоку FastComments, тож перейменування безпечне в будь-який час.

Якщо ви не бачите Content Market як варіант, у вашій установі це розміщення приховано. Той самий вибір також доступний через More tools у тому самому меню + в групі LTI Tools.

Original Course View

Original Course View is still supported in Learn SaaS and remains the primary experience for self-hosted Learn 9.1 sites on the Q4 2024 CU release line.

1. Відкрийте курс і зайдіть у Content Area (наприклад, стандартну ділянку Information або Content у меню курсу).
2. Увімкніть Edit Mode за допомогою перемикача у верхньому правому куті сторінки.
3. Натисніть Build Content у панелі дій.
4. У підменю Learning Tools натисніть FastComments. Підменю Learning Tools заповнюється з розміщень інструментів LTI 1.3 після того, як адміністратор зареєструє інструмент. Якщо ви його не бачите, див. розділ про проблеми нижче.
5. На формі Create FastComments задайте:
   • Name: мітка, яку бачать студенти в області вмісту.
   • Description: необов’язковий текст, що відображається над вбудованим потоком.
   • Permit Users to View this Content: перемикач доступності Так/Ні.
   • Track Number of Views: увімкніть, якщо хочете статистику переглядів по елементу від Blackboard. FastComments веде власну аналітику незалежно.
   • Date and Time Restrictions: необов’язкові вікна Display After / Display Until.
6. Надішліть форму. Інструмент з’явиться як клікабельний елемент у області вмісту.

Embedding Inside an Item or Document

In both course views, instructors embed FastComments inline inside the body of an Item, Document, or any rich-text field through the Content Editor's LTI Advantage button.

Ultra Course View:

1. Створіть або відредагуйте Document.
2. Натисніть Add content всередині тіла документа в тому місці, де ви хочете, щоб з’явився потік.
3. У панелі інструментів редактора відкрийте меню Insert content і натисніть Content Market (точка входу LTI Advantage / Deep Linking).
4. Виберіть FastComments. FastComments повертає deep-link payload, і Blackboard вставляє вбудований блок у тіло документа в позицію курсора.
5. Збережіть документ. Студенти побачать потік відрендереним вбудовано під час прокручування сторінки.

Original Course View:

1. Редагуйте будь-який елемент з тілом у форматі rich-text.
2. У панелі інструментів Content Editor натисніть іконку плюс Add Content і оберіть Content Market (у старіших Q4 2024 CU ця опція маркована як Add Content from External Tool).
3. Виберіть FastComments. Редактор вставить заповнювач, що посилається на ресурс, пов’язаний через deep link.
4. Надішліть елемент.

Кожне deep-link вбудовування створює власний потік FastComments, тож елемент з двома вбудованими блоками FastComments матиме два незалежні потоки коментарів.

Visibility, Release Conditions, and Group Restrictions

FastComments content items behave like any other Blackboard content item for the access control rules layered on top of them.

• Ultra: натисніть селектор видимості на рядку (Visible to students, Hidden from students, Conditional availability). Conditional availability підтримує вікна дати/часу, правила продуктивності щодо елементів gradebook та правила членства щодо груп курсу.
• Original: відкрийте контекстне меню елемента і виберіть Adaptive Release або Adaptive Release: Advanced, щоб обмежити доступ до інструмента за датою, членством, оцінкою або статусом перегляду. Використовуйте Set Group Availability на елементі, щоб обмежити доступ певними групами курсу.

FastComments підпорядковується будь-яким правилам доступу Blackboard. Якщо Blackboard приховує елемент від студента, LTI-запуск для цього студента не відбувається і він не з’являється у вигляді модератора.

Gradebook Behavior

FastComments does not report grades back over LTI Advantage Assignment and Grade Services. No grade column is auto-created for FastComments content items.

Якщо ваш екземпляр Blackboard налаштований на автоматичне створення стовпця журналу оцінок для кожного нового елементу вмісту незалежно від метаданих оцінювання, порожній стовпець все одно з’явиться. Щоб приховати його:

• Ultra: відкрийте Gradebook, натисніть заголовок стовпця, виберіть Edit і вимкніть Show to students та Include in calculations. Або використайте Delete, якщо ваша установа дозволяє видалення стовпців для нефрагованих елементів.
• Original: відкрийте Grade Center, натисніть на шеврон стовпця, виберіть Hide from Users (on/off) і за потреби Hide from Instructor View у розділі Column Organization.

What Students See

When a student opens the FastComments item or scrolls to an embedded block:

1. Blackboard launches the LTI 1.3 message to FastComments. The student is signed in via SSO using their Blackboard identity (name, email, avatar, role) without seeing a login form.
2. The comment thread renders in the iframe. Threading, replies, mentions, and reactions are all available based on the comment widget settings configured in FastComments.
3. Their comments are attributed to their Blackboard account. If the student edits their name or photo in Blackboard later, the next launch updates the FastComments profile.

Role mapping from Blackboard to FastComments:

• System Administrator and Course Builder map to FastComments admin.
• Instructor and Teaching Assistant map to FastComments moderator.
• Student, Guest, and Observer map to FastComments commenter.

Moderators see moderation controls (pin, hide, ban, delete) inline on every comment in the thread.

Thread Scoping

FastComments scopes each thread by (Blackboard host, course ID, resource link ID). Two FastComments items in the same course produce two threads. The same item copied across two course shells (for example, through course copy) produces two threads, because Blackboard issues a fresh resource link ID during the copy. To keep a shared thread across course copies, use Deep Linking with an explicit thread URN configured in FastComments before launching the copy.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). Адміністратор схвалив інструмент, але залишив політику установи, яка блокує відповідне розміщення. Перейдіть у Administrator Panel > Integrations > LTI Tool Providers, відредагуйте запис FastComments і переконайтеся, що включені розміщення Course Content Tool (Original) та Course Content Tool - allow students / Deep Linking content tool (Ultra). Збережіть і оновіть сторінку курсу.

"Tool not configured for this context" or "Tool is not deployed" error on launch. Область розгортання, зареєстрована під час динамічної реєстрації, не відповідає контексту установи, до якої належить курс. У записі провайдера інструментів Blackboard перевірте, чи Deployment ID збігається з тим, що FastComments показує на сторінці LTI 1.3 Configuration для цього тенанта. Якщо вони відрізняються, видаліть розміщення і повторіть динамічну реєстрацію з нового URL реєстрації (отримати його тут).

Iframe height looks fixed or content gets cut off. Деякі екземпляри Blackboard постачаються зі строгим Content Security Policy, який блокує стандартне LTI iframe-resize postMessage. FastComments відправляє як Canvas-style lti.frameResize повідомлення, так і IMS spec-form org.imsglobal.lti.frameResize повідомлення для максимальної сумісності, але переважна CSP на рівні тенанта блокує прослуховувача у батьківському вікні. Попросіть вашого адміністратора підтвердити, що *.fastcomments.com додано до allowlist інструментів LTI і що жоден користувацький CSP-заголовок не видаляє події postMessage. Після цього зміна розміру працюватиме без додаткової конфігурації.

Course copy duplicates threads. Blackboard course copy генерує нові resource link ID для розміщень LTI, тож скопійовані курси починаються з порожніх потоків. Це очікувана поведінка. Якщо вам потрібно, щоб скопійований курс успадкував оригінальний потік, налаштуйте Deep Linking з явним thread URN перед копіюванням або зв’яжіться зі службою підтримки FastComments для масового переназначення ID потоків.

Student sees a generic Blackboard error on launch. Причина — відсутня або застаріла заява email. Переконайтеся, що політика установи для FastComments має увімкнені Role, Name, та Email Address у розділі User Fields to Send. Збережіть, потім знову відкрийте запуск у новій сесії браузера.

"Токен реєстрації не знайдено, прострочено або вже використано"

Токен у вашому URL реєстрації (отримати його тут) дійсний 30 хвилин і може бути використаний лише один раз. Якщо ваш LMS витратив більше часу, або якщо реєстрацію повторно виконали після успішного завершення, токен буде відхилено. Згенеруйте новий URL на сторінці конфігурації FastComments LTI 1.3 і почніть заново.

"Платформа відхилила реєстрацію"

Ваш LMS відхилив handshake реєстрації. Найпоширеніші причини:

• Інструмент вже зареєстрований з тим самим ім'ям клієнта. Деякі платформи (зокрема D2L) відхиляють повторну реєстрацію "FastComments", поки попередній запис не буде видалено. Видаліть старий інструмент у вашому LMS, потім спробуйте ще раз.
• Неправильне поле в LMS. Переконайтеся, що ви вставили URL у поле registration / tool initiation registration endpoint, а не в поле launch URL або login URL.
• LMS фактично не підтримує динамічну реєстрацію. Старі версії Moodle і Blackboard оголошують LTI 1.3, але дозволяють лише ручну конфігурацію. Перевірте документацію вашої платформи.

"Не вдалося отримати конфігурацію платформи"

FastComments не зміг прочитати документ openid-configuration вашого LMS. Це трапляється рідко і зазвичай означає, що LMS надало некоректний або недоступний URL для discovery. Зверніться до служби підтримки вашого LMS.

Launch shows "Configuration not found"

Або конфігурацію у FastComments було видалено, або запуск надійшов від пари iss/client_id, яку ми не розпізнаємо. Якщо ви видалили і повторно зареєстрували, попросіть ваш LMS видалити та додати інструмент FastComments заново, щоб він отримав новий client_id.

Launch shows "Deployment not registered"

Ви запустили FastComments з розгортання Brightspace/Moodle/Blackboard, відмінного від того, в якому він був запущений уперше. FastComments "закріплює" deployment_id при першому запуску як перевірку безпеки. Щоб додати нове розгортання під тим самим клієнтом, зв'яжіться зі службою підтримки — ми додамо deployment ID до конфігурації.

Launch shows "Unsupported message_type"

LMS надіслав LTI-повідомлення, яке FastComments не обробляє (наприклад, LtiSubmissionReviewRequest). FastComments підтримує лише стандартний запуск resource-link і потоки deep-linking. Зверніться до нас, якщо вам потрібен додатковий тип повідомлення.

Iframe doesn't resize

Більшість LMS автоматично підлаштовують розмір LTI-iframe. Якщо ваш цього не робить, перевірте, чи дозволяють налаштування запуску LMS інструменту надсилати події postMessage до батьківського фрейму. FastComments надсилає повідомлення для зміни розміру як у стилі Canvas (lti.frameResize), так і за специфікацією IMS (org.imsglobal.lti.frameResize).