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

# صفحة النماذج: مزامنة نماذج HubSpot مع WhatsApp Flows

> تصفّح نماذج HubSpot التي تتتبعها Flowella، وتحقّق من حالة مزامنة كل WhatsApp Flow مع Meta، وشغّل عملية مزامنة من شاشة النماذج داخل التطبيق.

<Frame>
  <img src="https://mintcdn.com/flowella/QH2KmtfTITL7teRo/images/Screenshots/flowella-hubspot-forms.png?fit=max&auto=format&n=QH2KmtfTITL7teRo&q=85&s=e2b2c04f6dee3a4d31e81d3ff7bf2fcb" alt="Flowella forms synced from HubSpot" width="2772" height="1686" data-path="images/Screenshots/flowella-hubspot-forms.png" />
</Frame>

تعرض صفحة "النماذج" كل نموذج من نماذج "HubSpot "Flowella التي تتعقبها مؤسستك، و"WhatsApp Flow "Flowella الذي تم إنشاؤه من كل نموذج، وما إذا كان هذا "Flow" متزامنًا مع Meta .

لمعرفة كيفية إعداد تكامل HubSpot في المقام الأول، راجع [إعداد HubSpot ](/ar/hubspot/setup). تغطي هذه الصفحة شاشة **Forms** داخل التطبيق، وليس إعداد التكامل.

## كيفية فتحها

انتقل إلى **النماذج** في شريط التنقل الأيسر، أو:

```text theme={null}
/{org}/forms
```

يمكنك أيضًا فتح النماذج المحددة بنطاق قناة معينة على`/{org}/{waba}/{phone}/forms` . القائمة هي نفسها — يتم استخدام نطاق القناة عند مزامنة تدفق مع Meta .

## ما تعرضه القائمة

يمثل كل صف نموذجًا واحدًا من نماذج HubSpot . تتضمن الأعمدة:

* **اسم النموذج** ومعرف النموذج المختصر HubSpot مع زر نسخ بنقرة واحدة.
* **عدد الحقول** — عدد الحقول الموجودة في النموذج، مع علامة إذا كان أي منها غير مدعوم.
* \*\*آخر تعديل في HubSpot \*\* — مستمد من`updatedAt` الخاص بـ HubSpot حتى تتمكن من معرفة متى تغير تعريف النموذج نفسه.
* **تحديث الكتالوج** — متى قام Flowella بتحديث تعريف النموذج آخر مرة من HubSpot .
* \*\*حالة WhatsApp Flow \*\* — متزامن، مسودة، أو قديم (تغير HubSpot منذ آخر مزامنة).
* \*\*إنشاء WhatsApp Flow / مزامنة WhatsApp Flow \*\* — الإجراء الأساسي. يتحول العنوان إلى **مزامنة** عندما يكون هناك تدفق موجود بالفعل وإلى **قديم — مزامنة مطلوبة** عندما يتم تعديل نموذج HubSpot منذ آخر مزامنة.

يكون الزر **معطلاً مسبقًا** مع تلميح عندما يتعذر تشغيله — على سبيل المثال: HubSpot غير متصل، أو عدم وجود قناة WhatsApp نشطة، أو الفوترة غير نشطة، أو احتواء النموذج على أنواع حقول غير مدعومة. يشرح التلميح بالضبط الشرط المسبق المفقود.

إذا لم يتم مزامنة أي نماذج في حساب HubSpot الخاص بك بعد، فإن Flowella **يقوم بتشغيل الكتالوج تلقائيًا** عند الزيارة الأولى، لذلك لا يتعين عليك تشغيل عملية سحب أولية.

يمكنك تصفية القائمة والبحث فيها للعثور على نموذج معين بسرعة.

## تفاصيل النموذج

انقر فوق صف لفتح صفحة التفاصيل الخاصة به. يعرض عنوان التفاصيل نفس الإجراء الأساسي \*\*إنشاء / مزامنة WhatsApp Flow \*\* الموجود في صف القائمة، لذلك لا يتعين عليك العودة لإجراء تغييرات. من صفحة التفاصيل، يمكنك:

