> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> مزامنة العملاء المحتملين وجهات الاتصال مع HubSpot.

يربط تكامل HubSpot حساب Scanova الخاص بك بمنصة HubSpot عبر OAuth، ثم يرشدك عبر معالج موجَّه يُطابق مرسلات نموذج أو رمز QR بكائن CRM في HubSpot — Contact أو Company أو Deal أو Ticket — بحيث تصبح كل عملية إرسال سجلًا في HubSpot تلقائيًا.

## المتطلبات الأساسية

* حساب HubSpot بصلاحية تفويض اتصالات تطبيقات جديدة للمنصة.
* خطة Scanova تتضمن تكامل HubSpot. بدونها، يُرجع الاتصال خطأ "Your plan does not include HubSpot integration".
* نموذج واحد على الأقل من Form-builder أو رمز QR بمصدر إرسال (Custom Form أو Feedback أو RSVP أو استفسار Real Estate أو ملاحظات Restaurant) مُعدّ بالفعل، إذ يحتاج المعالج إلى شيء يزامن منه.

## إعداد الاتصال

يفتح HubSpot كصفحة كاملة خاصة به (وليس لوحة جانبية)، لأن المعالج يحتاج إلى المساحة.

<Steps>
  <Step title="فتح تكامل HubSpot">
    من **Integrations**، اختر **Add Integration**، ثم ابحث عن بطاقة **HubSpot** واختر **Setup**.
  </Step>

  <Step title="ربط HubSpot">
    اختر **Connect HubSpot**. تُعاد توجيهك إلى HubSpot لتفويض Scanova، ثم تُعاد إلى المعالج. تعرض شارة خضراء معرّف المنصة المتصلة بمجرد نجاح التفويض.
  </Step>

  <Step title="اختيار ما ستتم مزامنته">
    اختر نوع مصدر الإرسال: **Forms** (أي نموذج من Form-builder)، أو **Custom Form Component**، أو **Feedback Form (Feedback QR Code)**، أو **RSVP Form Component**، أو **Inquiry Form (Real Estate QR Code)**، أو **Feedback Form (Restaurant QR Code)**.
  </Step>

  <Step title="اختيار المصدر">
    حسب النوع المختار، ابحث عن النموذج أو رمز QR المحدد الذي ينبغي مزامنة مرسلاته واخترْه.
  </Step>

  <Step title="اختيار إجراء HubSpot">
    اختر كائن HubSpot الذي ينبغي أن تنشئه كل عملية إرسال: **Create Contact**، أو **Create Company**، أو **Create Deal**، أو **Create Ticket**.
  </Step>

  <Step title="ربط الحقول">
    طابق حقول مصدرك بخصائص HubSpot. الخصائص المميزة في HubSpot للكائن المختار مُدرجة مسبقًا؛ استخدم **Add a field** لربط خصائص إضافية من الكتالوج الكامل. تُحظَر عمليات الربط غير المتوافقة مضمّنة — فمثلًا، لا يمكن ربط خاصية رقمية في HubSpot بحقل نصي، ولا خاصية تاريخ بحقل غير تاريخ.

    <Note>
      عملية ربط لا يُعلّمها المعالج كغير صالحة، لكن لا يمكن مع ذلك تحويلها إلى نوع خاصية HubSpot، تُسقَط بصمت عند وقت المزامنة بدلًا من أن تتسبب في خطأ — التحقق المضمّن موجود تحديدًا لالتقاط هذا قبل حدوثه.
    </Note>
  </Step>

  <Step title="المراجعة والاختبار والإكمال">
    سمِّ الاتصال (يُستخدم لاحقًا لتحديده ضمن Active Connections)، راجع ملخص الربط، واختر اختياريًا **Send test** لإرسال سجل عينة واحد إلى HubSpot وتأكيد وصوله قبل اختيار **Complete setup**.
  </Step>
</Steps>

## إدارة الاتصال

* **Disconnect** (في الشارة المتصلة) يوقف المزامنة للمنصة بأكملها — يتوقف كل اتصال HubSpot المرتبط بها عن إرسال البيانات.
* تعديل اتصال موجود من **Active Connections** يعيد فتح المعالج المكوّن من 5 خطوات نفسه، مُعبّأً مسبقًا.

## أين تذهب البيانات

في كل مرة يتلقى فيها النموذج أو رمز QR المُهيَّأ إرسالًا جديدًا، تُرسل Scanova قيم الحقول المُطابَقة إلى HubSpot كسجل جديد من نوع الكائن المختار (Contact أو Company أو Deal أو Ticket) في المنصة المتصلة.

## ذات صلة

* [Slack](/ar/integrations/slack) — تكامل آخر متصل عبر OAuth بمنشئ قواعد مُسمّاة خاص به.
* [Webhooks](/ar/integrations/webhooks) — بديل عام إذا احتجت إلى بيانات الإرسال في مكان لا يغطيه HubSpot.
* [Form management](/ar/api-reference/management-api/forms/list) — الـ API خلف مصادر Forms التي يزامن منها هذا المعالج.
* [Lead list management](/ar/api-reference/management-api/leads/list) — الـ API خلف مصادر مزامنة Lead List القديمة.