Add Comments to Your LMS via LTI 1.3

1. Sign in to FastComments and go to 你的 LTI 1.3 設定頁面.
2. (選填) 從 平台 下拉選單選擇您要連線的平台 - 它會設定顯示標籤，但自動偵測也能正常運作。
3. 按一下 產生 URL. 會出現一次性 註冊 URL（有效 30 分鐘，僅限一次使用）。
4. 在您的 LMS 中，打開 LTI 1.3 動態註冊畫面，將 URL 貼到 工具啟動註冊端點（或相等）欄位。提交。
5. 您的 LMS 會回呼 FastComments、交換金鑰，並建立整合。完成後彈出視窗會自行關閉。
6. 回到 FastComments，新的設定會出現在 現有設定 表格中。該工具現在已可在您的 LMS 課程中使用。

FastComments LTI 1.3 已經在以下平台上進行測試：

• D2L Brightspace（任何支援 LTI Advantage 的版本）
• Moodle 4.0+（External Tool plugin，LTI Advantage）
• Blackboard Learn（SaaS 與 Ultra）
• Sakai（支援 LTI Advantage 的版本）
• Schoology（Enterprise，若有提供則使用 Dynamic Registration）

任何其他實作 IMS LTI 1.3 Advantage 規格並支援 Dynamic Registration 的 LMS 也應該能正常運作 - 在產生您的註冊 URL 時，從平台下拉選單中選擇 Other LTI 1.3 platform（在此取得）。

Canvas LMS 使用不同的設定流程（每位開發者金鑰的 configuration JSON，而非 Dynamic Registration）。請參閱專門的 Canvas LMS 安裝指南。

Navigate to LTI 1.3 Configuration

Sign in to FastComments and go to 您的 LTI 1.3 設定頁面。

If your account doesn't yet have LTI access, you'll see "LTI not enabled for this account" - contact support to enable it on your plan.

Pick a Platform (Optional)

Under Generate a Dynamic Registration URL, use the Platform dropdown to tell FastComments which LMS you're connecting:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• 其他 LTI 1.3 平台

You can also leave it on Auto-detect. The platform is read out of your LMS's openid-configuration during registration; the dropdown only seeds the display label for the resulting configuration.

Generate the URL

Click Generate URL. FastComments creates a one-time registration token and shows you a URL that looks like:

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

Copy it. This URL:

• Is single-use - once your LMS calls it successfully, the token is consumed.
• Expires after 30 minutes if not used.
• Should be kept private - anyone with the URL can register a tool against your tenant within those 30 minutes.

Existing Configurations

Once a registration completes successfully, the new configuration shows up in the Existing Configurations table on the same page, with its Platform, Issuer, Client ID, and Status. You can delete configurations from this table if you ever need to unregister.

D2L Brightspace 透過 LTI Advantage 管理介面提供動態註冊（Dynamic Registration）。您需要管理員存取權限。

開啟註冊畫面

1. 以管理員身份登入您的 Brightspace 實例。
2. 前往 Admin Tools > Manage Extensibility > LTI Advantage。
3. 點選 Register Tool。 (直接 URL 為 https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create。)

貼上 URL

您會看到一個註冊表單。關鍵欄位是 Tool initiation registration endpoint（某些 Brightspace 版本會標示為 "Tool Initiation Registration URL"）。

將 FastComments 註冊 URL (在此取得) 貼到該欄位。其餘欄位留空 - 在註冊握手期間會由 FastComments 自動填入。

點選 Register。

核准該工具

Brightspace 會開一個彈出視窗與 FastComments 進行通訊、交換金鑰，並顯示確認畫面。註冊完成後該彈出視窗會自動關閉。

新的工具會出現在您的 LTI Advantage 工具清單中。預設 Brightspace 會將新工具標記為 disabled - 將切換按鈕切換為 enabled，讓課程可以使用它。

新增部署

在 Brightspace 中，LTI 工具在能夠於課程中使用前需要先有一個 deployment：

1. 開啟剛註冊完成的 FastComments 工具。
2. 點選 View Deployments > New Deployment。
3. 為該部署命名（例如 "FastComments - All Courses"）、選擇該部署應可用的組織單位，然後儲存。