* مراجعة التعيين حقلًا بحقل بين نموذج HubSpot و WhatsApp Flow .
* الاطلاع على **عمليات المزامنة** السابقة — وقت بدء كل عملية، والحالة (في قائمة الانتظار، قيد التشغيل، ناجحة، فاشلة)، وأي أخطاء تم إرجاعها Meta .
* تشغيل مزامنة جديدة، أو **إعادة محاولة** عملية فاشلة، أو **إلغاء** مزامنة لا تزال قيد التقدم.
* فتح التدفق المقابل في مجموعة أعمال Meta .

## مزامنة نموذج مع WhatsApp Flow

عند النقر فوق \*\*إنشاء WhatsApp Flow \*\* أو \*\*مزامنة WhatsApp Flow \*\*، يقوم Flowella بما يلي:

1. تشغيل **فحص مسبق** — للتأكد من اتصال HubSpot ، والتحقق من القناة النشطة، ووجود حقل واحد على الأقل مدعوم في النموذج، ونشاط الفوترة.
2. يقرأ أحدث تعريف للنموذج من HubSpot .
3. ينشئ ملف JSON المكافئ WhatsApp Flow .
4. يحمّله إلى Meta على القناة التي حددتها (على نطاق القناة).
5. يسجل عملية المزامنة في صفحة التفاصيل.

تستغرق معظم عمليات المزامنة بضع ثوانٍ. إذا رفض Meta التدفق، يظهر سبب الفشل في صف التشغيل ك**رسالة خطأ آمنة للمستخدم** (مترجمة من Meta Graph) — عادةً بسبب نوع حقل غير مدعوم، أو مشكلة تحقق على القناة، أو عدم تطابق الفئة. أعد المحاولة من نفس الصف بعد إصلاح السبب.

## التقييد حسب نطاق القناة

النماذج **على مستوى المؤسسة في القائمة** ولكنها **محددة بنطاق القناة عند المزامنة** — يجب تحميل أي تدفق Flow مقابل مزيج محدد من WABA + رقم الهاتف.

| عنوان URL الذي تفتحه          | ما الذي يحدث                                                                                                                                                                                                                                       |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/{org}/forms`                | يسرد كل نموذج يتعقبه Flowella. إذا كانت هناك قناة WhatsApp **واحدة** متصلة بالضبط، يستخدمها Flowella تلقائيًا عند المزامنة. مع وجود أكثر من قناة واحدة، تحتاج إلى فتح النماذج ضمن نطاق قناة قبل المزامنة.                                          |
| `/{org}/{waba}/{phone}/forms` | نفس القائمة، ولكن المزامنة تستهدف هذه القناة مباشرةً. **تنتظر** الصفحة **حل معرف القناة في عنوان URL** قبل تشغيل استعلامات HubSpot الخاصة بها، حتى لا ترى ومضة هيكلية مع نتائج من القناة الخاطئة عندما تكون القناة المخزنة مؤقتًا في الجلسة قديمة. |

إذا نقرت على **مزامنة** من عنوان URL على مستوى المؤسسة ولم يتمكن Flowella من تحديد القناة التي يجب استخدامها (لا توجد قنوات متصلة، أو قنوات متعددة دون تعيين نطاق، أو جلسة قديمة عبر المؤسسات)، يظل الزر معطلاً مسبقًا مع تلميح يشرح ما هو مفقود. قم بالتبديل إلى القناة الصحيحة من [أداة تبديل القنوات](/ar/essentials/multi-channel#switching-channels)، أو افتح `/{org}/{waba}/{phone}/forms` مباشرةً.

## تجربة أخطاء المزامنة

عندما تفشل عملية مزامنة، يحول Flowella صف التشغيل إلى زر إجراء مخطط واحد حتى تتمكن من إصلاحها للأمام من نفس الصف:

| حالة التشغيل                    | الزر              | ما الذي يفعله                                                     |
| ------------------------------- | ----------------- | ----------------------------------------------------------------- |
| فشل                             | **حاول مرة أخرى** | يعيد إدراج نفس مزامنة النموذج في قائمة الانتظار.                  |
| في قائمة الانتظار / قيد التشغيل | **إلغاء**         | يحاول إزالة المهمة ويُعلِّم التشغيل بـ **`FLOW_SYNC_CANCELLED`**. |
| لم تتم مزامنته من قبل           | **إنشاء**         | يُشغّل أول مزامنة لهذا النموذج.                                   |

يحمل الصف أيضًا **شارة خطأ آمنة للمستخدم**:

* **`FLOW_SYNC_PREFLIGHT` + خطأ Meta `#133010`** (الهاتف غير مسجل) — تعرض الشارة رسالة Meta المخزنة وتلميحًا لـ**تسجيل الهاتف**، وليس مجرد "غير جاهز" عام. أكمل تسجيل الهاتف في **الإعدادات → Meta** وأعد المحاولة.
* **`QUEUE_FAILED`** — لم تتمكن قائمة انتظار المزامنة من التقاط المهمة. عادةً ما يكون عابرًا؛ أعد المحاولة. إذا استمر، فإن صفحة حالة المنصة هي المكان التالي للتحقق (انظر [الحالة والحوادث](/ar/essentials/status-and-incidents)).
* **`validation_errors` من Meta** — تلخص الشارة الحقول التي رفضها Meta، حتى تتمكن من تعديل نموذج HubSpot (أو تعيين الحقول) وإعادة المحاولة دون مغادرة الصف.

