要用起來先準備什麼 · DodoSpeak 幫助中心

受眾：採購 / 整合負責人 · 適用：DodoSpeak Oral

目標：上線前先選定嵌入方式，再按方式把套餐、密鑰、掛載與完成態列清。試用可改方式；正式鎖定。兩種都要時另開 Oral 機構帳號，獨立運行。

先確認 Oral 適合你們，見什麼是 DodoSpeak Oral、選 Oral、SaaS 還是私有部署。嵌入方式對照見兩種正式接入。

採購要定的

套餐：Speak Lite / Class / Assess / Exam。套餐決定「能不能用任務、記錄、考試」，不會把四個入口從介面藏掉。詳見套餐、權利與用量。
機構：可先在官網開通口語接入台試用（沙箱）；正式機構與 機構密鑰 以商務開通為準（密鑰只給後端）。
用量口徑：按 50 人檔 與計費分鐘（詳見分鐘池與計費）；開通表單填 預估學員規模 用於建議檔數；Oral 相對整站 SaaS 同分鐘約 2/3 單價。

嵌入方式是上線分叉，不是另一檔價格：頁面掛件與 登入換票 能力與價格相同。試用可在接入台來回切；轉正前再鎖死。兩種都要 → 再開一個 Oral 機構帳號。見下文與兩種正式接入。

整合要準備的

按這個順序做，不必一次做完。

選定頁面掛件或登入換票（分叉點）
無伺服器 / 不能改登入 → 頁面掛件（須名冊學員碼）。已有登入、要按學號寫回 LMS → 登入換票。對照兩種正式接入。
試用可改；正式後本機構帳號鎖定，不能自助更換。兩種都要：新開一個 Oral 機構帳號，同一學校可以掛兩個帳號（掛件一套、換票一套），用量、鑰匙、名冊/換票身份分開，獨立運行。不要寫成一個正式機構裡兩種方式熱切換。
憑證（按已選定的方式）
- 換票：用 機構密鑰 在你們伺服器換 嵌入令牌。禁止把機構密鑰放進瀏覽器、App 包或前端倉庫。
- 掛件：使用 可發佈鑰匙，登記 Origin，並完成 名冊學員碼（或 OTP/PIN）；店鑰匙仍不要進頁面。
前端掛載
頁面放容器，引入嵌入腳本，調用 OralEmbed.mount。表面可選練習 / 任務 / 記錄 / 考試（須套餐允許）。可傳 主題 token 做外觀個性化。見怎麼嵌進你們的系統。
完成態與成績以 API 為準
嵌入頁會回調「看起來完成了」；成績、是否交卷、用量請再調你們後端，由後端問 Oral API（或收 Webhook）。見如何取得考試成績與查看記錄。
安全與域名
登記允許嵌入的 Origin；按需配 CSP / iframe 祖先。麥克風權限由瀏覽器向學生要。
（可選）先上接入台對照
官網開通試用（含預估學員規模）→ 登入口語接入台，走一遍學員 / 發布人 / 管理者 / 開發者（管理者見管理者：設定樞紐、帳單與名冊）。試用期可在設定裡切換嵌入方式。不要把這四角色寫成你們生產系統的角色。

上線前清單

先勾選嵌入方式，再只做該路徑的清單。共用項兩種都要勾。

先選定嵌入方式

已選定 頁面掛件 或 登入換票（對照兩種正式接入）
已理解：試用可改；正式後本帳號鎖定
若兩種都要：已另開 Oral 機構帳號，兩套獨立運行（不要共用一把店鑰匙、同一份名冊當唯一身份源）

共用（無論哪種）

套餐與合同用量口徑已確認
至少一個表面 OralEmbed.mount 成功開口
Origin / CSP 已按生產域名登記
完成態 / 成績已用 API 對賬（若需要寫回）
套餐不足時的提示已設計（接口會拒絕，按鈕仍可看見）

僅頁面掛件

名冊就緒，能發學員碼（或 OTP / PIN）
使用 可發佈鑰匙；機構密鑰不進頁面
學員能先認人（掃碼 / 輸碼）再開口

僅登入換票

機構密鑰只在服務端
能簽發並重新整理短時 嵌入令牌
外部用戶 id 與 LMS 學號對齊

「能簽發短時令牌」只屬於換票。掛件是認人後由平台代簽，不要兩邊都勾。