ربط HubSpot لمزامنة الأعضاء والطلبات

يبقي موصل HubSpot نظام إدارة العملاء لديك محدّثًا دون تصدير يدوي. كل عضو جديد في مدونتك يصبح جهة اتصال (Contact) في HubSpot، وكل طلب مكتمل أو مُسترجَع أو مُنفَّذ يصبح صفقة (Deal) — تلقائيًا، لحظة حدوثه.

تثبيت الإضافة وقائمة الفحص عند صمت الموصل أمران مشتركان في كل التكاملات، وهما مشروحان مرة واحدة في الدليل المشترك للتكاملات. تغطي هذه المقالة ما يخص HubSpot وحده.

الخطوة 1 — اربط حساب HubSpot

افتح «لوحة التحكم ← الإضافات ← HubSpot» واضغط Connect HubSpot. سيتم توجيهك إلى HubSpot لتسجيل الدخول والموافقة على منح VeloCMS الصلاحية — لا حاجة لنسخ أي مفتاح API، فالعملية بأكملها تعتمد على OAuth. بمجرد الموافقة، يعاد توجيهك وتظهر اللوحة بحالة Connected.

يطلب VeloCMS من HubSpot صلاحية القراءة والكتابة على جهات اتصال CRM وعلى صفقاته (crm.objects.contacts.read و.write، وcrm.objects.deals.read و.write)، إضافةً إلى صلاحية oauth الأساسية. ولا يطلب الوصول إلى الشركات أو التذاكر أو البريد التسويقي أو أي شيء آخر في حسابك.

إذا كان زر Connect غير موجود وظهر بدلاً منه إشعار إعداد، فهذا يعني أن الموصل لم يُفعَّل بعد على نسخة VeloCMS الخاصة بك. هذه خطوة إعداد على مستوى المنصة وليست شيئًا يستطيع مدير المستأجر إصلاحه من هذه اللوحة — تواصل مع الدعم إذا كنت بحاجة إلى تفعيلها.

الخطوة 2 — اختر مسار الصفقات ومراحلها (اختياري)

بعد أن تعرض اللوحة حالة Connected يظهر قسم «مسار الصفقات ومراحلها» أسفل زر الاتصال. اختر المسار والمرحلة التي تبدأ بها الصفقات الجديدة، ثم اختر اختياريًا مرحلة للطلبات المُسترجَعة وأخرى للطلبات المُنفَّذة، واضغط «حفظ إعدادات الصفقات». تأتي القوائم مباشرة من حسابك في HubSpot. وإذا تعذّر تحميلها تتحول الحقول إلى مربعات نصية تلصق فيها المعرّفات بنفسك؛ وتجدها في HubSpot عبر الإعدادات ← الكائنات ← الصفقات ← المسارات. اترك كل شيء فارغًا ليضع HubSpot الصفقات الجديدة في المسار والمرحلة الافتراضيين لحسابك. وإذا لم تختر مرحلة للاسترجاع أو التنفيذ فلن تُنقل تلك الصفقات.

ما الذي يُزامَن، ومتى

تسجيل عضو جديد ينشئ أو يحدّث جهة اتصال في HubSpot، مطابِقًا بحسب البريد الإلكتروني. ويُقسَم اسم العضو عند أول مسافة إلى اسم أول واسم أخير.
الطلب المكتمل ينشئ صفقة ويربطها بجهة اتصال المشتري (وتُنشأ جهة الاتصال إن لم تكن موجودة).
الطلب المُسترجَع يحدّث مرحلة تلك الصفقة.
الطلب المُنفَّذ يحدّث مرحلة الصفقة مرة أخرى.
حذف حساب عضو يحذف جهة اتصال ذلك العضو في HubSpot (التفاصيل أدناه).
إلغاء الاشتراك في نشرتك البريدية يُبقي جهة الاتصال ويوقف فقط رسائل HubSpot التسويقية إليها.

كيف تُسمّى الصفقة، ولماذا يهمّ ذلك

تُسمّى كل صفقة «Order #» متبوعًا برقم الطلب في VeloCMS، ويكون مبلغها إجمالي الطلب. وعند الاسترجاع أو التنفيذ يعثر VeloCMS على الصفقة من جديد بالبحث في HubSpot عن هذا الاسم بالضبط. فإذا غيّرت اسم صفقة داخل HubSpot لم يجدها تحديث المرحلة اللاحق، ولن يتحرك شيء، ويُسجَّل الطلب مزامنةً فاشلة في «التكاملات ← نشاط المزامنة».

مثال: إذا اشترى عضو دورة بقيمة 49 دولارًا، يتلقى HubSpot صفقة اسمها «Order #» مع رقم الطلب بقيمة 49، مرتبطة بجهة اتصال ذلك العضو ومضافة إلى المرحلة التي اخترتها للصفقات الجديدة. وإذا استرجعت الطلب لاحقًا وكنت قد اخترت مرحلة للاسترجاع، تنتقل الصفقة نفسها إليها؛ وإن لم تختر مرحلة بقيت حيث هي.

المزامنة باتجاه واحد فقط: يدفع VeloCMS البيانات إلى HubSpot. تعديل جهة اتصال أو صفقة داخل HubSpot لا يكتب أي شيء عائدًا إلى VeloCMS — فـ HubSpot ليس نظام السجل الأساسي لأعضائك أو طلباتك، بل VeloCMS هو كذلك.

قطع الاتصال

اضغط Disconnect في نفس اللوحة. يحذف VeloCMS رموزه المخزّنة ويُزيل تطبيق VeloCMS من حسابك في HubSpot، فيختفي أيضًا من قائمة التطبيقات المتصلة هناك. لن يتم إنشاء أي جهات اتصال أو صفقات جديدة بعد قطع الاتصال، وتُترك السجلات الموجودة في HubSpot كما هي.

ما الذي يحذفه VeloCMS في HubSpot

يحذف VeloCMS شيئًا واحدًا فقط في حساب HubSpot الخاص بك: عندما يُحذف حساب عضو في VeloCMS (بما في ذلك حين يطلب العضو ذلك) ويكون HubSpot متصلًا، يبحث VeloCMS عن جهة اتصال هذا العضو بحسب بريده الإلكتروني ويحذفها، ليُنفَّذ طلب المحو في نظام إدارة العملاء لديك أيضًا. يؤرشف HubSpot جهة الاتصال المحذوفة ويمكنه استعادتها خلال 90 يومًا، ولا يحذف VeloCMS أي صفقات. لا يُحذف أي شيء آخر: إلغاء الاشتراك في نشرتك البريدية يُبقي جهة الاتصال ويوقف فقط رسائل HubSpot التسويقية إليها، وقطع الاتصال لا يزيل أي سجل. وإذا لم يكن HubSpot متصلًا عند حذف العضو، فلا يُرسَل شيء إلى HubSpot.