デバッグパネル
統合で詰まったら 必携の救援ガイド
管理画面からワンクリックでデバッグパネルを開けば、Widgetとバックエンドの3つのエンドポイントの最新HTTPやり取りを完全に確認できます。エラーコード対照表、cURLワンクリックコピー、「ログ全文をAIに渡して支援を求める」プロンプトテンプレート搭載 — エンジニアにもAIにも使いやすい設計。
為什麼需要 Debug 面板？
Widget 嵌入後若沒反應，工程師會問三件事：...
在哪裡 / 怎麼打開
登入客戶後台 → 進入您要 debug 的 Web Bot → ...
面板長相
打開後會看到三大區塊：...
Token
web_xxxxxxxx最後一次成功 pingchungtair.com · 3 分鐘前
⚡ 立即測試連線📋 複製整份 Debug
📡 最近的請求（每種 endpoint 各 1 筆）
14:32:18POST/api/widget/message200 ✅
Originhttps://chungtair.com
IP1.2.3.4
Request
{"token":"web_abc","message":"hi"}Response
{"success":true,"reply":"您好！..."}耗時1.2 s
📋 複製為 cURL📋 複製為文字
14:32:15POST/api/widget/ping200 ✅
14:32:15GET/api/widget/config200 ✅
「立即測試連線」流程
- 按下「⚡ 立即測試連線」
- 後端開始 35 秒監聽窗口...
三種複製按鈕怎麼選
| ボタン | 出力形式 | 貼り付け先 |
|---|---|---|
| 📋 cURLとしてコピー | 単一リクエストをcurlコマンドに変換 | エンジニアのターミナル、即再現可能 |
| 📋 テキストとしてコピー | 単一リクエストの全フィールドをプレーンテキストで | ChatGPT / Claude — AIに解釈を依頼 |
| 📋 デバッグ全体をコピー | Token + 最後のping + 全3リクエスト | エンジニア/AIに一括貼り付け、最も完全 |
錯誤碼對照表
| Status | メッセージ | Endpoint | 考えられる原因 | 解決策 |
|---|---|---|---|---|
200 | success | config/ping/message | 全て正常 | なし |
200 | サービス停止中 | message | 管理画面でBotが無効化されている（enabled=false） | 管理画面でBotを有効化 |
400 | bad json | ping | リクエストボディが有効なJSONではない | widget.jsが改変されていないか / Content-Typeを確認 |
400 | reply: "" | message | メッセージが空、文字列でない、または300字超 | メッセージを1〜300文字に収める |
404 | invalid token | config/ping | Widget tokenが存在しないか形式が不正 | Tokenは32文字の小文字hex。コピペで切り取られていないか確認 |
404 | Widget設定が無効または削除済み | message | invalid tokenと同様、またはBotが削除されている | 管理画面から埋め込みコードを再取得して貼り直し |
429 | リクエスト過多 | message | 1分間に同一IPから20件超のメッセージ | 訪問者の連投または攻撃の可能性。トラフィック確認／IPブロック |
429 | リクエスト過多 | ping | 1分間に同一IPから30回超のping | 通常は訪問者の連続リロード。通常利用では発生しません |
500 | システムエラー、後ほど再試行 | message | AI層のエラー（OpenAI / RAG / handoff書き込み） | 少し待って再試行。継続する場合は管理画面アラート確認／サポート連絡 |
把 log 餵給 AI 求救
Debug 面板的「📋 複製整份 Debug」按鈕產生的純文字格式特別為 AI 設計...
我把忠台AI客服的 Widget 嵌入代碼貼到我的網站...