يتم الاحتفاظ بسجل التشغيل عبر إعادات المحاولة، حتى تتمكن من معرفة عدد المحاولات التي استغرقها النموذج وما الذي تغير بينها.

## ترتبط عمليات إرسال Flow بجهة الاتصال المسجَّلة في HubSpot

عند إرسال WhatsApp Flow من سير عمل HubSpot، تُمرّر Flowella الآن معرِّف جهة الاتصال المسجَّلة في HubSpot عبر الـ Flow، وتُضمّنه بوصفه `hs_object_id` عند إعادة كتابة الإرسال إلى HubSpot. وهذا يجعل الإرسال يرتبط بـ **جهة الاتصال ذاتها التي سجّلتها HubSpot** — لا بسجل مشابه — حتى عندما يتطابق رقم الهاتف مع أكثر من جهة اتصال، ويزيل آخر حالة يمكن أن يعود فيها البحث عن الهاتف في HubSpot إلى السجل الخاطئ.

إذا كانت لدى مؤسستك بالفعل Flows منشورة، فقُم بـ **إعادة مزامنة كل Flow مرة واحدة** حتى يُضمَّن الحقل المخفي الجديد في ملف JSON الخاص بالـ Flow الذي يُرفَع إلى Meta:

<Steps>
  <Step title="افتح صفحة النماذج">
    انتقل إلى **النماذج** وافتح أي نموذج تم إنشاء WhatsApp Flow الخاص به قبل هذا التغيير.
  </Step>

  <Step title="شغّل مزامنة جديدة">
    انقر على **مزامنة WhatsApp Flow** في الصف (أو الإجراء الأساسي في صفحة التفاصيل). تُعيد Flowella رفع ملف JSON الخاص بالـ Flow إلى Meta مع حقل معرِّف جهة الاتصال المخفي.
  </Step>

  <Step title="كرّر ذلك لكل نموذج نشط">
    تحتاج إلى ذلك فقط النماذج المُرسَلة من مهام سير عمل HubSpot. أما النماذج المُرسَلة خارج سياق سير عمل فلا تتأثر.
  </Step>
</Steps>

تتضمّن الـ Flows المُنشأة أو المتزامنة بعد الإصلاح الحقل بالفعل، لذا لا حاجة لأي إجراء بالنسبة إلى Flows الجديدة.

## نص الأسئلة في كتل النص المنسّق

