如何將專案從 Home Planner 傳送至你的 CRM

Home Planner應用程式團隊 · October 13, 2026

連接 HubSpot、Pipedrive、Bitrix24、Salesforce、Google 試算表或你自己的系統，一步即可傳送包含房間、產品、價格和平面圖的專案。

你傳送的每個專案都會作為一筆記錄傳抵 CRM：包含專案連結、房間、帶有 SKU 的產品、數量、價格、總價以及平面圖 PDF。無需從螢幕擷取畫面複製，也無需重新輸入估價單。

本指南說明如何透過 Zapier 連接 HubSpot、Pipedrive、Bitrix24、Salesforce 或 Google 試算表，以及如何透過 URL 連接任何其他系統。

運作方式

1. 一次性設定連接。在應用程式中新增連接：選擇你的 CRM 或貼上自家系統的 URL。
2. 進行設計。與客戶一起規劃房間，並擺設產品與標示價格。
3. 傳送。在開啟的專案中選擇「分享」→「傳送至…」。專案會在數秒之內傳抵你的 CRM。

開始之前

透過 Zapier 連接你的 CRM

每個系統的操作步驟均相同。僅在 Zapier 第 5 步的 CRM 動作有所不同，請參閱下方表格。

在 Home Planner 中

1. 前往「設定」→「商業」→「CRM 與試算表」。或開啟任何專案並選擇 「分享」→「CRM 與試算表」。
2. 選擇「新增連接」並挑選你的系統。
3. 選擇「複製金鑰」。此金鑰會將 Zapier 連結至你的 Home Planner 帳戶。若你沒有 PRO++，這將啟動你的 14 天免費試用。

在 Zapier 中

1. 將 Home Planner 新增至你的 Zapier 帳戶。Home Planner 應用程式目前正在 Zapier 審核中。在正式上架前，請寄電子郵件給我們索取邀請，我們回覆時會提供連結。若應用程式顯示 「開啟預設 Zap」，請改為選擇該選項：觸發條件與 CRM 步驟均已設定完成。
2. 建立一個 Zap，將觸發條件設為 Home Planner → Project Sent。
3. 連結新帳戶並將金鑰貼入 Connection key。Zapier 會顯示應用程式中的連接名稱。
4. 測試觸發條件。Zapier 會載入範例專案，以便你在第一次實際傳送前對應欄位。
5. 新增 CRM 的動作並對應欄位（請參閱表格）。
6. 開啟 Zap。回到應用程式中，連接狀態會變更為「運作中」。若仍顯示「Zap 尚未開啟」，請將 Zap 關閉後再重新開啟。

傳送專案

1. 開啟專案。確認估價單已準備就緒：產品、數量和價格均為客戶將看到的內容。
2. 選擇「分享」→「傳送至…」。每個已啟用的連接都有自己的欄位，例如 「傳送至 HubSpot」。
3. 檢查結果。應用程式會顯示「專案已傳送至 HubSpot」以及房間和產品數量。若你的系統沒有回應，應用程式會顯示 「我們將自動重試」：Home Planner 會在 1 分鐘、10 分鐘和 1 小時後重試。

重複傳送了相同的專案？在 24 小時之內重複傳送未修改的專案不會產生重複記錄。若變更任何內容（價格、數量、圖紙），下次傳送將建立一筆新記錄。

記錄包含的內容

Zapier 和你自己的 URL 都會接收到相同的欄位。價格和總價會與應用程式中的專案估價單一致。

productsText 範例：

Living room:
- Sofa Oslo (SOFA-1042): 1 × 899.00 = 899.00 USD
  - Cushion (CUSH-17): 2 × 25.00 = 50.00 USD
- Oak flooring (Floor_Oak_01): 1 × 540.00 = 540.00 USD

Total: 1489.00 USD

透過 URL (webhook) 連接自家系統

適用於不在列表中的系統或你自己的伺服器。Home Planner 會將記錄以 JSON 格式發送至你的 HTTPS 地址。

1. 選擇「新增連接」→「其他系統（你的 URL）」。輸入按鈕名稱（最多 24 個字元）和 URL。URL 必須以 https:// 開頭。
2. 應用程式會傳送測試請求並顯示，例如：「已驗證：在 0.4 秒內收到回應 200」。
3. 建議做法：複製「簽署金鑰」，並在伺服器上用它驗證每一個請求。

請求內容

在進行任何 JSON 解析之前，請先比對原始請求內文 (raw request body)與簽名，確保內容完全一致。經過解析並重新序列化的內文無法與簽名相符。

const crypto = require('crypto');

// rawBody: the request body exactly as received (Buffer or string), before JSON parsing.
// Express: app.post('/home-planner', express.raw({ type: 'application/json' }), handler)
function isFromHomePlanner(rawBody, header, secret) {
  if (!header) return false;
  const parts = Object.fromEntries(header.split(',').map(p => p.split('=', 2)));
  if (!parts.t || !parts.v1) return false;
  if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
  const expected = Buffer.from(
    crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex'), 'hex');
  const received = Buffer.from(parts.v1, 'hex');
  return expected.length === received.length && crypto.timingSafeEqual(expected, received);
}

你的回應

• 在 15 秒內回傳任何 2xx 即代表傳遞成功。
• 無回應、回傳 5xx、408 或 429：Home Planner 會在 1 分鐘、10 分鐘和 1 小時後重試，並在 2 小時後停止重試。
• 傳回任何其他 4xx、重新定向或憑證錯誤均視為最終失敗：連接狀態會變更為「錯誤」。系統不會跟隨重新定向。
• 不允許使用私人或區域網路的地址，例如 localhost、127.*、10.*、172.16–31.*、192.168.* 以及 169.254.*。

不用 Zapier 使用 Google 試算表。Google Apps Script Web 應用程式可作為 URL 使用。其通常傳回給 script.googleusercontent.com 的 302 回應會被視為已傳遞。

狀態與錯誤

常見問題與解答

這需要多少費用？

傳送至 CRM 包含在 PRO++ 中。若你從未訂閱過 PRO++，建立第一個連接時會開始 14 天免費試用。Zapier 提供免費與付費方案。截至 2026 年 10 月，Salesforce 需要 Zapier 付費方案：請查看 Zapier 定價。

試用期或 PRO++ 到期後會怎樣？

「分享」選單中的「傳送至…」欄位會消失。你的連接仍會保留；你依然可以將其關閉或刪除。只要取得 PRO++，無需重新設定即可恢復使用。

我可以建立多少個連接？

最多 3 個，例如用於交易的 HubSpot，以及用於價格記錄的 Google 試算表。

我建立了新金鑰。為什麼專案停止傳送了？

新金鑰會立即停用舊金鑰。請將新金鑰貼入 Zapier，然後將 Zap 關閉並重新開啟。

有些產品沒有 SKU。傳送時會如何處理？

它們會附帶 Home Planner 產品代碼一起傳送。傳送後，應用程式會告知你數量。

我的客戶會看到任何內容嗎？

不會。記錄只會傳送至你設定好的連接（Zapier 或你的 URL）。只有當你分享連結時，客戶才能看到專案。

我的 CRM 資料安全嗎？

Home Planner 只會傳送資料，絕不會讀取你的 CRM。你可以隨時透過「新金鑰」或「新簽署金鑰」替換金鑰或簽署金鑰。

商標聲明。Home Planner 獨立於 HubSpot, Inc.，未獲得 HubSpot, Inc. 的認可、贊助或附屬。Home Planner 獨立於本頁面提及的其他品牌，且未獲得其認可、贊助或附屬。