透過此部署首次啟動後，FastComments 會將 deployment_id 鎖定到其設定紀錄 - 在相同 client 底下，來自不同部署的後續啟動將會被拒絕，除非您重新註冊。

使用 Moodle 嗎？ 我們也提供專用的 FastComments Moodle 外掛，比 LTI 1.3 提供更緊密的整合（成績同步掛鉤、更深度的活動報告、原生的 Moodle 設定介面）。請參閱 Moodle 外掛安裝指南。如果您想要一次註冊同時涵蓋其他 LMS，或是您的 Moodle 管理員不會安裝第三方外掛，下列的 LTI 1.3 流程會是正確的選擇。

Moodle 4.0+ 支援透過 External Tool 外掛進行 LTI 1.3 動態註冊。

開啟工具管理畫面

1. 以網站管理員身分登入 Moodle。
2. 前往 Site administration > Plugins > Activity modules > External tool > Manage tools。

貼上 URL

您會看到一個標示為 Tool URL 的卡片。將 FastComments 註冊 URL（在此取得）貼到文字欄位，然後點選 Add LTI Advantage。

Moodle 會開啟一個註冊畫面，顯示此工具的身分以及它要求的權限。檢查後點選 Activate（或視 Moodle 版本為 Register）。

註冊完成後彈出視窗會關閉；新的 FastComments 工具會出現在 Tools 清單中，狀態為 Active。

使其可用

預設情況下 Moodle 會將新工具加入「Course tools」清單，但不會在活動選擇器中顯示。要在整個課程中顯示 FastComments：

1. 點選 FastComments 欄位上的齒輪圖示。
2. 在 Tool configuration usage 下，選擇 Show in activity chooser and as a preconfigured tool。
3. 儲存。

教師現在可以透過 Add an activity or resource > FastComments 將 FastComments 新增到任何課程中。

Blackboard Learn SaaS 與 Ultra 支援 LTI 1.3 的動態註冊。

開啟工具提供者畫面

1. 以系統管理員身份登入 Blackboard。
2. 前往 管理員面板 > 整合 > LTI 工具提供者。
3. 點選 Register LTI 1.3 / LTI Advantage Tool。

如果您只看到「Register LTI 1.1 Provider」，表示您的 Blackboard 版本尚未支援 LTI 1.3 — 請升級或聯絡 Blackboard 支援團隊。

貼上 URL

將 FastComments 註冊 URL (在此取得) 貼到 Client ID / Registration URL 欄位（Blackboard 在不同版本的標示可能有所不同）。提交。

Blackboard 會與 FastComments 執行註冊握手並顯示確認畫面。

核准並啟用

Blackboard 預設會將新註冊的工具標示為 已核准但被排除：

1. 在工具提供者清單中尋找 FastComments 條目。
2. 打開選單並選擇 編輯。
3. 將 工具狀態 設為 核准。
4. 在 機構政策 下，檢視會傳送哪些使用者資料（姓名、電子郵件、角色）。儲存。

該工具現已可供教師在課程新增內容時使用。

Sakai

Sakai 在包含 LTI Advantage 的發行版本中支援 LTI 1.3 的動態註冊。從 管理工作區：

1. 以 Sakai 管理員身分登入並開啟 管理工作區。
2. 選擇 External Tools > Install LTI 1.3 Tool。
3. 貼上 FastComments 的註冊 URL (在此取得) 並提交。
4. 在握手完成後核准該工具。

該工具會出現在 External Tools 下，網站維護者即可將其新增至網站。

Schoology

Schoology Enterprise 實例支援 LTI 1.3，但是否提供動態註冊取決於部署。請向您的 Schoology 客戶經理確認。

如果您的 Schoology 實例不提供動態註冊，您需要使用以下端點手動設定整合：

• OIDC 登入 URL: https://fastcomments.com/lti/v1p3/login
• 目標連結 URL: https://fastcomments.com/lti/v1p3/launch
• 公開金鑰集 URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• 重新導向 URL: https://fastcomments.com/lti/v1p3/launch

