> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tinyinbox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 疑難排解

> 修正常見的 TinyInbox 小工具和收件匣設定問題。

## 小工具沒有出現

先檢查 script 標籤：

* `src` 指向 TinyInbox 小工具程式。
* `data-tinyinbox-site` 的值和儀表板中的網站金鑰相同。
* 程式碼已放在頁面 `</body>` 前面。
* 你的網站架設工具允許載入第三方 script。

## 訊息沒有進到收件匣

確認安裝小工具的頁面已列在該網站允許的 origins 中。如果儀表板網站允許 `https://example.com`，但你從 `http://localhost:5173` 測試，也需要加入這個本機 origin。

也請確認訪客的瀏覽器可以連到 TinyInbox API。瀏覽器外掛、嚴格的 content security policy，或被封鎖的 script 都可能讓小工具無法送出訊息。

如果原本可以看到的小工具突然在網站上不見了，可能是你的 Pro 試用或訂閱目前不是進行中——當帳務失效時，小工具會自動隱藏。請在儀表板開啟 **Billing** 重新啟用，詳情請見[價格與訂閱](/zh-Hant/guides/pricing)。

## 建立網站時看到「開始 Pro 試用」

建立網站和接收新對話都需要進行中的 Pro 試用或訂閱。請打開 **Billing** 開始試用，透過 Stripe Checkout 約一分鐘即可完成。

## 附件上傳失敗

請參考 [處理對話](/zh-Hant/guides/work-with-conversations) 裡的限制：

* 每則訊息最多 4 張圖片，每張 10 MB 以內，支援 JPEG、PNG、GIF、WebP、AVIF。
* 每則訊息 1 段影片，50 MB 以內，支援 MP4、MOV、WebM、M4V。

若檔案符合限制但仍上傳失敗，可能是訪客的網路阻擋大檔案上傳。請對方換個網路再試，或用其他方式提供附件。

## 沒有收到通知信

請先檢查垃圾信件匣。通知信由 `notifications@notifications.tinyinbox.co` 寄出，請把它加入聯絡人或白名單。

也請確認 TinyInbox 帳號上的 email 地址是你常看的信箱。新對話通知會在一分鐘內寄出，未回覆提醒則在訪客最後一則未回覆訊息的 3 小時後寄出。

## 訪客姓名或 email 缺少

瀏覽器提供的訪客資訊是選填。如果你希望 TinyInbox 信任已登入訪客的 ID、姓名或 email，請使用[已登入訪客辨識](/zh-Hant/guides/identity-verification)。

## 身分驗證失敗

請檢查 token：

* 使用目前網站的 identity secret 簽署
* 使用 `HS256`
* 沒有設定 `typ`，或將 `typ` 設為 `JWT`
* audience 設為 `tinyinbox-widget-identity`
* 包含 `userId` 或 `sub`
* 尚未過期

如果密鑰外洩，請在儀表板輪替密鑰，並更新你的後端環境變數。