يتيح لك HubSpot وضع **عنصر نص منسّق** فوق مجموعة الحقول بحيث يظهر نص السؤال أعلى الإدخال بدلاً من وضعه داخل تسمية الحقل. تقوم Flowella بتعيين هذه الكتل داخل WhatsApp Flow جنبًا إلى جنب مع الإدخالات:

| النص المنسّق في HubSpot          | مكوّن Flow                             |
| -------------------------------- | -------------------------------------- |
| عنوان `H1`                       | عنوان نصي (Text heading)               |
| عنوان `H2` أو `H3`               | عنوان فرعي نصي (Text subheading)       |
| فقرة أو قائمة أو أي نص أساسي آخر | نص أساسي (Text body — مع دعم markdown) |

يظهر النص المنسّق **قبل** الإدخالات ضمن مجموعة الحقول، بحيث يرى العملاء السؤال أولًا ثم يجيبون عليه. ما زالت تسميات الحقول تظهر داخل التطبيق، لذا اجعلها قصيرة — راجع [أفضل الممارسات لتصميم النماذج](/app/form-design-best-practices).

<Note>
  إذا كانت لديك بالفعل نماذج HubSpot تستخدم النص المنسّق فوق مجموعات الحقول، فقم **بإعادة مزامنتها** من [صفحة تفاصيل النموذج](#تفاصيل-النموذج). كانت عمليات المزامنة الأقدم تلتقط تسميات الحقول فقط، لذلك كان نص السؤال المنسّق مفقودًا من Flow المنشور حتى تُعيد المزامنة.
</Note>

<Warning>
  يمكن لشاشة WhatsApp Flow واحدة أن تحتوي على **50 مكوّنًا** كحدٍّ أقصى. في النماذج الكبيرة جدًا، تحتفظ Flowella بجميع الإدخالات وتُسقط كتل النص المنسّق من نهاية الشاشة للبقاء تحت هذا الحد — لا تتم إزالة الإدخالات أبدًا، لكن قد لا يظهر بعض نص الأسئلة. قسّم النموذج على عدة شاشات (أو إلى نموذجين) إذا كنت بحاجة إلى ظهور كل جزء من النص.
</Warning>

## بيانات نموذجية

إذا لم يكن لديك اتصال بـ HubSpot بعد، فستظهر صفحة النماذج مع **صفوف توضيحية** خلف تعليق "بيانات نموذجية". قم بتوصيل HubSpot للتبديل إلى نماذجك الحقيقية.

<Tip>
  HubSpot لا يمكن مزامنة النماذج التي تحتوي على أنواع حقول غير مدعومة (تحميل الملفات، التوقيع) كما هي. قم بتعديل النموذج في HubSpot أو تخطي تلك الحقول في WhatsApp Flow .
</Tip>

##

<CardGroup cols={2}>
  ذات الصلة

  <Card title="إعداد HubSpot" icon="plug" href="/ar/hubspot/setup">
    قم بتوصيل البوابة التي يقرأ منها Flowella النماذج.
  </Card>

  <Card title="إجراءات سير العمل" icon="git-branch" href="/ar/hubspot/workflow-actions">
    قم بتشغيل Flows من سير عمل HubSpot .
  </Card>

  <Card title="أدلة سير العمل" icon="book-open" href="/ar/hubspot/workflows/meeting-booking">
    وصفات شاملة تجمع بين النماذج والقوالب وسير العمل.
  </Card>

  <Card title="حالات فشل المزامنة في HubSpot" icon="bug" href="/ar/troubleshooting/hubspot-sync-failures">
    تشخيص مشكلات مزامنة النماذج وعمليات الإرسال المفقودة.
  </Card>

  <Card title="متعدد القنوات" icon="layers" href="/ar/essentials/multi-channel">
    تتم مزامنة النماذج حسب القناة — فهم نطاق العمل.
  </Card>

  <Card title="أمن البيانات" icon="lock-keyhole" href="/ar/security/data-security">
    كيفية تشفير عمليات إرسال النماذج أثناء النقل والتخزين.
  </Card>
</CardGroup>