建立沙箱並將變更部署至生產

請注意：2026 年 4 月 30 日起，舊版標準沙盒將停止服務。此日期之後，您將無法再使用 舊版標準沙盒。若要建立新的沙盒，請瞭解如何 建立沙盒並將變更部署至生產環境。為協助您順利過渡，我們已暫時提高現有舊版沙盒使用者的建立上限。透過此臨時調整，您可在舊版沙盒仍可用的情況下建立新的標準沙盒，以便您手動遷移已連接的應用程式，並熟悉更新後的操作體驗。請前往 HubSpot 社群。

開始之前

了解需求

限制與注意事項

• 在 2026 年 4 月 30 日前，每個帳戶可額外存取一個沙盒（標準沙盒）。
• 預設情況下，生產環境中的所有超級管理員將在建立沙盒時一併複製至該沙盒。
  • 建立後，若您將超級管理員新增至生產環境帳戶，則需手動將其新增至沙盒帳戶。
  • 建立後，當超級管理員從生產環境帳戶中移除時，系統會自動將其從沙盒帳戶中移除。
• 進一步了解「部署至生產環境」功能所支援的物件設定與資產。
• 聯絡人、公司、商機、服務單及自訂物件的 ID 在沙盒帳戶與生產環境帳戶之間將有所不同。您可以考慮建立一個新的自訂屬性（例如「外部記錄 ID」），並使用自動化流程將生產環境的記錄 ID 複製到此欄位中，之後若需進行測試，即可在沙盒中使用該欄位。
• 整個沙盒帳戶的所有工作流程中，每日最多只能加入 100,000 筆記錄。超過此上限的任何額外工作流程加入請求都將被忽略。當達到上限時，系統會在您的帳戶中通知您，並告知您何時可以再次同步。
• 若某種資產類型在建立時無法複製至標準沙盒帳戶，依賴該資產類型的資產亦將無法同步。例如，由於問卷調查不符合複製至標準沙盒帳戶的資格，所有將問卷調查用作觸發器或動作的工作流程均不會被複製。 
• 您生產環境帳戶中的整合功能不會自動連接到標準沙盒帳戶。對於任何您希望連接到沙盒帳戶的現有整合功能，HubSpot 建議您連接到該整合功能的沙盒版本，以避免對您的 CRM 資料造成中斷。
• 無法將生產環境資料重新同步至現有的沙盒環境。

建立標準沙盒

建立沙盒的方法：

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的settings「設定圖示」。
2. 在左側邊欄選單中，選取「Sandboxes」。
3. 點擊「建立沙盒」。
   
   
   
4. 在右側面板的「沙盒名稱」欄位中，輸入沙盒名稱。
   • 由於沙盒必須模擬您的生產環境帳戶，因此「複製生產環境資產」核取方塊預設為勾選狀態。點擊向下箭頭圖示，檢視將被複製到沙盒的資產清單。
   •  勾選「複製 5,000 個聯絡人及其相關記錄」核取方塊，即可複製您最近更新的 5,000 個聯絡人，以及每個聯絡人最多 100 筆相關的商機、公司和服務單。

請注意： 您可在建立標準沙盒時複製 5,000 筆聯絡人及其相關記錄。若未在建立沙盒時複製記錄，您可於日後將測試記錄匯出並匯入至沙盒中。 對於以下各物件，您可手動匯入每種記錄類型最多 200,000 筆記錄：聯絡人、公司、商機、服務單、自訂物件、購物車、發票、行銷活動及訂單。至於其餘的記錄類型，請瞭解如何追蹤您的 CRM 資料使用量。

6. 點擊「建立標準沙盒」。
7. 建立沙盒的過程可能需要數小時，具體時間取決於需從生產帳戶複製的資產數量、生產計畫功能以及超級管理員的數量。瞭解沙盒帳戶中如何處理超級管理員。
8. 建立狀態將顯示於「活動日誌」頁籤的「狀態」欄位中。
9. 建立完成後，狀態將會更新。
   
   
   
10. 點擊沙盒旁的状态以查看建立詳情。 
    • 點擊「失敗的資產」標籤頁，查看任何失敗的資產及其錯誤詳細資訊。
    • 點擊「已複製資產」標籤頁，即可查看已建立資產的清單。
      
      
      

當部署完成時，發起部署的超級管理員也會收到電子郵件通知。此電子郵件將提供一個連結，導向至部署狀態詳細資訊頁面，您可在該頁面檢視已成功部署的資產以及任何失敗的資產。接著，您可以比較沙盒帳戶與生產環境帳戶之間的資產，並視需要進行任何變更。

