在控制台建立網頁小工具

在「網頁小工具」頁面為你的網站設定點擊通話小工具——無需 API 呼叫。

Web Widgets 頁面（/dashboard/web-widgets）用於建立及管理為 ThunderPhone 可嵌入語音小工具提供支援的可發佈金鑰。 本指南的 API 版本 透過 cURL 完成的所有操作，此頁面均可透過表單完成——並會為你產生嵌入程式碼。

建立小工具#

1. 按一下「新增小工具」並選擇模式
   • 智能體模式 —— 小工具會一律執行你從下拉式選單選取的一個智能體。 這是最簡單的設定方式。
   • Webhook 模式 —— 每次小工具工作階段開始時，ThunderPhone 都會呼叫 你的 webhook URL，而你的伺服器會傳回該訪客的智能體設定 （按頁面路由、已登入使用者、分階段推出）。 將 URL 留空即可使用你組織的預設 webhook； 輸入新的 URL 時，亦可將其設為組織預設值。
2. 列出允許的網域

   必須至少提供一個網域，而瀏覽器只可從你列出的 主機名稱啟動工作階段。允許使用如 *.example.com 的子網域萬用字元（可配對子網域，但不包括裸網域）； 如 * 的裸萬用字元會被拒絕。此清單可防止他人在其他網站隨意 重用你的金鑰，但並非身份驗證機制：瀏覽器以外的指令碼 可傳送任何 Origin 標頭。正式環境不會自動允許 localhost； 如要針對正式 API 進行本機測試，請將其加入清單。

3. 選擇瀏覽器覆寫設定

   勾選頁面會傳送的每項工作階段設定：頁面內容、 變數、語音、語言。新增的小工具不接受任何設定，而 包含已關閉設定的工作階段請求會以 400 失敗。 你的金鑰是公開的，因此只允許你會使用的項目。參閱 瀏覽器覆寫設定。

4. 命名、啟用及建立

   啟用小工具 開關控制金鑰是否接受 工作階段 —— 你可建立已停用的小工具，並在推出時再啟用。

取得嵌入程式碼#

建立後立即顯示的嵌入對話框（或透過每一列的 嵌入 按鈕），會產生已填入可發佈金鑰、可直接貼上的程式碼：

• React —— 適用於使用打包工具應用程式的 <ThunderPhoneWidget /> 程式碼片段。
• Script 標籤 —— 適用於任何網站的 CDN <script> 加樣式表組合。

對話框亦會預覽基本外觀選項——標題、主色、角落位置及淺色／深色主題——並將你的選擇寫入程式碼片段。如需完整的 prop 參考、樣式掛鈎及無介面選項，請參閱 小工具 SDK 文件。

從清單管理小工具#

每一列均可原地編輯：

• 模式／智能體 —— 使用內嵌選單切換智能體與 webhook 模式，或重新指定智能體。
• 網域 —— 以標籤形式新增或移除允許的網域。
• 啟用／停用 —— 每個小工具各有一個切換掣；停用的小工具會立即停止接受工作階段。
• 轉移至組織 —— 將小工具複製或轉移至你所屬的另一個組織（轉移後會從此處移除）。
• 刪除 —— 撤銷可發佈金鑰；小工具會立即在所有網域停止運作。此操作無法復原。

小工具工作階段會顯示於通話記錄，並提供與電話通話相同的逐字稿、錄音及評分。

後續步驟#