如何将项目从 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 格式发送（POST）至你的 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 独立于本页面提及的其他品牌，未获得其认可、赞助或存在附属关系。