Home Planner
العودة إلى المدونةأدلة إرشادية

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

Home Planner
Home Plannerفريق التطبيق · October 13, 2026

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

يرسل تطبيق Home Planner تصميم الغرف عبر Zapier إلى HubSpot وSalesforce وجداول بيانات Google وPipedrive

يصل كل مشروع ترسله إلى نظام إدارة علاقات العملاء (CRM) كجلَبة واحدة تتضمن: رابط المشروع، والغرف، والمنتجات مع وحدة حفظ المخزون (SKU)، والكميات، والأسعار، والمجموع الإجمالي، ومخطط الطابق بصيغة PDF. لا حاجة لنسخ لقطات الشاشة أو إعادة كتابة المقايسات.

يوضح هذا الدليل كيفية ربط HubSpot أو Pipedrive أو Bitrix24 أو Salesforce أو جداول بيانات Google عبر Zapier، وكيفية ربط أي نظام آخر باستخدام الرابط الخاص به.

آلية العمل

  1. الاتصال لمرة واحدة. أضف اتصالاً في التطبيق: اختر نظام إدارة علاقات العملاء (CRM) الخاص بك أو ألصق رابط نظامك الشخصي.
  2. التصميم. خطط الغرف مع عميلك وأثثها بالمنتجات والأسعار.
  3. الإرسال. اختر مشاركة ← إرسال إلى … في المشروع المفتوح. سيصل المشروع إلى نظام إدارة علاقات العملاء (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

  1. انتقل إلى الإعدادات ← الأعمال ← نظام إدارة علاقات العملاء وجداول البيانات. أو افتح أي مشروع واختر مشاركة ← نظام إدارة علاقات العملاء وجداول البيانات.
  2. اختر إضافة اتصال وحدد نظامك.
  3. اختر نسخ المفتاح. يربط هذا المفتاح منصة Zapier بحسابك في Home Planner. إذا لم تكن مشتركًا في PRO++، فستبدأ تجربتك المجانية لمدة 14 يومًا.

في منصة Zapier

  1. أضف Home Planner إلى حسابك في Zapier. يخضع تطبيق Home Planner والمحتوى الخاص به للمراجعة حاليًا في Zapier. وحتى يُدرج رسميًا، أرسل إلينا عبر البريد الإلكتروني للحصول على دعوة — وسنرد عليك بالرابط. إذا ظهر في التطبيق خيار فتح Zap الجاهز، فاختره بدلاً من ذلك: حيث يجهز المشغّل وإجراء نظام إدارة علاقات العملاء تلقائيًا.
  2. أنشئ Zap باستخدام المشغّل Home Planner ← إرسال المشروع.
  3. ربط حساب جديد ولصق المفتاح في مفتاح الاتصال. يعرض Zapier اسم الاتصال المأخوذ من التطبيق.
  4. اختبار المشغّل. يحمّل Zapier مشروعًا تجريبيًا لتمكينك من تعيين الحقول قبل الإرسال الفعلي الأول.
  5. إضافة الإجراء الخاص بنظام إدارة علاقات العملاء (CRM) وتعيين الحقول (راجع الجدول).
  6. تشغيل الـ Zap. وبالعودة إلى التطبيق، تتغير حالة الاتصال إلى يعمل. إذا استمرت العبارة "لم يتم تشغيل Zap بعد" بالظهور، فأوقف تشغيل الـ Zap ثم أعد تشغيله مجددًا.
النظامإجراء Zapierالتطابق المقترح
HubSpotإنشاء صفقةاسم المشروع ← اسم الصفقة؛ totals.sum ← المبلغ؛ رابط المشروع والمنتجات (نص) ورابط ملف PDF ← الوصف
Pipedriveإنشاء صفقةاسم المشروع ← العنوان؛ totals.sum وtotals.currency ← القيمة؛ المنتجات (نص) ← ملاحظة
Bitrix24إنشاء صفقة أو إنشاء عميل محتملاسم المشروع ← العنوان؛ totals.sum ← المبلغ؛ المنتجات (نص) ← تعليق
Salesforceإنشاء سجل ← فرصةاسم المشروع ← الاسم؛ totals.sum ← المبلغ؛ رابط المشروع ← الوصف. يتطلب خطة مدفوعة في Zapier (اعتبارًا من أكتوبر 2026).
جداول بيانات Googleإنشاء صف في جدول البياناتاسم المشروع وtotals.sum ورابط المشروع وتاريخ التحديث ← أعمدة منفصلة، صف واحد لكل مشروع مرسل

إرسال مشروع

  1. افتح المشروع، وتأكد من تجهيز المقايسة: المنتجات والكميات والأسعار هي ما سيشاهده العميل.
  2. اختر مشاركة ← إرسال إلى …. يظهر لكل اتصال مفعل صف خاص به، مثل إرسال إلى HubSpot.
  3. تحقق من النتيجة. يعرض التطبيق تم إرسال المشروع إلى HubSpot مع عدد الغرف والمنتجات. إذا لم يستجب نظامك، يظهر في التطبيق سنعيد المحاولة تلقائيًا: يحاول Home Planner الإرسال مجددًا بعد دقيقة واحدة، ثم 10 دقائق، ثم ساعة واحدة.

هل أرسلت المشروع نفسه مرتين؟ لا يتكرر إرسال المشروع غير المعدل إذا أُعيد إرساله خلال 24 ساعة. أما إذا غيّرت أي شيء — كالأسعار أو الكميات أو المخطط — فسيُنشئ الإرسال التالي سجلاً جديدًا.

محتويات السجل

تصل الحقول نفسها إلى Zapier وإلى الرابط الخاص بك. تتوافق الأسعار والمجاميع مع مقايسة المشروع في التطبيق.

الحقلالمحتوى
planNameاسم المشروع
revisionUrlرابط المشروع عبر الإنترنت. يفتحه عميلك في المتصفح أو في التطبيق.
pdfUrlمخطط الطابق بصيغة PDF. يتوفر عندما يتضمن مخططك تصدير الرسومات؛ ويُحتفظ بالملف لمدة 7 أيام — احفظه في نظام إدارة علاقات العملاء (CRM).
totals.sum, totals.currency, totals.itemsالمجموع الإجمالي للمقايسة وعملته وعدد البنود
productsTextالمقايسة بالكامل كنص قابل للقراءة: الغرف، والمنتجات، ووحدة حفظ المخزون (SKU)، والكمية × السعر. يفضل استخدامه لحقل الملاحظات أو الوصف.
rooms[]كل غرفة: الاسم، والنوع، والمساحة، والأبعاد، وعناصرها
rooms[].items[]كل منتج أو مادة: itemNumber (رمز SKU)، والاسم، والكمية، والسعر، والمجموع، ورابط الصورة، والمكونات
client_reference_idالمعرف الفريد لعملية الإرسال هذه
created, updatedتاريخ إنشاء المشروع وتاريخ آخر حفظ له

مثال على productsText:

productsTextyaml
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

ربط نظامك الخاص عبر رابط (webhook)

للأنظمة غير المدرجة في القائمة، أو لخادمك الخاص. يرسل Home Planner السجل بصيغة JSON إلى عنوان HTTPS الخاص بك.

  1. اختر إضافة اتصال ← نظام آخر (الرابط الخاص بك). أدخل اسمًا للزر (حتى 24 حرفًا) والرابط، على أن يبدأ بـ https://.
  2. يرسل التطبيق طلب اختبار ويوضح، على سبيل المثال، تم التحقق: الاستجابة 200 خلال 0.4 ثانية.
  3. يوصى بـ: نسخ مفتاح التوقيع والتحقق من كل طلب باستخدامه على خادمك.

الطلب

الجزءالقيمة
الطريقة، ونوع المحتوىPOST، Content-Type: application/json، السجل الموضح أعلاه
X-HomePlanner-Signaturet=<unix time>,v1=<hex>، حيث v1 = HMAC-SHA256(secret, t + "." + body)
X-HomePlanner-Deliveryمعرف التسليم. يبقى ثابتًا في كل إعادة محاولة — استخدمه لتخطي التكرار.

التحقق من التوقيع مقابل نص الطلب الخام، تمامًا كما استُلم، قبل معالجة أي كود JSON. النص الذي تُجرى معالجته وتحويله إلى تسلسل مجددًا لا يتطابق مطلقًا مع التوقيع.

verify-signature.jsjavascript
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 أو إلى الرابط الخاص بك.لا شيء.
متصلالسيناريو مرتبط؛ وتصل المشاريع أثناء تشغيله.إبقاء السيناريو قيد التشغيل.
لم يتم تشغيل Zap بعدلم يشترك Zapier في هذا المفتاح بعد.شغّل الـ Zap. إذا كان يعمل بالفعل، فأوقفه ثم أعد تشغيله.
مُعطَّللقد أوقفت تشغيل الاتصال. صف المشاركة الخاص به مخفي.شغّله مجددًا من داخل إعدادات الاتصال.
خطأفشل الإرسال الأخير. يُعرض السبب أسفل حالة الاتصال.أصلح المشكلة، ثم أعد الإرسال من خيار مشاركة.
لم يستجب الخادملم تصدر أي استجابة خلال 15 ثانية.تأكد من أن خادمك يعمل.
استجابة الخادم: 404رفض نظامك الطلب.تحقق من الرابط وسجل الخادم لديك.
لم تجتز شهادة الموقع التحققشهادة HTTPS منتهية الصلاحية أو غير صالحة.جدد الشهادة.
تعذّر التسليم لمدة ساعتين — توقّف الإرسالفشلت جميع محاولات الإعادة.أصلح الخلل في نظام الاستقبال، ثم أعد الإرسال.
هذا المشروع مخزن على هذا الجهاز فقطالمشروع غير محفوظ في السحابة.فعّل الحفظ السحابي للمشروع.

الأسئلة الشائعة

كم تبلغ التكلفة؟

تتضمن ميزة الإرسال إلى نظام إدارة علاقات العملاء (CRM) في اشتراك PRO++. تبدأ التجربة المجانية لمدة 14 يومًا مع أول اتصال لك إذا لم يسبق لك الاشتراك في PRO++. يوفر Zapier خططًا مجانية ومدفوعة. واعتبارًا من أكتوبر 2026، يتطلب استخدام Salesforce خطة مدفوعة في Zapier: تحقق من أسعار Zapier.

ماذا يحدث عند انتهاء الفترة التجريبية أو اشتراك PRO++؟

تختفي صفوف الإرسال إلى … من خيار مشاركة. تُحفظ اتصالاتك بدون تغيير؛ ويمكنك إيقاف تشغيلها أو حذفها. وعند الحصول على PRO++، ستعمل مجددًا دون الحاجة لإعدادها من جديد.

كم عدد الاتصالات التي يمكنني إضافتها؟

حتى 3 اتصالات، على سبيل المثال HubSpot لإنشاء الصفحات وجداول بيانات Google لسجل الأسعار.

أنشأت مفتاحًا جديدًا، لماذا توقف وصول المشاريع؟

يعطل المفتاح الجديد المفتاح القديم فورًا. ألصق المفتاح الجديد في Zapier، ثم أوقف تشغيل الـ Zap وأعد تشغيله مجددًا.

بعض المنتجات لا تحتوي على وحدة حفظ المخزون (SKU)، فما الذي يُرسل؟

تُرسل مرمزّة بأكواد منتجات Home Planner. يوضح لك التطبيق عددها بعد الإرسال.

هل يرى عميلي أي شيء من هذا؟

لا. ينتقل السجل إلى الاتصال الذي أعددته (Zapier أو الرابط الخاص بك). يرى عميلك المشروع فقط عندما تشارك الرابط معه.

هل بيانات نظام إدارة علاقات العملاء (CRM) الخاصة بي آمنة؟

يقوم Home Planner بالإرسال فقط — ولا يقرأ بيانات نظام إدارة علاقات العملاء إطلاقًا. يمكنك استبدال المفتاح أو مفتاح التوقيع في أي وقت عبر مفتاح جديد أو سر جديد.

إشعار العلامة التجارية. تطبيق Home Planner مستقل عن شركة HubSpot, Inc. ولا يتبع لها أو يحظى بدعمها أو رعايتها. كما أن Home Planner مستقل عن العلامات التجارية الأخرى المذكورة في هذه الصفحة ولا يتبع لها أو يحظى بدعمها أو رعايتها.

Home Planner

جرب الخدمة في مشروعك

تطبيق مجاني لأجهزة iPhone وiPad وMac وAndroid وWindows.