存取標準沙盒

所有在建立沙盒時被複製的超級管理員，皆可從其主帳戶選單存取沙盒。

1. 在您的 HubSpot 帳戶中，點擊右上角的帳戶名稱。 
2. 將滑鼠懸停在您的 帳戶名稱上，即可查看最近使用的帳戶清單。 
3. 在下拉式選單中，點擊您要存取的沙盒名稱。
   
   
   
4. 視窗頂端將顯示一個橫幅，表明您目前位於標準沙盒帳戶中。

 超級管理員亦可透過帳戶設定存取沙盒：

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的settings「設定圖示」。
2. 在左側邊欄選單中，選擇「沙盒」。
3. 點擊您要存取的沙盒名稱。 
4. 若要退出沙盒帳戶，請點擊右上角的正式環境帳戶名稱。

設定生產環境部署

在沙盒中完成變更後，即可將受支援的資產部署至您的生產環境帳戶。要 設定生產環境部署，請 導航至您的生產環境帳戶，然後：

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的settings「設定圖示」。
2. 在左側邊欄選單中，選取「沙盒」。
3. 在右上角，點選「設定部署」。
   • 在「受支援的資產類型」欄位中，選取您要部署的資產。若要部署物件，請在資產旁點擊「選取設定」。
   • 若要了解每種資產可部署的項目，請在頂部橫幅中點擊「檢視 [X] 部署行為」。在右側面板中檢視相關資訊，然後點擊「關閉」。
     
     
     
4. 勾選每個符合部署資格的變更旁之核取方塊。若您要部署物件，此選項位於右側面板中，且您必須點擊「儲存選取項目」。

請注意：每次最多可部署 300 項變更。 

7. 點擊「下一步」。 
8. 所有連線將顯示於「已連線資產」步驟中。已連線資產是指您所選資產所使用的其他資產，且這些資產是部署所必需的。
   
   • 在「名稱」欄位中 點擊「檢視物件設定」，即可根據連線檢視將被部署的內容。
   • 在「被使用於」欄位中 點選「x 個已選取資產」以檢視相關連線。

   • 若要將此設定納入部署，請勾選「將 x 個連線新增至我的部署」核取方塊，然後按一下「下一步」。

9.  系統將自動偵測任何衝突。請檢視錯誤並解決所有衝突，以繼續進行部署。若未偵測到衝突，請按一下「下一步」。
10. 在「部署名稱」欄位中，輸入部署的名稱。在「說明」欄位中，輸入說明文字。點擊「下一步」。
11. 檢視您的生產環境部署。準備就緒後，請按一下「部署至生產環境」。
12. 點擊「部署至生產環境」以確認。

13. 部署開始後，生產環境的「活動日誌」分頁中的「狀態」欄位將顯示「進行中」。部署一旦開始，便無法取消。
14. 部署完成後，狀態將更新為 [#] 個已部署資產。

• 請注意：若部署失敗，請檢視部署錯誤日誌以確認可能的失敗原因。如需進一步協助，請聯絡支援團隊。

15. 點擊部署名稱或 [#] 已部署資產 以檢視部署詳細資訊。

檢視沙盒活動

若要檢視使用者在您的帳戶中執行的沙盒操作歷史記錄：

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的settings「設定圖示」。
2. 在左側邊欄選單中，導航至「沙盒」。
3. 點擊「活動日誌」分頁。
4. 系統將顯示完整的沙盒相關活動清單，包括：
   • 沙盒建立詳情（例如：複製的資產及錯誤原因）
   • 過去的生產環境部署
   • 沙盒刪除記錄
5. 點擊「日誌類型」下拉式選單，可篩選不同類型的活動。

沙盒最佳實務

沙盒讓使用者能在生產環境帳戶之外安全地進行創新。建議制定開發策略，並考量以下方面以確保在沙盒中進行可靠的測試：

• 沙箱的用途為何？（例如：積極開發、整合測試、培訓）。
• 誰需要存取權限？（例如：考慮限制可能影響測試可靠性的衝突）
• 是否需要建立更多沙箱以支援各種使用情境？
• 如何建立與管理沙盒以最佳方式支援開發需求？

明確界定這些方面，將有助於進行可靠的測試，並將受支援的資產部署至生產環境，同時兼顧其他使用情境。

以下列舉了沙箱的不同用途、應獲取存取權限的使用者，以及確保可靠測試與開發的建立策略：