איך לשלוח פרויקטים מ-Home Planner אל ה-CRM

ניתן לחבר את HubSpot, Pipedrive, Bitrix24, Salesforce, Google Sheets או מערכת פרטית, ולשלוח פרויקט עם חדרים, מוצרים, מחירים ותוכנית הדירה בצעד אחד.

כל פרויקט שנשלח מגיע ל-CRM כרשומה אחת: הקישור לפרויקט, החדרים, המוצרים עם מק"ט, הכמויות, המחירים, הסכום הכולל וקובץ ה-PDF של תוכנית הדירה. ללא העתקה מצילומי מסך וללא הקלדה מחדש של הצעות מחיר.
מדריך זה מסביר איך לחבר את HubSpot, Pipedrive, Bitrix24, Salesforce או Google Sheets באמצעות Zapier, ואיך לחבר כל מערכת אחרת דרך כתובת ה-URL שלה.
איך זה עובד
- חיבור חד-פעמי. מוסיפים חיבור באפליקציה: בוחרים את ה-CRM או מדביקים את כתובת ה-URL של המערכת.
- עיצוב. מתכננים את החדרים עם הלקוח ומרהטים אותם במוצרים עם מחירים.
- שליחה. בוחרים שיתוף ← שליחה אל... בפרויקט הפתוח. הפרויקט מגיע ל-CRM תוך שניות.
לפני שמתחילים
| מה צריך | למה |
|---|---|
| מנוי PRO++ או תקופת ניסיון בחינם | שליחה ל-CRM היא חלק ממנוי PRO++. ללא מנוי PRO++, החיבור הראשון יפעיל תקופת ניסיון בחינם ל-14 ימים — ללא צורך בתשלום. |
| חשבון Home Planner | החיבורים שייכים לחשבון ופועלים בכל המכשירים. האפליקציה תבקש להתחבר לחשבון בעת שמירת החיבור הראשון. |
| פרויקט השמור בענן | לא ניתן לשלוח פרויקט השמור במכשיר זה בלבד. הרשומה מקשרת לעותק המקוון של הפרויקט. |
| חשבון Zapier (עבור HubSpot, Pipedrive, Bitrix24, Salesforce, Google Sheets) | Zapier מעבירה את הפרויקט ל-CRM. ל-Zapier יש מסלולים בחינם ובתשלום. נכון לאוקטובר 2026, חיבור Salesforce דורש מסלול בתשלום ב-Zapier (ראו מחירון Zapier). |
חיבור ה-CRM באמצעות Zapier
השלבים זהים עבור כל מערכת. רק פעולת ה-CRM בשלב 5 ב-Zapier שונה — ראו את הטבלה למטה.
ב-Home Planner
- עוברים אל הגדרות ← עסקים ← CRM וגיליונות נתונים. לחלופין, פותחים פרויקט כלשהו ובוחרים שיתוף ← CRM וגיליונות נתונים.
- בוחרים הוספת חיבור ובוחרים את המערכת.
- בוחרים העתקת מפתח. המפתח מקשר בין Zapier לחשבון Home Planner. למי שאין מנוי PRO++, פעולה זו תפעיל תקופת ניסיון בחינם ל-14 ימים.
ב-Zapier
- מוסיפים את Home Planner לחשבון ה-Zapier. האפליקציה Home Planner נמצאת כעת בבדיקה ב-Zapier. עד שהיא תופיע ברשימה, אפשר לשלוח לנו דוא"ל לבקשת הזמנה — ונשיב עם קישור. אם באפליקציה מופיע פתיחת ה-Zap המוכן, בוחרים באפשרות זו במקום: הטריגר ושלב ה-CRM כבר מוגדרים.
- יוצרים Zap עם הטריגר Home Planner ← פרויקט נשלח.
- מחברים חשבון חדש ומדביקים את המפתח אל מפתח חיבור. Zapier מציגה את שם החיבור מהאפליקציה.
- בודקים את הטריגר. Zapier טוענת פרויקט לדוגמה, כדי שניתן יהיה להתאים שדות לפני השליחה האמיתית הראשונה.
- מוסיפים את הפעולה עבור ה-CRM ומתאימים את השדות (ראו בטבלה).
- מפעילים את ה-Zap. בחזרה באפליקציה, סטטוס החיבור משתנה ל-פעיל. אם עדיין מופיעה ההודעה "ה-Zap עדיין אינו פעיל", מכבים ומפעילים את ה-Zap מחדש.
| מערכת | פעולת Zapier | מיפוי מומלץ |
|---|---|---|
| HubSpot | יצירת עסקה | שם הפרויקט ← שם העסקה; totals.sum ← סכום; קישור לפרויקט, מוצרים (טקסט) וקישור ל-PDF ← תיאור |
| Pipedrive | יצירת עסקה | שם הפרויקט ← כותרת; totals.sum ו-totals.currency ← ערך; מוצרים (טקסט) ← הערה |
| Bitrix24 | יצירת עסקה או יצירת ליד | שם הפרויקט ← כותרת; totals.sum ← סכום; מוצרים (טקסט) ← הערה |
| Salesforce | יצירת רשומה ← הזדמנות | שם הפרויקט ← שם; totals.sum ← סכום; קישור לפרויקט ← תיאור. דורש מסלול בתשלום ב-Zapier (נכון לאוקטובר 2026). |
| Google Sheets | יצירת שורה בגיליון נתונים | שם הפרויקט, totals.sum, קישור לפרויקט ועודכן ← עמודות נפרדות, שורה אחת לכל פרויקט שנשלח |
שליחת פרויקט
- פותחים את הפרויקט. מודודאים שהצעת המחיר מוכנה: המוצרים, הכמויות והמחירים הם אלה שהלקוח יראה.
- בוחרים שיתוף ← שליחה אל.... לכל חיבור פעיל יש שורה משלו, למשל שליחה אל HubSpot.
- בודקים את התוצאה. האפליקציה מציגה הפרויקט נשלח אל HubSpot עם מספר החדרים והמוצרים. אם המערכת אינה מגיבה, האפליקציה מציגה נתנסה שוב באופן אוטומטי: Home Planner מנסה שוב כעבור דקה אחת, 10 דקות ושעה אחת.
נשלח אותו פרויקט פעמיים? פרויקט ללא שינויים שנשלח שוב תוך 24 שעות לא ישוכפל. שינוי כלשהו — מחיר, כמות, תוכנית — יגרום לכך שהשליחה הבאה תצור רשומה חדשה.
מה מכילה רשומה
אותם שדות מגיעים ל-Zapier ולכתובת ה-URL הפרטית. המחירים והסכומים תואמים להצעת המחיר של הפרויקט באפליקציה.
| שדה | מה הוא מכיל |
|---|---|
| planName | שם הפרויקט |
| revisionUrl | קישור לפרויקט באינטרנט. הלקוח פותח אותו בדפדפן או באפליקציה. |
| pdfUrl | קובץ PDF של תוכנית הדירה. קיים כאשר התוכנית כוללת יצוא שרטוט; הקובץ נשמר ל-7 ימים — מומלץ לשמור אותו ב-CRM. |
| totals.sum, totals.currency, totals.items | סכום הצעת המחיר, המטבע ומספר השורות |
| productsText | הצעת המחיר הכללית כטקסט קריא: חדרים, מוצרים, מק"ט, כמות × מחיר. מומלץ עבור שדה הערה או תיאור. |
| rooms[] | כל חדר: שם, סוג, שטח, גודל והפריטים שבו |
| rooms[].items[] | כל מוצר או חומר: itemNumber (מק"ט), שם, כמות, מחיר, סכום כולל, 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 USDחיבור מערכת פרטית לפי כתובת URL (נקודת קצה/webhook)
עבור מערכת שאינה מופיעה ברשימה, או שרת פרטי. Home Planner שולחת את הרשומה כ-JSON לכתובת ה-HTTPS.
- בוחרים הוספת חיבור ← מערכת אחרת (כתובת ה-URL שלך). מזינים שם ללחצן (עד 24 תווים) ואת כתובת ה-URL. היא חייבת להתחיל ב-https://.
- האפליקציה שולחת בקשת בדיקה ומציגה, למשל, נבדק: תגובה 200 תוך 0.4 שניות.
- מומלץ: להעתיק את סוד החתימה ולבדוק איתו כל בקשה בשרת.
הבקשה
| חלק | ערך |
|---|---|
| שיטה, גוף הבקשה | POST, Content-Type: application/json, הרשומה המתוארת למעלה |
| X-HomePlanner-Signature | t=<unix time>,v1=<hex>, כאשר v1 = HMAC-SHA256(secret, t + "." + body) |
| X-HomePlanner-Delivery | מזהה מסירה. הוא נשאר זהה בכל ניסיון חוזר — ניתן להשתמש בו כדי לדלג על כפילויות. |
יש לאמת את החתימה מול גוף הבקשה הגולמי, בדיוק כפי שהתקבל, לפני כל ניתוח 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);
}התגובה שלך
- כל קוד 2xx תוך 15 שניות נחשב כנמסר.
- ללא מענה, קוד 5xx, 408 או 429: Home Planner מנסה שוב כעבור דקה אחת, 10 דקות ושעה אחת, ומפסיקה לאחר שעתיים.
- כל קוד 4xx אחר, הפניה מחדש או שגיאת אישור סופיים: החיבור עובר לסטטוס שגיאה. האפליקציה אינה עוקבת אחר הפניות מחדש.
- כתובות ברשתות פרטיות או מקומיות אינן מורשות, למשל localhost, 127.*, 10.*, 172.16–31.*, 192.168.* ו-169.254.*.
Google Sheets ללא Zapier. אפליקציית רשת של Google Apps Script פועלת ככתובת URL. תגובת 302 הרגילה שלה ל-script.googleusercontent.com נחשבת כנמסרה.
סטטוסים ושגיאות
| באפליקציה | מה זה אומר | מה לעשות |
|---|---|---|
| פעיל | פרויקטים מגיעים ל-Zapier או לכתובת ה-URL. | שום דבר. |
| מחובר | התרחיש מקושר; פרויקטים מגיעים כשהוא מופעל. | להשאיר את התרחיש מופעל. |
| ה-Zap עדיין אינו פעיל | Zapier עדיין לא נרשמה למפתח זה. | להפעיל את ה-Zap. אם הוא מופעל, לכבות ולהפעיל אותו מחדש. |
| כבוי | החיבור כובה. שורת השיתוף שלו מוסתרת. | להפעיל אותו בהגדרות החיבור. |
| שגיאה | השליחה האחרונה נכשלה. הסיבה מוצגת מתחת לסטטוס. | לתקן את הסיבה, ואז לשלוח שוב מתוך שיתוף. |
| השרת לא הגיב | אין מענה תוך 15 שניות. | לוודא שהשרת פעיל. |
| תגובת שרת: 404 | המערכת דחתה את הבקשה. | לבדוק את כתובת ה-URL ואת יומן השרת. |
| אימות האישור של האתר נכשל | אישור ה-HTTPS פג תוקף או אינו תקין. | לחדש את האישור. |
| לא ניתן היה למסור במשך שעתיים, השליחה הופסקה | כל הניסיונות החוזרים נכשלו. | לתקן את מקבל הנתונים, ואז לשלוח שוב. |
| פרויקט זה שמור במכשיר זה בלבד | הפרויקט אינו שמור בענן. | להפעיל שמירה בענן עבור הפרויקט. |
שאלות ותשובות
כמה זה עולה?
שליחה ל-CRM כלולה במנוי PRO++. החיבור הראשון מפעיל תקופת ניסיון בחינם ל-14 ימים למי שלא היה להם מנוי PRO++ מעולם. ל-Zapier יש מסלולים בחינם ובתשלום. נכון לאוקטובר 2026, חיבור Salesforce דורש מסלול בתשלום ב-Zapier: מומלץ לבדוק את מחירון Zapier.
מה קורה כשמסתיימת תקופת הניסיון או מנוי PRO++?
השורות שליחה אל... נעלמות ממסך שיתוף. החיבורים נשארים שמורים; עדיין ניתן לכבות או למחוק אותם. עם רכישת מנוי PRO++, הם יחזרו לפעול ללא צורך בהגדרה מחדש.
כמה חיבורים אפשר להגדיר?
עד 3, למשל HubSpot עבור עסקאות ו-Google Sheets עבור יומן מחירים.
נוצר מפתח חדש. למה פרויקטים הפסיקו להגיע?
מפתח חדש מנטרל את הישן מיד. יש להדביק את המפתח החדש ב-Zapier, ואז לכבות ולהפעיל את ה-Zap מחדש.
לחלק מהמוצרים אין מק"ט. מה נשלח?
הם נשלחים עם מק"טי המוצרים של Home Planner. האפליקציה תציין את הכמות לאחר השליחה.
האם הלקוח רואה משהו?
לא. הרשומה מגיעה לחיבור שהוגדר (Zapier או כתובת ה-URL). הלקוח רואה את הפרויקט רק כאשר משתפים איתו את הקישור.
האם נתוני ה-CRM בטוחים?
Home Planner רק שולחת נתונים — היא אף פעם לא קוראת את ה-CRM. ניתן להחליף את המפתח או את סוד החתימה בכל רגע באמצעות מפתח חדש או סוד חדש.
הודעה על סימנים מסחריים. Home Planner פועלת באופן עצמאי מ-HubSpot, Inc. ואינה מאושרת, ממומנת או קשורה ל-HubSpot, Inc. Home Planner פועלת באופן עצמאי מהמותגים האחרים המוזכרים בדף זה ואינה מאושרת, ממומנת או קשורה אליהם.
לניסיון בפרויקט שלך
אפליקציה חינמית לתכנון חדרים ועיצוב פנים


