如何从 Home Planner 发送项目至你的 CRM

Home PlannerApp 团队 · 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. 连接新账号并将密钥粘贴到 连接密钥 中。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。格式必须以 https:// 开头。
2. 应用会发送一个测试请求并显示，例如：已验证：0.4 秒内响应 200。
3. 推荐操作：复制签名密钥并在你的服务器上验证每个请求。

请求内容

在进行任何 JSON 解析之前，务必根据原始请求正文（与接收到的完全一致）来验证签名。经过解析并重新序列化的正文将无法匹配签名。

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 独立于本页面提及的其他品牌，未获得其认可、赞助或存在附属关系。