公開說明中心
把知識庫文章發佈為可搜尋的客戶說明網站,設定語言和自訂網域。
本頁內容
說明中心讓客戶自己尋找答案,例如下單、退款或產品設定。你在知識庫發佈文章後,GetMyBot 會在獨立網站呈現,並提供搜尋與導覽。
在**「知識庫 → 說明中心」**設定網站。訪客可評價文章是否有用;網站也會為搜尋引擎提供 sitemap。內部文章與草稿不會對訪客顯示。
每個說明中心都有固定網址 https://getmybot.dev/help/{key},其中 {key} 是後台顯示的機器人專屬值。之後可加入 help.example.com 之類的自訂網域,固定網址仍可使用。
哪些文章會出現在網站
由文章狀態決定:
- 已發佈:出現在網站及搜尋結果。
- 內部:只供 AI 代理人使用,不會出現在網站、搜尋、sitemap 或頁面中繼資料。
- 草稿:不公開,也不參與內部搜尋。
導覽由分類決定。只有在**「導覽區段」**選中的分類才會顯示,而且分類需至少有一篇已發佈文章。
若訪客開啟內部文章連結,網站會給出與不存在文章相同的回應,避免洩露隱藏文章名稱。
外觀與語言
- 說明中心名稱和標誌,圖片上限 2 MB。
- 強調色,例如
#2f6df6,用於連結和主要按鈕;不能加入自訂 CSS。 - 可用語言與預設語言。訪客可切換;要求未提供的語言時會使用預設語言。
- 支援聊天連結,即「聯絡支援」按鈕的目的地,只接受
https://。 - 啟用公開說明中心總開關。關閉時公開路由不提供內容。
搜尋與評價
搜尋只涵蓋所選語言的已發佈文章,也搜尋內文,不必與標題完全相同。
每篇文章下方可回答**「這篇文章有幫助嗎?」**。每位訪客每篇文章只能投一次;票數用於知識庫分析,不對訪客公開。網站使用帶簽章且設有 HttpOnly 的 cookie、只接受本站頁面送出的投票,並限制傳送頻率,以防重複或外部投票。
搜尋引擎
**「允許搜尋引擎索引說明中心」**開關控制 robots.txt 和 sitemap:
- 開啟:
robots.txt允許檢索,並指向/help/{key}/sitemap.xml。Sitemap 列出各啟用語言的首頁、所有已發佈文章和最後修改日期。 - 關閉:
robots.txt禁止檢索,sitemap 為空。
變更在搜尋引擎下一次請求時生效。內部文章與草稿不會進入 sitemap 或搜尋引擎使用的頁面資料。
自訂網域
連接網域需要兩筆 DNS 記錄。若網域由網站管理員管理,請將後台顯示的值交給他。
- 在**「自訂網域」**填入
help.example.com等網址。國際化網域會轉成 ASCII。IP 位址、localhost、*.開頭的名稱,以及只有公共後綴而沒有你的網域名稱(例如co.uk)都不能使用;example.co.uk可以。 - 介面會顯示必須同時存在的兩筆記錄:該名稱的 TXT,值為
mybot-help=<token>;以及從該名稱指向應用主機的 CNAME。 - 按**「檢查 DNS」**。TXT 值須完全相符,網域也須指向應用伺服器。
TXT 值只在新增網域後顯示一次,且只儲存在目前瀏覽器。若遺失,請刪除網域後重新加入以取得新值。
網域狀態包括待驗證、已驗證、啟用、驗證失敗、已停用。失敗原因可能是:
- TXT 值不符:發佈了錯誤或過期的權杖。
- DNS 中找不到 TXT:記錄不存在或尚未傳播,可能需要最多 24 小時。
- 網域未指向正確位址:CNAME 或 A 記錄指向其他位置。
HTTPS、路由與停用
GetMyBot 會為已驗證且啟用的網域取得 HTTPS 憑證;未驗證或已停用的網域不會簽發。簽發前 Web 伺服器會透過 API 再次確認網域仍屬於已啟用的說明中心。
啟用時,訪客會進入正確機器人的說明中心,文章網址和所選語言保持不變。網域與機器人的對應最多快取 30 秒,因此停用幾乎立即生效。
停用會關閉公開路由與憑證簽發,但保留網域記錄。停用後不能直接重新驗證;須刪除並重新加入,以取得新 TXT 值。刪除會完全移除記錄。