在 Schoology 提供您 Client ID 和 Deployment ID 後，請聯絡 FastComments 支援以在您的租戶上註冊此設定。

Other LTI 1.3 Platforms

任何遵循 IMS LTI 1.3 Advantage 規範的 LMS 應該都能使用相同的註冊 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. HTML 編輯器內的 Insert Stuff 對話框中，位於 LTI Advantage 底下。這會透過 LTI 深度連結流程將 FastComments 內嵌在 HTML 主題中。

如果 FastComments 未出現在任一選擇器中，表示該部署未對承載課程的組織單位啟用。請您的 Brightspace 管理員開啟 Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments，開啟部署並在 Org Units 底下新增該課程的組織單位（或其上層單位）。

在模組中新增 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. 開啟應放置討論的單元與課程（unit/lesson）。
3. 點選 Add > Existing Activity 並選擇 FastComments（舊版 Brightspace：在 External Learning Tools 底下）。
4. 活動會被新增到課程中。
5. 點選活動標題以重新命名。

任何使用者（教師或學生）第一次開啟該主題時，FastComments 會為該資源連結初始化討論串。討論串綁定到資源連結 ID（resource link ID），因此重新命名或移動主題不會改變所載入的討論串。

在 HTML 主題中內嵌 FastComments

當您希望留言出現在同一個主題頁面內、置於閱讀內容、影片或其他內容下方（而非作為獨立主題）時，請使用此流程。

1. 在模組/課程中開啟或建立一個 HTML 主題。
2. 點選 Edit HTML 開啟 Brightspace 的 HTML 編輯器。
3. 將游標置於想要顯示留言串的位置。
4. 點選 Insert Stuff 按鈕（編輯器工具列中的拼圖圖示）。
5. 在 Insert Stuff 對話框中，捲動至 LTI Advantage 並點選 FastComments。
6. FastComments 會開啟一個深度連結選擇器。確認放置位置（預設選項適用於內容討論）；點選 Insert 或 Continue。
7. Brightspace 會返回 HTML 編輯器並放入一個代表 LTI 啟動的佔位區塊。於主題上點選 Save and Close。

當主題載入時，Brightspace 會以 iframe 替換該佔位區塊，並透過 LTI 自動啟動 FastComments。學生會在線內看到討論串。

單一 HTML 主題可包含多個深度連結的 FastComments 嵌入。每個嵌入都會產生自己的討論串，因為每個深度連結會產生不同的資源連結 ID。

模組主題 vs 內嵌快速連結

選擇「模組主題」方法當：

• 該討論是模組中此步驟的主要活動。
• 您希望該主題出現在 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. 該資源連結的討論串會在 Brightspace 的 iframe 中呈現。

啟動時的角色對應：

• Brightspace Administrator 會成為該討論串的 FastComments admin（完整的管理、刪除、封鎖與設定存取權限）。
• Brightspace Instructor 會成為 FastComments moderator（釘選、隱藏、刪除、封鎖）。
• 其他所有角色（Learner、TeachingAssistant 等）都會成為一般留言者。

留言會以學生的 Brightspace 帳號歸屬。若學生在 Brightspace 編輯他們的姓名或頭像，下一次 LTI 啟動時會同步變更。

Iframe 高度與調整大小

FastComments 在每次呈現討論串或內容變更時（新增留言、展開回覆等），都會發送 org.imsglobal.lti.frameResize 的 postMessage。Brightspace 會監聽該訊息並調整 iframe 高度，以避免討論串被裁切或出現內部捲軸。

如果 iframe 高度維持固定且過短：

• 確認課程是否透過 HTTPS 載入。Brightspace 的 postMessage 監聽器會拒絕混合內容的 iframe。
• 確認沒有瀏覽器擴充套件阻擋 postMessage 通道。
• 對於在 HTML 主題中的內嵌嵌入，周圍的 HTML 不應將 iframe 包在固定高度的容器中。請移除父元素上的任何 inline style="height: ..."。

Brightspace 特有的注意事項

