> ## 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، وشغّل عملية مزامنة من شاشة النماذج داخل التطبيق.
تعرض صفحة "النماذج" كل نموذج من نماذج "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 (أو تعيين الحقول) وإعادة المحاولة دون مغادرة الصف.
يتم الاحتفاظ بسجل التشغيل عبر إعادات المحاولة، حتى تتمكن من معرفة عدد المحاولات التي استغرقها النموذج وما الذي تغير بينها.
## بيانات نموذجية
إذا لم يكن لديك اتصال بـ HubSpot بعد، فستظهر صفحة النماذج مع **صفوف توضيحية** خلف تعليق "بيانات نموذجية". قم بتوصيل HubSpot للتبديل إلى نماذجك الحقيقية.
HubSpot لا يمكن مزامنة النماذج التي تحتوي على أنواع حقول غير مدعومة (تحميل الملفات، التوقيع) كما هي. قم بتعديل النموذج في HubSpot أو تخطي تلك الحقول في WhatsApp Flow .
##
ذات الصلة
قم بتوصيل البوابة التي يقرأ منها Flowella النماذج.
قم بتشغيل Flows من سير عمل HubSpot .
وصفات شاملة تجمع بين النماذج والقوالب وسير العمل.
تشخيص مشكلات مزامنة النماذج وعمليات الإرسال المفقودة.
تتم مزامنة النماذج حسب القناة — فهم نطاق العمل.
كيفية تشفير عمليات إرسال النماذج أثناء النقل والتخزين.