Home Planner 프로젝트를 CRM으로 전송하는 방법

HubSpot, Pipedrive, Bitrix24, Salesforce, Google Sheets 또는 자체 시스템을 연결하여 방, 제품, 가격, 평면도가 포함된 프로젝트를 한 번에 전송해 보세요.

보낸 프로젝트는 CRM에 한 건의 데이터로 기록됩니다. 프로젝트 링크, 방, SKU가 포함된 제품, 수량, 가격, 총액, 평면도 PDF가 모두 포함되어 스크린샷을 일일이 복사하거나 견적을 다시 입력할 필요가 없습니다.
이 가이드에서는 Zapier를 통해 HubSpot, Pipedrive, Bitrix24, Salesforce 또는 Google Sheets를 연결하는 방법과 URL을 통해 다른 모든 시스템을 연결하는 방법을 안내합니다.
작동 방식
- 한 번만 연결하세요. 앱에서 연결을 추가해 보세요. CRM을 선택하거나 사용 중인 시스템의 URL을 붙여넣으면 됩니다.
- 디자인하세요. 고객과 함께 방을 구상하고 제품 및 가격을 배치해 보세요.
- 전송하세요. 연 프로젝트에서 공유 → …(으)로 보내기를 선택하세요. 몇 초 만에 프로젝트가 CRM에 등록됩니다.
시작하기 전에
| 필요한 항목 | 이유 |
|---|---|
| PRO++ 또는 무료 체험판 | CRM 전송 기능은 PRO++에서 제공됩니다. PRO++ 구독자가 아니더라도 첫 연결 시 14일 무료 체험이 시작되며, 결제 정보는 입력하지 않아도 됩니다. |
| Home Planner 계정 | 연결 정보는 계정에 저장되어 모든 기기에서 공유됩니다. 첫 연결 정보를 저장할 때 로그인 창이 열립니다. |
| 클라우드에 저장된 프로젝트 | 이 기기에만 저장된 프로젝트는 전송할 수 없습니다. 데이터는 온라인 프로젝트 복사본에 링크됩니다. |
| Zapier 계정(HubSpot, Pipedrive, Bitrix24, Salesforce, Google Sheets 연결 시) | Zapier가 프로젝트 데이터를 CRM으로 전달합니다. Zapier는 무료 및 유료 요금제를 제공합니다. 2026년 10월 기준, Salesforce를 연결하려면 Zapier 유료 요금제가 필요합니다(Zapier 요금 안내 참조). |
Zapier로 CRM 연결하기
연결 방식은 모든 시스템에서 동일합니다. 5단계의 CRM 동작 방식만 다르며, 자세한 내용은 아래 표를 참고하세요.
Home Planner에서 설정하기
- 설정 → 비즈니스 → CRM 및 스프레드시트로 이동하세요. 또는 프로젝트를 연 후 공유 → CRM 및 스프레드시트를 선택하세요.
- 연결 추가를 선택한 후 사용 중인 시스템을 지정하세요.
- 키 복사를 선택하세요. 이 키로 Zapier와 Home Planner 계정이 연결됩니다. PRO++를 구독하지 않은 경우 이때 14일 무료 체험이 시작됩니다.
Zapier에서 설정하기
- Zapier 계정에 Home Planner를 추가하세요. 현재 Home Planner 앱은 Zapier 심사 진행 중입니다. 등록이 완료될 때까지 이메일로 초대장을 요청해 주시면 링크를 보내드립니다. 앱에 준비된 Zap 열기가 표시되면 해당 항목을 선택하세요. 트리거와 CRM 연동 설정이 이미 구성되어 있습니다.
- Home Planner → Project Sent 트리거를 사용해 Zap을 생성하세요.
- 새 계정을 연결하고 연결 키 항목에 키를 붙여넣으세요. Zapier에 앱에서 설정한 연결 이름이 표시됩니다.
- 트리거를 테스트하세요. Zapier가 샘플 프로젝트를 불러오므로 실제 전송 전에 필드를 미리 매핑할 수 있습니다.
- CRM에 맞는 작업을 추가하고 필드를 매핑하세요(표 참고).
- Zap을 켜세요. 앱으로 돌아오면 연결 상태가 작동 중(으)로 변경됩니다. 여전히 "Zap이 아직 켜져 있지 않아요"라고 표시되면 Zap을 껐다가 다시 켜보세요.
| 시스템 | Zapier 작업 | 권장 매핑 방식 |
|---|---|---|
| HubSpot | Create Deal | Project name → deal name, totals.sum → amount, Project link, Products (text) 및 PDF link → description |
| Pipedrive | Create Deal | Project name → title, totals.sum 및 totals.currency → value, Products (text) → note |
| Bitrix24 | Create Deal 또는 Create Lead | Project name → title, totals.sum → amount, Products (text) → comment |
| Salesforce | Create Record → Opportunity | Project name → name, totals.sum → amount, Project link → description (2026년 10월 기준 Zapier 유료 요금제 필요) |
| Google Sheets | Create Spreadsheet Row | Project name, totals.sum, Project link, updated 항목을 각 열에 매핑(보낸 프로젝트당 1행 추가) |
프로젝트 보내기
- 프로젝트를 열어두세요. 제품, 수량, 가격 등 고객에게 안내할 견적 내용이 모두 올바르게 작성되었는지 확인하세요.
- 공유 → …(으)로 보내기를 선택하세요. 활성화된 연결마다 별도의 행이 생성됩니다(예: HubSpot으로 보내기).
- 결과를 확인하세요. 전송이 완료되면 앱에 포함된 방과 제품 수와 함께 HubSpot으로 프로젝트를 보냈어요 문구가 표시됩니다. 시스템 응답이 없는 경우 자동으로 다시 보낼게요 메시지가 나타나며, Home Planner가 1분, 10분, 1시간 후에 재시도합니다.
동일한 프로젝트를 두 번 보냈나요? 내용을 변경하지 않고 24시간 이내에 다시 보낸 프로젝트는 중복 생성되지 않습니다. 가격, 수량, 평면도 등 변경 사항이 하나라도 있으면 다음 전송 시 새 데이터로 등록됩니다.
전송 데이터 항목
Zapier와 고유 URL 모두 동일한 필드 데이터가 전송됩니다. 가격과 총액은 앱 내 프로젝트 견적과 일치합니다.
| 필드 | 포함 데이터 |
|---|---|
| planName | 프로젝트 이름 |
| revisionUrl | 온라인 프로젝트 링크(고객이 웹 브라우저나 앱에서 바로 열 수 있음) |
| pdfUrl | 평면도 PDF(도면 내보내기가 포함된 요금제에서 제공되며, 파일은 7일간 보관되므로 CRM에 보관하세요) |
| totals.sum, totals.currency, totals.items | 견적 총액, 통화 단위, 견적 품목 수 |
| productsText | 방, 제품, SKU, 수량 × 가격 등 견적 전체 내용(비고 또는 설명란에 활용하기에 적합함) |
| rooms[] | 각 방의 정보(이름, 유형, 면적, 크기, 포함 품목) |
| rooms[].items[] | 각 제품 및 자재 정보(itemNumber (SKU), 이름, 수량, 가격, 합계, imageURL, 구성 요소) |
| client_reference_id | 해당 전송 건의 고유 식별자 |
| created, updated | 프로젝트 최초 생성 일시 및 최종 저장 일시 |
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 USDURL(웹훅)로 나만의 시스템 연결하기
목록에 없는 시스템이나 자체 서버를 사용하는 경우 HTTPS 주소로 JSON 형태의 데이터를 전송할 수 있습니다.
- 연결 추가 → 기타 시스템 (URL 직접 입력)을 선택하세요. 버튼 이름(최대 24자)과 URL을 입력하세요. URL은 반드시 https://로 시작해야 합니다.
- 앱에서 테스트 요청을 보내며, 성공 시 확인됨: 0.4초 만에 200 응답 받음과 같이 표시됩니다.
- JSON 파싱을 거치지 않은 원시 요청 본문(raw request body) 상태 그대로 서명을 검증하세요. 파싱 후 다시 직렬화된 본문은 서명과 일치하지 않습니다.
요청 구조
| 구분 | 값 |
|---|---|
| Method, body | POST, Content-Type: application/json, 위에서 설명한 전송 데이터 |
| X-HomePlanner-Signature | t=<unix time>,v1=<hex> (단, v1 = HMAC-SHA256(secret, t + "." + body)) |
| X-HomePlanner-Delivery | 전송 ID(재시도 시에도 동일하게 유지되므로 중복 수신 방지에 활용 가능) |
서명을 다음과 대조하세요: 원본 요청 본문을 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 응답을 받은 경우 1분, 10분, 1시간 간격으로 재시도하며 2시간 후 중단됩니다.
- 기타 4xx 응답, 리디렉션, 인증서 오류가 발생하면 전송이 취소되고 연결 상태가 오류로 변경됩니다. 리디렉션은 자동으로 추적되지 않습니다.
- localhost, 127.*, 10.*, 172.16–31.*, 192.168.*, 169.254.* 등 사설 또는 로컬 네트워크 주소는 지원되지 않습니다.
Zapier 없이 Google Sheets 연결하기. Google Apps Script 웹앱 URL을 활용할 수 있습니다. script.googleusercontent.com으로 이동할 때 발생하는 일반적인 302 응답도 정상 전송으로 처리됩니다.
상태 및 오류 안내
| 앱 표기 | 의미 | 조치 방법 |
|---|---|---|
| 작동 중 | Zapier 또는 설정한 URL로 프로젝트가 정상 전송되고 있습니다. | 필요한 조치가 없습니다. |
| 연결됨 | 시나리오가 연동되었습니다. 기능을 켜두면 프로젝트가 지속적으로 전송됩니다. | 시나리오를 계속 켜두세요. |
| Zap이 아직 켜져 있지 않아요 | Zapier에 이 키가 등록되지 않았습니다. | Zap을 켜주세요. 이미 켜져 있다면 껐다가 다시 켜보세요. |
| 꺼짐 | 연결을 비활성화했습니다. 공유 메뉴에 해당 항목이 표시되지 않습니다. | 연결 설정에서 다시 켜세요. |
| 오류 | 최근 전송에 실패했습니다. 상태 메시지 아래에서 원인을 확인할 수 있습니다. | 오류 원인을 해결한 후 공유 메뉴에서 다시 보내보세요. |
| 서버가 응답하지 않았어요 | 15초 이내에 응답을 받지 못했습니다. | 서버가 정상 작동 중인지 확인하세요. |
| 서버 응답: 404 | 수신 시스템에서 요청을 거부했습니다. | URL 및 서버 로그를 확인하세요. |
| 사이트 인증서가 확인을 통과하지 못했어요 | HTTPS 인증서가 만료되었거나 올바르지 않습니다. | 인증서를 갱신하세요. |
| 2시간 동안 전달하지 못해 보내기를 멈췄어요 | 모든 재시도가 실패했습니다. | 수신 서버의 문제를 해결한 후 다시 보낼 수 있습니다. |
| 이 프로젝트는 이 기기에만 저장되어 있어요 | 클라우드에 저장되지 않은 프로젝트입니다. | 프로젝트의 클라우드 저장 옵션을 켜세요. |
자주 묻는 질문
이용 요금이 어떻게 되나요?
CRM 전송 기능은 PRO++ 요금제에 포함되어 있습니다. PRO++ 이용 이력이 없는 경우 첫 연결 시 14일 무료 체험이 시작됩니다. Zapier는 무료 및 유료 요금제를 제공하며, 2026년 10월 기준 Salesforce 연동에는 Zapier 유료 요금제가 필요합니다. 자세한 내용은 Zapier 요금 안내를 확인하세요.
무료 체험이나 PRO++ 기간이 끝나면 어떻게 되나요?
공유 메뉴에서 …(으)로 보내기 항목이 숨겨집니다. 기존 연결 정보는 유지되므로 꺼두거나 삭제할 수 있으며, PRO++를 재구독하면 별도 설정 없이 바로 다시 사용할 수 있습니다.
연결은 몇 개까지 등록할 수 있나요?
최대 3개까지 등록할 수 있습니다. 예: 거래 관리용 HubSpot 1개, 단가 기록용 Google Sheets 1개 등
새 키를 발급받은 후 프로젝트가 전송되지 않아요.
새 키를 생성하면 기존 키는 즉시 비활성화됩니다. Zapier에 새 키를 입력한 후 Zap을 껐다가 다시 켜세요.
SKU가 없는 제품은 어떻게 전송되나요?
Home Planner 자체 제품 코드로 전송됩니다. 전송 완료 후 몇 개의 품목이 해당 코드로 대체되었는지 알려드립니다.
고객에게도 데이터가 노출되나요?
아니요. 데이터는 설정한 연결 대상(Zapier 또는 입력한 URL)으로만 전송됩니다. 프로젝트 링크를 직접 공유하기 전까지 고객은 프로젝트를 볼 수 없습니다.
CRM 데이터는 안전하게 보호되나요?
Home Planner는 데이터 전송만 진행하며, CRM 내부 정보를 읽지 않습니다. 보안이 필요한 경우 언제든지 새 키 또는 새 비밀 키 버튼으로 키를 교체할 수 있습니다.
상표권 관련 안내. Home Planner는 HubSpot, Inc.와 무관한 독립 서비스이며, HubSpot, Inc.의 승인, 후원 또는 제휴 관계에 있지 않습니다. 또한 이 페이지에 언급된 다른 모든 브랜드와도 독립적인 관계이며, 해당 브랜드들의 승인, 후원 또는 제휴를 받지 않았습니다.
내 프로젝트에 직접 적용해 보기
iPhone, iPad, Mac, Android, Windows 지원 무료 앱