工具未出現在 Add Existing 選擇器中。 表示該部署未對此課程的組織單位啟用。管理員需要將該組織單位（或上層單位）新增到部署的 Org Units 清單中。僅註冊工具本身並不足夠；部署決定哪些課程可以看到該工具。

啟動時出現 deployment_id 不吻合。 FastComments 會以 TOFU 方式將註冊時看到的第一個 deployment_id 鎖定。如果管理員刪除了原始部署並建立新的部署，來自新部署的啟動會因部署不符而被拒絕。解決方法是重新註冊 FastComments（產生新的註冊 URL（在此取得）並重新執行動態註冊）；舊的設定記錄將會被取代。

工具能啟動但顯示「Invalid LTI launch」。 可能是課程位於與部署覆蓋範圍不同的租戶/組織結構，或是在註冊後該部署被停用。請重新檢查 Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled 切換與部署的組織單位清單。

在 FastComments 中缺少名稱與角色。 Brightspace 的 LTI 啟動會帶有 Names and Role Provisioning Services (NRPS) 的宣告。如果課程是從舊的 LTI 1.1 連結升級而來，啟動可能缺少 name 與 email 的宣告。請透過 Add Existing 重新加入 FastComments 主題（不要遷移舊連結），以便啟動使用 LTI 1.3。

嵌入顯示登入畫面而非自動 SSO。 表示該 HTML 主題是以一般 <iframe> 指向 FastComments 的方式插入，而非透過 Insert Stuff > LTI Advantage。一般 iframe 會跳過 LTI 啟動，使用者會被導向公開的 FastComments 頁面。請刪除該 iframe 並透過 Insert Stuff 流程重新插入。

一旦管理員已將 FastComments 註冊為 LTI 1.3 Advantage 工具並核准機構政策後，教師即可透過標準的 Blackboard 放置點將其新增到課程中。實際步驟在 Ultra Course View 與 Original Course View 之間有所不同，兩者皆在下方說明。

Ultra Course View

Ultra Course View 自 2026 年起為 Blackboard Learn SaaS 的預設。

1. 打開課程並前往 Course Content 頁面。
2. 在大綱中將滑鼠懸停或點擊希望放置留言串的位置，然後點選紫色 +（新增內容）按鈕。
3. 選擇 Content Market。Content Market 面板會列出機構核准的所有 LTI 工具與 Building Block 放置項目。
4. 找到 FastComments 方塊並點擊它。Blackboard 會在你開啟 + 選單的位置建立一個內容項目。
5. 預設情況下，該項目會以「對學生可見」條目出現在大綱中，前提是教師個人預設的 Hide from students 為關閉。如果你的預設為 Hidden，該項目會被建立為隱藏，當你準備就緒時，可以在該項目的列上切換可見性選項。
6. 如需重新命名該項目，點擊大綱中的標題並輸入新的標籤。學生在大綱中看到的標題與 FastComments 留言串識別符是獨立的，因此隨時重新命名都是安全的。

如果看不到 Content Market 選項，表示機構已將該放置點隱藏。你也可以透過相同 + 選單中的 More tools，在 LTI Tools 群組下開啟相同的選擇器。

Original Course View

Original Course View 在 Learn SaaS 中仍受支援，並且在 Q4 2024 CU 發行線上的自我託管 Learn 9.1 站點仍為主要體驗。

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. 提交。該工具會以可點擊的項目出現在內容區中。

將其嵌入到項目或文件內

在兩種課程檢視中，教師都可以透過內容編輯器的 LTI Advantage 按鈕，將 FastComments 內嵌到項目、文件或任何富文字欄位的內文中。

Ultra Course View：

1. 建立或編輯一個 Document。
2. 在文件內容中想要留言串出現的位置點擊 Add content。
3. 在編輯器工具列中打開 Insert content 選單並點擊 Content Market（LTI Advantage / Deep Linking 的進入點）。
4. 選擇 FastComments。FastComments 回傳深度連結（deep-link）載荷，Blackboard 會在游標位置插入一個嵌入區塊到文件內文中。
5. 儲存文件。學生在滾動過該處時會看到留言串內嵌呈現。

