كيفية إرسال المشاريع من Home Planner إلى نظام إدارة علاقات العملاء (CRM) الخاص بك

ربط HubSpot أو Pipedrive أو Bitrix24 أو Salesforce أو جداول بيانات Google أو نظامك الخاص، وإرسال مشروع يضم الغرف والمنتجات والأسعار ومخطط الطابق في خطوة واحدة.

يصل كل مشروع ترسله إلى نظام إدارة علاقات العملاء (CRM) كعنصر مجرد: رابط للمشروع، والغرف، والمنتجات مع رموز SKU، والكميات، والأسعار، والمجموع الكلي، بالإضافة إلى مخطط الطابق بصيغة PDF. لا حاجة بعد اليوم لنسخ البيانات من لقطات الشاشة أو إعادة كتابة التقديرات.
يوضح هذا الدليل كيفية ربط HubSpot أو Pipedrive أو Bitrix24 أو Salesforce أو جداول بيانات Google عبر Zapier، وكيفية ربط أي نظام آخر باستخدام رابط URL الخاص به.
كيفية العمل
- الربط لمرة واحدة. أضف اتصالاً في التطبيق: اختر نظام إدارة علاقات العملاء (CRM) أو ألصق رابط URL لنظامك الخاص.
- التصميم. خطط الغرف مع عميلك وزودها بالمنتجات والأسعار.
- الإرسال. حدد مشاركة ← إرسال إلى … في المشروع المفتوح. سيصل المشروع إلى نظام إدارة علاقات العملاء (CRM) الخاص بك خلال ثوانٍ.
قبل البدء
| ستحتاج إلى | السبب |
|---|---|
| اشتراك PRO++ أو الإصدار التجريبي المجاني | يُعد الإرسال إلى نظام إدارة علاقات العملاء (CRM) جزءًا من خطة PRO++. وبدون اشتراك PRO++، يمنحك اتصالك الأول إصدارًا تجريبيًا مجانيًا لمدة 14 يومًا — دون الحاجة لأي دفع. |
| حساب Home Planner | ترتبط الاتصالات بحسابك وتعمل على جميع أجهزتك. سيطلب منك التطبيق تسجيل الدخول عند حفظ الاتصال الأول. |
| مشروع محفوظ في السحابة | لا يمكن إرسال المشروع المخزن على هذا الجهاز فقط. إذ يرتبط السجل بالنسخة المتاحة عبر الإنترنت من المشروع. |
| حساب Zapier (بالنسبة إلى HubSpot وPipedrive وBitrix24 وSalesforce وجداول بيانات Google) | ينقل 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 ← Project Sent.
- ربط حساب جديد ولصق المفتاح في مفتاح الاتصال. يظهر Zapier اسم الاتصال من التطبيق.
- اختبر المحفّز. يحمّل Zapier مشروعًا تجريبيًا، حتى تتمكن من تعيين الحقول قبل أول عملية إرسال حقيقية.
- أضف الإجراء الخاص بنظام إدارة علاقات العملاء (CRM) وعيّن الحقول (راجع الجدول).
- شغّل الـ Zap. بالعودة إلى التطبيق، تتغير حالة الاتصال إلى يعمل. إذا كانت الحالة لا تزال تُظهر "لم يتم تشغيل Zap بعد"، فقم بإيقاف تشغيل الـ Zap ثم إعادة تشغيله.
| النظام | إجراء Zapier | التعيين المقترح |
|---|---|---|
| HubSpot | إنشاء صفقة | Project name ← deal name؛ totals.sum ← amount؛ Project link وProducts (text) وPDF link ← description |
| Pipedrive | إنشاء صفقة | 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. يتطلب خطة Zapier مدفوعة (اعتبارًا من أكتوبر 2026). |
| جداول بيانات Google | إنشاء صف في جدول بيانات | Project name وtotals.sum وProject link وupdated ← أعمدة منفصلة، صف واحد لكل مشروع مرسل |
إرسال مشروع
- افتح المشروع. تأكد من جاهزية المقايسة: المنتجات والكميات والأسعار هي ما سيراه العميل.
- حدد مشاركة ← إرسال إلى …. يظهر كل اتصال مفعّل في صف مستقل، على سبيل المثال إرسال إلى HubSpot.
- تحقق من النتيجة. يظهر التطبيق عبارة تم إرسال المشروع إلى HubSpot مع عدد الغرف والمنتجات. إذا لم يستجب نظامك، فسيعرض التطبيق الرسالة سنعيد المحاولة تلقائيًا: يعاود Home Planner المحاولة بعد دقيقة واحدة، ثم 10 دقائق، ثم ساعة واحدة.
هل أرسلت المشروع نفسه مرتين؟ إن إعادة إرسال مشروع لم يطرأ عليه أي تغيير خلال 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 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 بدون Zapier. يعمل تطبيق الويب Google Apps Script كرابط URL. وتُعد استجابته المعتادة 302 إلى script.googleusercontent.com بمثابة تسليم ناجح.
الحالات والأخطاء
| في التطبيق | ماذا يعني ذلك | ما يجب فعله |
|---|---|---|
| يعمل | تصل المشاريع إلى Zapier أو إلى رابط URL الخاص بك. | لا شيء. |
| متصل | المخطط مرتبط؛ وتصل المشاريع طالما كان مفعّلاً. | إبقاء المخطط مفعّلاً. |
| لم يتم تشغيل Zap بعد | لم يشترك Zapier في هذا المفتاح. | شغّل الـ Zap. إذا كان مفعّلاً، أوقفه ثم أعد تشغيله. |
| مُعطَّل | قمت بـ إيقاف تشغيل الاتصال. ويتم إخفاء صف المشاركة الخاص به. | شغّله مجددًا من داخل الاتصال. |
| خطأ | فشلت عملية الإرسال الأخيرة. يظهر السبب أسفل الحالة. | قم بإصلاح السبب، ثم أرسل مرة أخرى من مشاركة. |
| لم يستجب الخادم | لا توجد إجابة خلال 15 ثانية. | تأكد من أن خادمك يعمل. |
| استجابة الخادم: 404 | رفض نظامك الطلب. | تحقق من رابط URL وسجل الخادم الخاص بك. |
| لم تجتز شهادة الموقع التحقق | شهادة HTTPS منتهية الصلاحية أو غير صالحة. | جدد الشهادة. |
| تعذّر التسليم لمدة ساعتين — توقّف الإرسال | فشلت جميع محاولات إعادة الإرسال. | قم بإصلاح المستقبل، ثم أرسل مرة أخرى. |
| هذا المشروع مخزن على هذا الجهاز فقط | المشروع غير محفوظ في السحابة. | فعل الحفظ السحابي للمشروع. |
الأسئلة والأجوبة
كم تكلفة هذه الخدمة؟
يتضمن اشتراك PRO++ ميزة الإرسال إلى نظام إدارة علاقات العملاء (CRM). يمنحك اتصالك الأول إصدارًا تجريبيًا مجانيًا لمدة 14 يومًا إذا لم تكن قد استخدمت PRO++ من قبل. يوفر Zapier خططًا مجانية وأخرى مدفوعة. واعتبارًا من أكتوبر 2026، تتطلب الخدمة مع Salesforce خطة Zapier مدفوعة: تحقق من أسعار Zapier.
ماذا يحدث عند انتهاء الفترة التجريبية أو اشتراك PRO++؟
تختفي صفوف الإرسال إلى … من خيارات مشاركة. تظل اتصالاتك محفوظة؛ ويمكنك الاستمرار في تعطيلها أو حذفها. بمجرد الحصول على PRO++، ستعمل مجددًا دون الحاجة لإعدادها من جديد.
كم عدد الاتصالات التي يمكنني إنشاؤها؟
ما يصل إلى 3 اتصالات، على سبيل المثال HubSpot للصفقات وجداول بيانات Google لسجل الأسعار.
أنشأت مفتاحًا جديدًا. لماذا توقف وصول المشاريع؟
يؤدي إنشاء مفتاح جديد إلى إيقاف المفتاح القديم فورًا. يُرجى لصق المفتاح الجديد في Zapier، ثم إيقاف تشغيل الـ Zap وإعادة تشغيله.
بعض المنتجات لا تحتوي على رمز SKU. ما الذي يتم إرساله؟
يتم إرسالها باستخدام أكواد منتجات Home Planner. يخبرك التطبيق بعددها بعد عملية الإرسال.
هل يرى عميلي أي شيء؟
لا. يذهب السجل إلى الاتصال الذي قمت بإعداده (Zapier أو رابط URL الخاص بك). لا يرى عميلك المشروع إلا عندما تشارك الرابط معه.
هل بيانات نظام إدارة علاقات العملاء (CRM) الخاصة بي آمنة؟
يقوم Home Planner بالإرسال فقط — ولا يقرأ بيانات نظام إدارة علاقات العملاء (CRM) الخاصة بك أبداً. يمكنك استبدال المفتاح أو مفتاح التوقيع في أي لحظة عبر مفتاح جديد أو مفتاح توقيع جديد.
إشعار العلامة التجارية. إن Home Planner تطبيق مستقل عن شركة HubSpot, Inc. وليس معتمدًا منها أو برعايتها أو تابعًا لها. كما أن Home Planner مستقل عن العلامات التجارية الأخرى المذكورة في هذه الصفحة وليس معتمدًا منها أو برعايتها أو تابعًا لها.
تجربته في مشروعك
تطبيق مجاني لتخطيط الغرف والتصميم الداخلي


