網站、自有網域與寄件網域
管理官網的內容與網址。綁定自己的網域後,行程頁、結帳、付款、會員中心與客人收到的信件連結都改用你的網域。
網站頁
在後台 →「內容與行銷」→「網站」操作。
最上方的「目前網站」顯示生效模式、官網網址、報名/會員網址,以及公司名稱、Logo 與聯絡資料。公司資料沿用公司設定,這裡只顯示目前值,按「修改公司資料」去改。
下方的分頁:
| 分頁 | 內容 |
|---|---|
| 內容 | 選模板、預覽、編輯各內容區塊 |
| 首頁輪播 | 首頁最上方的輪播圖,平台模板與自建前台共用 |
| 分類入口 | 首頁的行程分類,訪客點分類會看到帶這個標籤的行程 |
| 常見問題 | 首頁的常見問題,平台模板與自建前台共用 |
| 關於頁長文 | 平台模板「關於我們」頁的長文 |
| SEO | 搜尋摘要與社群分享的預設內容 |
| 開發者 | 自建前台用的前台金鑰,見自建前台 API |
- 模板預覽只影響你自己的瀏覽器,用的是已儲存的內容。
- 套用模板不會切換網站模式。
- 預覽、套用模板、儲存網址與啟用模式是分開的操作。
權限
| 權限 | 能做什麼 |
|---|---|
| 查看網站 | 查看所有分頁 |
| 編輯網站 | 改模板、內容、關於頁與 SEO |
| 管理網站 | 改網站模式、官網網址,綁定與解除網域 |
這些權限不包含公司資料或財務設定。前台金鑰另有獨立權限。一次修改裡有你沒權限的欄位時,整筆不儲存。
網站模式
「網址與網域」卡片在所有分頁上方。先選網站模式,卡片再依模式顯示欄位。
- 使用平台官網: 用平台的模板當官網。可以填一個「網站網域」,例
www.example.com。官網、行程頁、結帳與會員中心都在這個網域上。 - 使用自建前台: 官網由你自己架設,透過自建前台 API 讀行程資料。報名、結帳、付款與會員中心仍由平台提供。
自建前台依序完成三步:
- 官網網址: 你自己部署的官網,例
https://www.example.com。它的 DNS 由你設定。 - 報名與結帳網域(選填): 平台提供報名與結帳的網域,卡片建議用
shop.<官網根網域>。儲存官網網址後才能綁定。不能填官網的網域或官網的根網域。 - 啟用自建前台: 有綁報名與結帳網域時,要等它顯示「已連線」才能啟用。沒綁就沿用平台網址,可以直接啟用。
要回到平台官網,在卡片選「使用平台官網」。切回會恢復平台模板與搜尋索引,保留官網網址、內容與金鑰。
網站模式與官網網址只會由卡片上的啟用或切回操作改變。綁定或解除網域都不會改網站模式。
綁定自有網域
綁定後,前台就開在你的網域上。這個網域負責行程頁、結帳、付款、會員中心與信件連結,不是只有結帳。
綁定的條件:
- 方案有開通「自有網域」。
- 有管理網站權限,並重新驗證身分。
檢查與解除也要管理網站權限,但不需要開通「自有網域」。所以停用後仍可解除既有綁定。解除另需重新驗證身分。
步驟
- 按「綁定網域」,填完整網域名稱,例
shop.example.com。不要填https://、路徑、連接埠或萬用字元。網域已被別的公司使用時,畫面會說明。 - 把面板列出的 DNS 記錄交給管理 DNS 的人加入:
| 類型 | 名稱 | 值 | 何時加 |
|---|---|---|---|
| CNAME | shop.example.com | customers.tokocloud.tw | 一定要加,而且要一直保留 |
| TXT | _cf-custom-hostname.shop.example.com | 面板上顯示的值 | 只在要預先驗證時加,生效後可刪 |
- 加好後按「重新檢查」。進入頁面時也會自動檢查一次。
- CNAME 不能刪。 憑證續約靠它;刪掉後,憑證會在下次續約時失效。
- 根網域(例
example.com)要 DNS 服務支援 CNAME flattening 或 ALIAS。不支援時請改用子網域。 - 平台不需要你委派整個 DNS 區域,也不提供固定 IP。
你的 DNS 也在 Cloudflare 時,不能預先驗證。驗證在切換 DNS 時才開始,前台會中斷幾分鐘。請安排在離峰時段。
狀態
| 面板狀態 | 意思 | 下一步 |
|---|---|---|
| 等待 DNS | 平台還沒看到 CNAME | 確認 DNS 記錄,稍後按「重新檢查」 |
| 簽發中 | CNAME 已通過,憑證簽發中 | 稍後按「重新檢查」 |
| 憑證就緒 | 憑證已好,前台還沒切換 | 按「重新檢查」;方案未開通時請聯繫平台窗口 |
| 已生效 | 前台已切到你的網域 | 無 |
| 失敗 | 驗證失敗,面板顯示原因 | 依原因修正 DNS 後按「重新檢查」,或取消綁定 |
| 解除尚未完成 | 平台端的設定還沒刪掉 | 按「重試解除」;一直失敗請聯繫平台窗口 |
在生效前的任何狀態都可以取消綁定。取消時平台端刪除失敗,面板顯示「取消尚未完成」,處理方式相同。
生效之後
- 前台改用你的網域。訂單信、付款連結與客人的密碼重設信都改用它。
- 後台仍在
https://<代號>.tokocloud.tw/admin,員工的密碼重設信也指向那裡。你的 DNS 出問題時,後台仍進得去。你的網域上打開後台路徑會顯示找不到頁面。 - 生效前寄出的舊連結(付款頁、訂單頁)會轉到你網域的同一頁。生效前,信件一律用平台網址,客人不會收到打不開的連結。
- 金流商的付款通知仍送到平台網址。你的 DNS 出問題時,付款仍會入帳。
- 切換約一分鐘內全面生效。
- 登入狀態不跨網域。已在平台網址登入的客人,要在新網域重新登入一次。
- 已生效的網域之後出問題(例 CNAME 被刪),面板會顯示警示與「建議解除」。平台不會自動切回平台網址。
網域由平台代為設定時,面板顯示「平台代管」並唯讀。需要調整請聯繫平台窗口。
解除與更換
要換網域名稱,先解除,再綁新的。解除前請先刪掉 CNAME,再按確定。解除後:
- 前台、訂單信與付款連結改回平台網址。
- 已啟用的自有寄件網域一起停用,寄信改回平台寄件身分。
- 約一分鐘內,舊的平台連結可能仍轉到已解除的網域而打不開。
完成後,面板提示要刪掉的 TXT 記錄。平台端設定沒刪成功時,面板顯示「解除尚未完成」,這個網域暫時不能重新綁定。請按「重試解除」。
寄件網域
訂單確認、付款成功、同意書提醒等信件由平台代寄,你不需要準備任何寄信帳號。你能調整的是寄件身分。在後台 →「公司設定」→「郵件設定」操作。
- 預設: 從平台的網域寄出,寄件人名稱用你的公司名稱,客人回信寄到你設定的回覆信箱。不需要設定 DNS。
- 自有寄件網域: 自有網域生效後,可以改用
info@<你的網域>寄信。info可以改成別的寄件人名稱。
啟用自有寄件網域:
- 按啟用。系統用你已綁定的網域,不必另填。
- 把畫面列出的 DNS 記錄交給管理 DNS 的人加入。
- 按重新檢查。通過後改用你的網域寄信。
自有寄件網域驗證失效時,系統自動改用平台網域寄信,信件不會中斷。這和付款憑證不同:付款憑證設錯會直接擋下收款。
›API 與 CLI 對應
| 動作 | 端點 | 權限 |
|---|---|---|
| 讀網站設定與內容 | GET /api/v1/settings/storefront | website.read |
| 改內容,或官網網址與模式 | PATCH /api/v1/settings/storefront | 內容 website.edit;網址與模式 website.manage |
| 改 SEO 預設 | PATCH /api/v1/settings/seo | website.edit |
| 查寄件網域狀態與 DNS | GET /api/v1/settings/sending-domain | role.manage |
| 啟用寄件網域(不帶網域) | POST /api/v1/settings/sending-domain/enable | role.manage |
| 重新檢查 | POST /api/v1/settings/sending-domain/verify | role.manage |
| 停用 | POST /api/v1/settings/sending-domain/disable | role.manage |
- 網站權限字串:
website.read、website.edit、website.manage。前台金鑰另用api_key.manage。 PATCH /api/v1/settings/storefront的模板、已知內容槽與aboutContentMdx在同一交易提交。- 寄件人名稱用
PATCH /api/v1/settings的senderLocalPart(預設info),回覆信箱用emailReplyTo。 - 網域綁定只在後台操作,沒有對外 API。