Original Course View：

1. 編輯任何具有富文字內容的項目。
2. 在內容編輯器工具列中，點擊 Add Content 的加號圖示並選擇 Content Market（在較舊的 Q4 2024 CU 中標示為 Add Content from External Tool）。
3. 選擇 FastComments。編輯器會插入一個參考深度連結資源的佔位區塊。
4. 提交該項目。

每個深度連結嵌入會建立自己的 FastComments 留言串，因此在同一個項目中嵌入兩個 FastComments 區塊就會有兩個獨立的留言串。

可見性、發佈條件與群組限制

FastComments 的內容項目在存取控制規則上與其他 Blackboard 內容項目行為一致。

• Ultra：在該列上點擊可見性選擇器（Visible to students、Hidden from students、Conditional availability）。條件可用性支援日期/時間窗、針對成績簿項目的表現規則，以及針對課程群組的成員規則。
• Original：打開該項目的功能選單並選擇 Adaptive Release 或 Adaptive Release: Advanced，以根據日期、成員、成績或審閱狀態限制該工具的存取。使用項目的 Set Group Availability 來限制至特定課程群組。

FastComments 會遵從 Blackboard 所設定的任何存取門檻。若 Blackboard 將該項目對某個學生隱藏，該學生就不會發生 LTI 啟動，且不會出現在管理者檢視中。

成績簿行為

FastComments 不會透過 LTI Advantage 的 Assignment and Grade Services 回傳成績。FastComments 內容項目不會自動建立成績欄位。

若你的 Blackboard 租戶設定為無論評分元資料為何都會自動為每個新內容項目建立成績簿欄位，則仍會出現一個空的欄位。若要隱藏它：

• Ultra：打開 Gradebook，點擊欄位標題，選擇 Edit，並關閉 Show to students 以及 Include in calculations。若你的機構允許刪除未評分項目的欄位，也可使用 Delete。
• Original：打開 Grade Center，點擊該欄位的箭頭，選擇 Hide from Users (on/off)，並在 Column Organization 下視需要選擇 Hide from Instructor View。

學生會看到的內容

當學生打開 FastComments 項目或滾動到嵌入區塊時：

1. Blackboard 會向 FastComments 發送 LTI 1.3 訊息啟動。學生會透過 SSO 使用其 Blackboard 身分（姓名、電子郵件、頭像、角色）登入，且不會看到登入表單。
2. 留言串在 iframe 中呈現。根據 FastComments 中設定的留言元件選項，將可使用主題式留言、回覆、提及與表情回應等功能。
3. 他們的留言會歸屬於他們的 Blackboard 帳戶。若學生之後在 Blackboard 編輯其姓名或照片，下一次啟動時會更新 FastComments 個人檔案。

從 Blackboard 到 FastComments 的角色對應：

• System Administrator 和 Course Builder 會對應到 FastComments 的 admin。
• Instructor 和 Teaching Assistant 會對應到 FastComments 的 moderator。
• Student、Guest 與 Observer 會對應到 FastComments 的 commenter。

管理者（moderator）會在留言串中每則留言旁看到內嵌的審核控制（置頂、隱藏、停權、刪除）。

留言串範圍（Thread Scoping）

FastComments 以 (Blackboard host, course ID, resource link ID) 作為每個留言串的範圍。相同課程中的兩個 FastComments 項目會產生兩個留言串。相同項目在兩個課程範本間複製（例如透過課程複製）會產生兩個留言串，因為 Blackboard 在複製時會發出新的 resource link ID。若要在課程複製間保留共用留言串，請在進行複製之前使用 Deep Linking 並在 FastComments 中設定明確的 thread URN。

Blackboard 專屬常見問題

Build Content 選單（Original）或 Content Market（Ultra）中找不到 FastComments 方塊。 管理員已核准該工具，但留下一個機構政策阻擋了相關的放置點。前往 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」或「Tool is not deployed」錯誤。 在動態註冊期間註冊的部署範圍（deployment scope）與課程所屬的機構情境不相符。在 Blackboard 的工具提供者條目中，確認 Deployment ID 是否與 FastComments 在此租戶的 LTI 1.3 Configuration 頁面中顯示的值相符。如果不同，刪除該放置並從新的註冊 URL 重新執行動態註冊（在此取得）。

Iframe 高度看起來固定或內容被裁切。 有些 Blackboard 租戶帶有嚴格的 Content Security Policy，會阻擋預設的 LTI iframe-resize postMessage。FastComments 同時發送 Canvas 風格的 lti.frameResize 訊息與 IMS 規範形式的 org.imsglobal.lti.frameResize 訊息以提升相容性，但租戶層級的 CSP 覆寫會阻擋父視窗的監聽器。請你的管理員確認 *.fastcomments.com 已在 LTI 工具允許清單上，且沒有自訂 CSP 標頭剝除 postMessage 事件。確認後，調整大小功能即可正常運作，無需進一步設定。

課程複製會複製留言串。 Blackboard 在課程複製時會為 LTI 放置項目發出新的 resource link ID，因此被複製的課程會從空的留言串開始。這是預期行為。若你需要複製後的課程繼承原始留言串，請在複製前以明確的 thread URN 設定 Deep Linking，或聯絡 FastComments 支援以批次重新對應留言串 ID。

學生在啟動時看到一般性的 Blackboard 錯誤。 原因通常是遺失或過期的 email claim。確認機構對 FastComments 的政策在 User Fields to Send 下已啟用 Role、Name 與 Email Address。儲存後，在新的瀏覽器工作階段中再次啟動。

"註冊令牌未找到、已過期或已被使用"

您註冊 URL 中的令牌 (在此取得) 有效期為 30 分鐘且只能使用一次。如果您的 LMS 花了比較久的時間，或是在註冊成功後又重試，該令牌會被拒絕。請在 FastComments LTI 1.3 Configuration 頁面產生新的 URL 並重新開始。

"Platform rejected registration"

您的 LMS 拒絕了註冊握手。最常見的原因：

• Tool already registered with the same client name. 有些平台（尤其是 D2L）會拒絕再次註冊名稱為 "FastComments" 的工具，除非先刪除先前的設定。請在您的 LMS 中移除舊的工具，然後重試。
• Wrong field in the LMS. 確認您是把 URL 貼到 registration / tool initiation registration endpoint 欄位，而不是 launch URL 或 login URL 欄位。
• The LMS doesn't actually support Dynamic Registration. 舊版的 Moodle 和 Blackboard 會宣稱支援 LTI 1.3，但只允許手動設定。請檢查您平台的文件。

"Failed to fetch platform configuration"

FastComments 無法讀取您 LMS 的 openid-configuration 文件。這種情況少見，通常表示 LMS 提供了格式錯誤或無法存取的 discovery URL。請聯絡您的 LMS 支援人員。

Launch shows "Configuration not found"

要麼是 FastComments 的設定被刪除，要麼是啟動來自我們不認得的 iss/client_id 組合。如果您刪除並重新註冊過，請指示 LMS 移除並重新加入 FastComments 工具，以便取得新的 client_id。

Launch shows "Deployment not registered"

您是從與最初啟動不同的 Brightspace/Moodle/Blackboard 部署啟動 FastComments。FastComments 會在首次啟動時把 deployment_id 鎖定作為安全檢查。要在同一 client 底下新增部署，請聯絡支援 — 我們會把該部署 ID 加到設定中。

Launch shows "Unsupported message_type"

LMS 傳送了 FastComments 不處理的 LTI 訊息（例如 LtiSubmissionReviewRequest）。FastComments 僅支援標準的 resource-link 啟動與 deep-linking 流程。如需加入特定的訊息類型，請與我們聯絡。

Iframe doesn't resize

大多數 LMS 會自動調整 LTI iframe 的大小。如果您的 LMS 沒有這麼做，請確認 LMS 的啟動設定允許工具向父框架傳送 postMessage 事件。FastComments 會發出 Canvas-style（lti.frameResize）和 IMS-spec（org.imsglobal.lti.frameResize）兩種調整大小的訊息。